API de Búsqueda general de Bilibili
Salud de la API
- Salud 24 h
- Normal
- Saludable / normal
- Disponible
Últimas 24 horas
Últimos 30 días
Busca en Bilibili como la pestaña «Todo»: videos, cuentas, anime, películas y salas en directo en una sola lista, cada fila con su type. La primera página trae unos 20 videos más cuentas, anime y películas relacionados; las siguientes, solo videos. El next_page_token de la respuesta se envía tal cual como page_token para pedir la página siguiente.
Envía POST https://api.everyinfra.com/api/v1/social con platform igual a bilibili y action igual a general_search. Precio $0.79 por 1.000 solicitudes ($0.000792 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Síncrona. Para tareas lentas añade "mode": "async" al cuerpo, recibe un job_id y consúltalo.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Bilibili: Búsqueda general (bilibili/general_search).
Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en bilibili y action en general_search, y los parámetros dentro de params.
- Parámetros obligatorios:
- keyword: Término de búsqueda. Los resultados se mezclan como en la pestaña «Todo»; el type de cada fila es video, user, bangumi, movie o live. Para solo videos usa search; para solo cuentas, user_search.
- Parámetros opcionales:
- page_token: Token de paginación. Omítelo en la primera página y luego devuelve tal cual el next_page_token anterior, sin cambiar los demás parámetros.
- Devuelve una lista de registros. Campos principales de cada registro: type, id, url, title, text, duration_seconds, duration_sec, duration_text (Duración como texto mostrado (por ejemp…), view_count, like_count, comment_count, danmaku_count (Número de danmaku (comentarios en panta…); 39 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=bilibili.
- Cuerpo de solicitud de ejemplo:
{
"platform": "bilibili",
"action": "general_search",
"params": {
"keyword": "编程"
}
}
- Precio: $0.79 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.
Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.Parámetros de la solicitud
#| Nombre | Ubicación | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|---|
Authorization | header | string | Sí | - | Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código. |
platform | body | string | Sí | bilibili | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | general_search | Identificador de la capacidad, valor fijo. |
keyword | body.params | string | Sí | - | Término de búsqueda. Los resultados se mezclan como en la pestaña «Todo»; el type de cada fila es video, user, bangumi, movie o live. Para solo videos usa search; para solo cuentas, user_search. |
page_token | body.params | string | No | - | Token de paginación. Omítelo en la primera página y luego devuelve tal cual el next_page_token anterior, sin cambiar los demás parámetros. La primera página trae unos 20 videos más cuentas, anime y películas relacionados; las siguientes, solo videos, hasta 20. Cada página es una llamada; limit no tiene efecto. Dura 24 horas; la última página no trae next_page_token. |
Ejemplos de código
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "bilibili",
"action": "general_search",
"params": {
"keyword": "编程"
}
}'Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.
Ejemplo de respuesta
#{ "id": "req_…", "platform": "bilibili", "action": "general_search", "results": [ { "type": "video", "id": "BV1rpWjevEip", "url": "https://www.bilibili.com/video/BV1rpWjevEip", "title": "【全748集】目前B站最全最细的Python零基础全套教程,2026最新版,包含所有干货!七天就能从小白到大神!少走99%的弯路!存下吧!很难找全的!", "text": "【视频配套籽料、开发环境搭建安装包教程、电子书+问题解答请看 ”置顶平论” 自取哦】\r\n本套教程从零开始讲解,手把手教学,包含基础语法、进阶语法、爬虫、自动化办公、数据分析\r\n无论是新手小白,还是有一定编码经验的选手,皆可学习\r\n如果视频对你有用的话请 一键三连【长按点赞】支持一下UP哦,拜托,这对我真的很重要!", "duration_seconds": 143894, "duration_text": "39:58:14", "view_count": 21931770, "like_count": 605744, "comment_count": 373418, "danmaku_count": 137244, "favorite_count": 927710, "thumbnail_url": "https://i2.hdslb.com/bfs/archive/a979056b1a32012cdd00d48fbc3732d253e30620.jpg", "posted_at": "2024-08-22T14:59:18+00:00", "category": "计算机技术", "author_name": "P•••程", "author_id": "•••", "author_url": "https://space.bilibili.com/•••", "platform": "bilibili", "tags": [ "程序员", "Python教程", "Python入门零基础" ], "duration_sec": 143894 }, { "type": "video", "id": "BV12J411X7tY", "url": "https://www.bilibili.com/video/BV12J411X7tY", "title": "少儿编程scratch3.0基础入门(大龙老师)", "text": "这个教程是简单的基础入门课,想要系统的,完整的学习scratch请选择《新版scratch从入门到精通系统课》,点击评论区置顶链接进入课程,了解详情。", "duration_seconds": 11349, "duration_text": "3:09:09", "view_count": 1373367, "like_count": 15518, "comment_count": 2142, "danmaku_count": 9959, "favorite_count": 46757, "thumbnail_url": "https://i2.hdslb.com/bfs/archive/45a0b5a218de8fff3b7f4cf02e130179b1be470c.jpg", "posted_at": "2019-11-27T10:20:37+00:00", "category": "校园学习", "author_name": "大•••程", "author_id": "•••", "author_url": "https://space.bilibili.com/•••", "platform": "bilibili", "tags": [ "scratch", "少儿编程", "原创" ], "duration_sec": 11349 } ], "next_page_token": …, "pagination": { … }, "count": 17, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campos de la respuesta
#Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.
| Campo | Significado |
|---|---|
type | Tipo de registro; los valores dependen de la capacidad (por ejemplo video / image / text). |
id | Identificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas. |
url | Enlace al registro en la plataforma. |
title | Título. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto). |
text | Texto del contenido sin HTML, completo y sin recortes (en algunas plataformas los resultados de listado solo traen un extracto; lo indican las notas de campos de la plataforma). |
duration_seconds | Duración en segundos. null en contenido que no es video ni audio. |
duration_sec | Conserva el significado de la plataforma |
duration_text | Duración como texto mostrado (por ejemplo 12:34). |
view_count | Visualizaciones o reproducciones. null significa no publicado, no 0. |
like_count | Me gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0. |
comment_count | Comentarios. null significa no publicado, no 0. |
danmaku_count | Número de danmaku (comentarios en pantalla). Una señal de interacción propia de Bilibili; léela junto con comment_count. |
favorite_count | Favoritos. |
coin_count | Monedas recibidas. En Bilibili las monedas son una forma de aprobación de pago y pesan más que los «me gusta». |
share_count | Veces compartido. null significa no publicado, no 0. |
thumbnail_url | Enlace a la miniatura, con menos resolución que image_url. |
posted_at | Fecha de publicación en ISO 8601, UTC (por ejemplo 2026-08-07T12:34:56+00:00). Las cadenas no estándar de la plataforma se transmiten tal cual, así que conviene analizarlas con tolerancia. null significa que la plataforma no la publica. |
category | Nombre de la categoría según la taxonomía propia de la plataforma, sin normalizar entre plataformas. |
author_name | Nombre visible del autor. |
author_id | Identificador único del autor en la plataforma. |
author_url | Enlace al perfil del autor en la plataforma. |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
tags | Lista de etiquetas. Si no hay, es una lista vacía, no null. |
user_id | Identificador único del usuario en la plataforma. |
name | Nombre del propio objeto, en capacidades de cuentas, productos y negocios. |
bio | Biografía escrita por la cuenta; puede incluir saltos de línea y emoji. |
avatar_url | Enlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar. |
level | Conserva el significado de la plataforma |
follower_count | Seguidores. null significa no publicado, no 0. |
video_count | Conserva el significado de la plataforma |
is_verified | Si la plataforma verificó la cuenta. null significa que no se puede determinar. |
verified_type | Conserva el significado de la plataforma |
verified_title | Conserva el significado de la plataforma |
is_live | Conserva el significado de la plataforma |
live_room_id | Conserva el significado de la plataforma |
is_senior_member | Conserva el significado de la plataforma |
recent_video_ids | Conserva el significado de la plataforma |
episode_count | Conserva el significado de la plataforma |
rating | Valoración. La escala depende de la plataforma: rating_scale en la misma fila indica el máximo (normalmente 5; Booking, Douban, iQIYI y NAVER usan 10). Convierte con rating_scale antes de comparar entre plataformas o la comparación puede salir al revés. |
rating_scale | Máximo de rating en la misma fila: 5 en escalas de cinco estrellas y 10 en escalas de diez puntos. Solo aparece si la fila tiene rating. |
Errores y facturación
#- 401
- Falta la clave o no es válida.
- 402
- Saldo insuficiente. Recarga primero.
- 422
- Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
- 429
- Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
- 503
- No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
- 200 vacío
- Sin datos. Sin cargo.