API de Búsqueda de Weibo
Salud de la API
- Salud 24 h
- 83 %
- Tiempo medio 24 h
- 9.76 s
- 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.
Envía POST https://api.everyinfra.com/api/v1/social con platform igual a weibo y action igual a search. Precio $0.81 por 1.000 solicitudes ($0.000806 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.
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.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Weibo: Búsqueda (weibo/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 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.81 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 | string | 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
#{ "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.
- 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.