API de Búsqueda de Weibo
Salud de la API
- Salud 24 h
- Normal
- Tiempo medio 24 h
- —
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Últimas 24 horas
Últimos 30 días
Busca publicaciones de Weibo mediante keyword, devolviendo autor, dispositivo e interacciones visibles. No garantiza todo el periodo ni clasifica automáticamente publicaciones originales y reposts sin is_repost.
Weibo Búsqueda encuentra publicaciones públicas a partir de keyword y devuelve, de cada una, el texto, la fecha, el dispositivo de publicación, los reenvíos, comentarios y me gusta, y si es un reenvío; del autor, el apodo, la biografía, los seguidores, si está verificado y la descripción de la verificación, además de los enlaces a imágenes y video. Responde a quién habla de un tema en Weibo, qué dice y hasta dónde llega: sirve para seguir la opinión pública, contar menciones de una marca y localizar líderes de opinión.
Para saber qué representa una cuenta verificada, lee author_verified_reason, y mide su alcance con author_follower_count. Si cuentas menciones originales, descarta los reenvíos con is_repost. La lista de temas en tendencia no necesita palabra clave: se lee con Weibo Tendencias, que devuelve entradas del ranking y no publicaciones.
Precio $0.56 por 1.000 solicitudes ($0.000556 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
Pégalo en tu asistente de IA. Ya incluye los parámetros, los campos de respuesta y una solicitud de ejemplo de este endpoint, así que el asistente puede preguntarte qué necesitas y luego escribir el script.
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Weibo: Búsqueda (weibo/search).
Contrato del 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 weibo y action en search, y los parámetros dentro de params.
- Parámetros obligatorios:
- keyword: Término de búsqueda para publicaciones públicas en la acción search. La acción trending no requiere palabra clave y devuelve los temas del momento, no una lista de publicaciones de usuarios.
- Parámetros opcionales:
- limit: Número máximo de filas que devuelve esta llamada, un entero de 1 a 50. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. (por defecto: 20)
- Devuelve una lista de registros. Campos principales de cada registro: id, url, text, posted_at, device (Cliente desde el que se publicó (como u…), repost_count, comment_count, like_count, is_repost (Indica si la publicación es un reenvío), author_id, author_name, author_bio (Biografía del autor); 19 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=weibo.
- Cuerpo de solicitud de ejemplo:
{
"platform": "weibo",
"action": "search",
"params": {
"keyword": "城市骑行"
}
}
- Precio: $0.56 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í | weibo | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | search | Identificador de la capacidad, valor fijo. |
keyword | body.params | No declarado | Sí | - | Término de búsqueda para publicaciones públicas en la acción search. La acción trending no requiere palabra clave y devuelve los temas del momento, no una lista de publicaciones de usuarios. |
limit | body.params | integer (1–50) | No | 20 | Número máximo de filas que devuelve esta llamada, un entero de 1 a 50. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. Los valores mayores devuelven 422 antes de cualquier cobro. |
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": "weibo",
"action": "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
Obtenida el 26 de septiembre de 2026, 08:56 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto); la lista conserva los primeros 2. id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
{
"id": "req_…",
"platform": "weibo",
"action": "search",
"results": [
{
"id": "(已隐去)",
"url": "https://weibo.com/2590508284/5347470118748545",
"text": "【层林逐风 赛道如画|2026环北京·门头沟国际公路自行车赛第二日激战正酣】9月26日,为期三天的2026环北京·门头沟国际公路自行车赛进入第二个比赛日。本届赛事为国际自行车联盟(UCI)认证的2.2级亚洲巡回赛事,共吸引来自11个国家和地区的21支队伍的百余名职业车手及约3000名自行车爱好者参与,职业组总赛程超过340公里。赛事历时三日,设斋堂耐力、京西山地、城市绕圈三大特色赛段;当日举行的第二赛段——京西山地赛段,是爬坡难度最高、参与人群覆盖面最广的赛段,设职业组、大众骑游39公里组与大众骑游9公里组三个组别。本届赛事是2026京西国际山地户外季…",
"posted_at": "Sat Sep 26 18:48:09 +0800 2026",
"device": "HUAWEI Mate 60 Pro",
"repost_count": 0,
"comment_count": 0,
"like_count": 1,
"is_repost": false,
"author_id": "(已隐去)",
"author_name": "(已隐去)",
"author_verified": true,
"author_avatar_url": "https://tvax3.sinaimg.cn/(已隐去)",
"image_urls": [
"https://wx2.sinaimg.cn/orj1080/9a6804fcly1ihh9kjk3d5j20zk0npk68.jpg",
"https://wx2.sinaimg.cn/orj1080/9a6804fcly1ihh9kjj04hj20nl0fq7b6.jpg",
"https://wx3.sinaimg.cn/orj1080/9a6804fcly1ihh9kjp5dwj20tw13wqis.jpg"
],
"platform": "weibo"
},
{
"id": "(已隐去)",
"url": "https://weibo.com/3075210951/5347460012838223",
"text": "#九九骑行节# #九号城市主理人#",
"posted_at": "Sat Sep 26 18:08:01 +0800 2026",
"device": "iPhone客户端",
"repost_count": 0,
"comment_count": 0,
"like_count": 0,
"is_repost": true,
"author_id": "(已隐去)",
"author_name": "(已隐去)",
"author_verified": false,
"author_avatar_url": "https://tvax1.sinaimg.cn/(已隐去)",
"video_url": "http://f.video.weibocdn.com/o0/gFJZA5WElx08AYxj2Opi01041201pS5N0E010.mp4?label=mp4_720p&template=1280x720.25.0&ori=0&ps=1CwnkDw1GXwCQx&Expires=1790423648&ssig=S036CI1rO4&KID=unistore,video",
"platform": "weibo"
}
],
"count": 20,
"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 |
|---|---|
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. |
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). |
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. |
device | Cliente desde el que se publicó (como un cliente de iPhone). |
repost_count | Republicaciones (distintas de las citas). null significa no publicado. |
comment_count | Comentarios. null significa no publicado, no 0. |
like_count | Me gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0. |
is_repost | Indica si la publicación es un reenvío. |
author_id | Identificador único del autor en la plataforma. |
author_name | Nombre visible del autor. |
author_bio | Biografía del autor. |
author_follower_count | Seguidores del autor. null significa no publicado. |
author_following_count | Número de cuentas que sigue el autor. |
author_verified | Indica si el autor tiene la verificación de Weibo (la insignia V). |
author_verified_reason | Descripción de la verificación (como un cargo en una empresa); sirve para saber qué representa una cuenta verificada. |
author_avatar_url | URL del avatar del autor. |
image_urls | Lista de enlaces de imagen en el orden en que los muestra la plataforma; no aparece si no hay imágenes. |
video_url | Enlace al video de la publicación. |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
Preguntas frecuentes
¿Cómo cuento solo las publicaciones originales?
Filtra por is_repost: true indica que la fila es un reenvío, así que descártala al contar menciones originales. repost_count, en cambio, es cuántas veces se reenvió una publicación y te sirve para medir hasta dónde se difundió.
¿Cómo sé si quien publica es una cuenta grande?
Mira author_verified y luego lee author_verified_reason, que explica qué cubre la verificación, por ejemplo un cargo en una empresa. Combínalo con author_follower_count para estimar cuánto alcance pueden tener las publicaciones de esa cuenta.
¿Puedo obtener la lista de temas en tendencia?
No con esta capacidad: la búsqueda devuelve publicaciones que contienen tu palabra clave. La lista de tendencias no necesita palabra clave y se lee con Weibo Tendencias, que devuelve las entradas del ranking en lugar de publicaciones.
Errores y facturación
- 401
- Falta la clave o no es válida. La autenticación se comprueba antes que los parámetros, así que las solicitudes sin autenticar no ven el esquema de parámetros.
- 422
- Nombre o valor de parámetro incorrecto. El error enumera los parámetros y valores permitidos de esta capacidad y la opción más cercana; ocurre antes de cualquier cobro.
- 402
- Saldo insuficiente. Recarga primero.
- 429
- Se alcanzó el límite de solicitudes por minuto de la cuenta (todas sus claves API cuentan juntas; antes se aplica el límite propio de una clave si es menor). Espera lo que indique Retry-After y vuelve a intentarlo; un paquete de velocidad en la consola sube el límite.
- 503
- No se pudo completar ahora. Cualquier cargo de la llamada vuelve automáticamente a tu saldo, y el recibo de facturación de la respuesta indica el resultado real, también cuando aún no se conoce. No reenvíes a ciegas.
- 200 vacío
- La solicitud terminó sin datos y no se cobra (billing.reason = empty_result_refunded).