API de Búsqueda de artículos de Cuentas oficiales de WeChat
Busca artículos de cuentas oficiales por keyword, elige la sección con category y obtén title, summary, url y cover_image_url de cada fila. La tabla de campos incluye además account_name y posted_at. Cuesta $8 por cada 1000 llamadas.
Cuentas oficiales de WeChat Búsqueda de artículos encuentra artículos publicados por cuentas oficiales a partir de keyword y devuelve, para cada uno, el título, el resumen, el enlace, la imagen de portada, el nombre de la cuenta y la fecha de publicación. Responde a qué se publica sobre un tema en las cuentas oficiales y quién lo escribe: sirve para seguir las noticias de un sector, recoger opinión pública, encontrar cuentas con las que colaborar o armar un banco de temas.
Con category eliges la sección: ALL, LATEST o HOT. FOLLOWED y RECENT_READ dependen de una sesión personal de WeChat que aquí no se usa, así que no se garantizan resultados y nunca se leen tus suscripciones ni tu historial de lectura. Para ordenar por fecha usa posted_at; relative_time es la expresión relativa que muestra WeChat y solo sirve para mostrarla. Abre la url para leer el artículo completo.
- Elige la sección de todos, más recientes o más populares con
category. - Busca artículos de cuentas oficiales, no chats personales de WeChat.
- Las llamadas fallidas y los resultados vacíos no se cobran.
Puede no estar disponible temporalmente en horas punta
Esta capacidad puede no estar disponible temporalmente en horas punta; vuelve a intentarlo más tarde. Las llamadas fallidas no se cobran.
Salud de la API
- Salud 24 h
- 96 %
- Tiempo medio 24 h
- 11.51 s
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Últimas 24 horas
Últimos 30 días
1Solicitud
POST /api/v1/social { "platform": "wechat_oa", "action": "article_search", "params": { "keyword": "城市更新" } }2Respuesta JSON
{ "results": [ { "title": "城市更新的八大类型及典型案例分析(含城市更新专题)", "summary": "城市更新涉及范围广、主体多、建设任务纷繁复杂.中共中央办公厅、国务院办公厅《关于持续推进城市更新行动的意见》,将城市更...", "cover_image_url": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/C4sz9kVVx1mva20LCAFC8cTARSIAFo3sBiaEuRhDD1d5n5YCHbZiajFd7eRR5DNE00zpn4f1fWB7IVsrO3WRbM9V7IEHweQautrnpxprcnIvE/0?wx_fmt=jpeg" }, … ], "count": 18 }3Filas
title summary cover_image_url 城市更新的八大类型及典型案例分析(含城市更新专题) 城市更新涉及范围广、主体多、建设任务纷繁复杂.中共中央办公厅、国务院办公厅《关于持续推进城市更新行动的意见》,将城市更... https://mmbiz.qpic.cn/sz_mmbiz_jpg/C4sz9kVVx1mva20LCAFC8cTARSIAFo3sBiaEuRhDD1d5n5YCHbZiajFd7eRR5DNE00zpn4f1fWB7IVsrO3WRbM9V7IEHweQautrnpxprcnIvE/0?wx_fmt=jpeg 李迎伟主持研究城市更新工作 李迎伟主持研究城市更新工作提标提速推动城市更新试点任务努力打造具有江汉平原特色的现代化人民城市10月24日,市委书记李迎伟... https://mmbiz.qpic.cn/sz_mmbiz_jpg/6UUD1kjmksibLZqt2kgvS0BGYyGIeqzTBOnCiceTicp8BL2OM0SUCwIWcs0fWnPB30CpBeCngicRejeK6T3o0tb8pjOKrO3xkYKl1dMKOcNTUs8/0?wx_fmt=jpeg 4CSV
wechat_oa-article_search-sample.csv id,title,summary,url,cover_image_url,account_name,posted_at,relative_time,kind,platform
keyword y sale un lote de pistas de artículos; cada fila de results es un artículo, y se muestra como tabla de campos y se puede descargar en CSV.Qué datos obtienes
La tabla muestra una llamada real para 城市更新, obtenida el 24 de octubre de 2026, 18:28 (UTC), que devolvió 18 filas. En tus llamadas recibes estos campos, tal como figuran en la referencia de campos.
| id | title | summary | url | cover_image_url | account_name | posted_at | relative_time | kind | platform |
|---|---|---|---|---|---|---|---|---|---|
null | 城市更新的八大类型及典型案例分析(含城市更新专题) | 城市更新涉及范围广、主体多、建设任务纷繁复杂.中共中央办公厅、国务院办公厅《关于持续推进城市更新行动的意见》,将城市更... | https://mp.weixin.qq.com/s?src=11×tamp=1792868283&ver=7046&signature=*kBvA0oukPYHXfmpZWB8cGEugO6pKS0z0G92kHumYr3SO2wiEAGXPgRFIhHBwGjs86NVY6sKC3E-0*IaVBC8XRM3Qb3zBoeF2nH4x6l0S8JKbSmgSBy6PlE2GXzT9uOi&new=1 | https://mmbiz.qpic.cn/sz_mmbiz_jpg/C4sz9kVVx1mva20LCAFC8cTARSIAFo3sBiaEuRhDD1d5n5YCHbZiajFd7eRR5DNE00zpn4f1fWB7IVsrO3WRbM9V7IEHweQautrnpxprcnIvE/0?wx_fmt=jpeg | null | null | null | null | wechat_oa |
null | 李迎伟主持研究城市更新工作 | 李迎伟主持研究城市更新工作提标提速推动城市更新试点任务努力打造具有江汉平原特色的现代化人民城市10月24日,市委书记李迎伟... | https://mp.weixin.qq.com/s?src=11×tamp=1792868283&ver=7046&signature=gzDMFycW6XM4lIXPZ4-qV6LZtQ9JRqDobvYNMGB*W72r5GzoRJTTcH4Y6VZ80RU45fRbEl*bLgZQ548peOPI59SvamTDpdthJzT4BoTP2ueI5lt1ZdS788YtogIxWaYc&new=1 | https://mmbiz.qpic.cn/sz_mmbiz_jpg/6UUD1kjmksibLZqt2kgvS0BGYyGIeqzTBOnCiceTicp8BL2OM0SUCwIWcs0fWnPB30CpBeCngicRejeK6T3o0tb8pjOKrO3xkYKl1dMKOcNTUs8/0?wx_fmt=jpeg | null | null | null | null | wechat_oa |
Casos de uso
Ver cómo se trata un tema
Busca un término del sector y lee el
titley elsummaryde cada fila para ver desde qué ángulos escriben las cuentas.Vigilar artículos nuevos de una marca
Pon
categoryenLATESTy busca por turnos el nombre de la marca o de un competidor para ver qué se ha publicado.Encontrar cuentas que escriben sobre un tema
Lee
account_nameen los resultados y pasa ese nombre aaccount_searchpara obtener el identificador de la cuenta.
Límites y detalles a tener en cuenta
keywordes obligatorio y busca artículos de cuentas oficiales. Para buscar cuentas, usaaccount_search. No es una búsqueda en chats personales de WeChat.categoryadmiteALL,LATEST,HOT,FOLLOWEDoRECENT_READ. Los dos últimos dependen de una sesión de WeChat. Aquí no se usa tu sesión, por lo que no se garantizan resultados, y nunca se leen tus suscripciones ni tu historial de lectura.sub_typees el nombre antiguo decategory, con los mismos valores; se convierte a mayúsculas. Si llegan los dos, mandacategory.limittiene un tope de 400 filas por llamada; esta capacidad no tiene parámetro de paginación.relative_timees una expresión relativa como «hace 3 días». Para ordenar por fecha, usaposted_at.
Precios
Pagas $0.008 por llamada, no por fila. Las llamadas fallidas y los resultados vacíos no se cobran.
| Llamadas | Costo |
|---|---|
| 10,000 | $80.00 |
| 100,000 | $800.00 |
| 1,000,000 | $8,000.00 |
Los totales se calculan con el precio de lista por llamada.
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": "wechat_oa",
"action": "article_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.
Referencia de API
Consulta los parámetros, los campos de respuesta, los errores y la facturación de article_search, y copia la página o ábrela en Markdown para dársela a un asistente de IA.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Cuentas oficiales de WeChat: Búsqueda de artículos (wechat_oa/article_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 wechat_oa y action en article_search, y los parámetros dentro de params.
- Parámetros obligatorios:
- keyword: Usa article_search para buscar artículos, account_search para cuentas oficiales, mini_program_search para miniprogramas, search_suggestions para obtener sugerencias de búsqueda y wechat_index para consultar el índice de…
- Parámetros opcionales:
- category: Categoría de artículos, solo para la acción article_search. Valores: ALL (todos), LATEST (más recientes), HOT (populares), FOLLOWED (seguidos), RECENT_READ (leídos recientemente).
- sub_type: Parámetro compatible con category que usa los mismos cinco valores. El valor que envíes se convertirá a mayúsculas. Si usas ambos parámetros, category tiene prioridad.
- limit: Número máximo de filas que devuelve esta llamada, un entero de 1 a 400. 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, title, summary (Resumen del artículo que muestra el res…), url, cover_image_url (URL de la imagen de portada del artícul…), account_name (Nombre de la cuenta oficial que publicó…), posted_at, relative_time (Tiempo relativo tal como lo muestra WeC…), kind (Tipo de resultado según la etiqueta de…).
- Cuerpo de solicitud de ejemplo:
{
"platform": "wechat_oa",
"action": "article_search",
"params": {
"keyword": "城市更新"
}
}
- Precio: $8 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í | wechat_oa | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | article_search | Identificador de la capacidad, valor fijo. |
keyword | body.params | string | Sí | - | Usa article_search para buscar artículos, account_search para cuentas oficiales, mini_program_search para miniprogramas, search_suggestions para obtener sugerencias de búsqueda y wechat_index para consultar el índice de una palabra clave. Ninguna de estas acciones busca en chats personales de WeChat. |
category | body.params | string | No | - | Categoría de artículos, solo para la acción article_search. Valores: ALL (todos), LATEST (más recientes), HOT (populares), FOLLOWED (seguidos), RECENT_READ (leídos recientemente). Las dos últimas opciones dependen del estado del usuario. Como esta API no recibe tus credenciales de sesión de WeChat, no se garantiza su disponibilidad. Tampoco se accederá a tu lista de cuentas seguidas ni a tu historial de lectura. |
sub_type | body.params | string | No | - | Parámetro compatible con category que usa los mismos cinco valores. El valor que envíes se convertirá a mayúsculas. Si usas ambos parámetros, category tiene prioridad. |
limit | body.params | integer (1–400) | No | 20 | Número máximo de filas que devuelve esta llamada, un entero de 1 a 400. 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. |
Ejemplo de respuesta
#{ "id": "req_…", "platform": "wechat_oa", "action": "article_search", "results": [ { "title": "城市更新的八大类型及典型案例分析(含城市更新专题)", "summary": "城市更新涉及范围广、主体多、建设任务纷繁复杂.中共中央办公厅、国务院办公厅《关于持续推进城市更新行动的意见》,将城市更...", "url": "https://mp.weixin.qq.com/s?src=11×tamp=1792868283&ver=7046&signature=*kBvA0oukPYHXfmpZWB8cGEugO6pKS0z0G92kHumYr3SO2wiEAGXPgRFIhHBwGjs86NVY6sKC3E-0*IaVBC8XRM3Qb3zBoeF2nH4x6l0S8JKbSmgSBy6PlE2GXzT9uOi&new=1", "cover_image_url": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/C4sz9kVVx1mva20LCAFC8cTARSIAFo3sBiaEuRhDD1d5n5YCHbZiajFd7eRR5DNE00zpn4f1fWB7IVsrO3WRbM9V7IEHweQautrnpxprcnIvE/0?wx_fmt=jpeg", "platform": "wechat_oa" }, { "title": "李迎伟主持研究城市更新工作", "summary": "李迎伟主持研究城市更新工作提标提速推动城市更新试点任务努力打造具有江汉平原特色的现代化人民城市10月24日,市委书记李迎伟...", "url": "https://mp.weixin.qq.com/s?src=11×tamp=1792868283&ver=7046&signature=gzDMFycW6XM4lIXPZ4-qV6LZtQ9JRqDobvYNMGB*W72r5GzoRJTTcH4Y6VZ80RU45fRbEl*bLgZQ548peOPI59SvamTDpdthJzT4BoTP2ueI5lt1ZdS788YtogIxWaYc&new=1", "cover_image_url": "https://mmbiz.qpic.cn/sz_mmbiz_jpg/6UUD1kjmksibLZqt2kgvS0BGYyGIeqzTBOnCiceTicp8BL2OM0SUCwIWcs0fWnPB30CpBeCngicRejeK6T3o0tb8pjOKrO3xkYKl1dMKOcNTUs8/0?wx_fmt=jpeg", "platform": "wechat_oa" } ], "count": 18, "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. |
title | Título. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto). |
summary | Resumen del artículo que muestra el resultado de búsqueda. |
url | Enlace al registro en la plataforma. |
cover_image_url | URL de la imagen de portada del artículo. |
account_name | Nombre de la cuenta oficial que publicó el artículo. |
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. |
relative_time | Tiempo relativo tal como lo muestra WeChat (como hace 3 días); para ordenar usa posted_at. |
kind | Tipo de resultado según la etiqueta de WeChat. |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
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.
Preguntas frecuentes
¿Qué sección conviene elegir en category?
ALL, LATEST y HOT cubren casi todos los casos. FOLLOWED y RECENT_READ dependen de una sesión personal de WeChat, que aquí no se envía, por lo que no garantizan resultados. sub_type es el nombre antiguo del mismo ajuste; si llegan los dos, manda category.
¿Es lo mismo que buscar dentro de WeChat?
No del todo. Busca artículos de cuentas oficiales, no chats personales ni Momentos, y nunca lee tus suscripciones ni tu historial. El orden depende de la sección que elijas y puede no coincidir con lo que ves al buscar en tu propio teléfono.
¿Puedo pasar la url de un resultado a las capacidades de comentarios o métricas?
No siempre. Los resultados suelen traer enlaces temporales con parámetros signature y timestamp, y las capacidades de comentarios, respuestas y métricas del artículo responden 422 antes de cobrar cuando no pueden leerlos. Abre el artículo en el navegador, copia su propio enlace, un enlace corto /s/ o uno con __biz, mid, idx y sn, y pásalo.
¿Qué devuelve la búsqueda de artículos?
Cada fila es un artículo: title, summary, url y cover_image_url. La tabla de campos incluye además id, account_name, posted_at, relative_time y kind.
¿Cómo encuentro la cuenta que escribió un artículo?
account_name es el nombre de la cuenta. Pasa ese nombre como keyword a account_search y usa ghid del resultado como account para leer la cuenta concreta.
¿Cuánto cuesta una búsqueda?
Cuesta $0.008 por llamada, o $8 por cada 1000 llamadas, y se factura por llamada, no por fila. Las llamadas fallidas y los resultados vacíos no se cobran.
Capacidades de Cuentas oficiales de WeChat relacionadas
Con la misma clave de API de EveryInfra puedes llamar a los demás endpoints de Cuentas oficiales de WeChat.
- Detalles del artículo
article_detail$5.56 por cada 1000 llamadasObtiene el artículo completo indicado porurlcon el cuerpo en texto plano (content_text) y en HTML original (content_html), además de firma, resumen, portada, etiquetas, fecha, región IP y declaración de original. - Búsqueda de cuentas
account_search$16 por cada 1000 llamadasBusca cuentas oficiales porkeywordy devuelve nombre, alias, descripción y señales de verificación. - Búsqueda de miniprogramas
mini_program_search$5.56 por cada 1000 llamadasDescubre miniprogramas mediantekeyword, conservando nombre, icono, descripción y si aparece como minijuego. - Sugerencias de búsqueda
search_suggestions$5.56 por cada 1000 llamadasObtiene sugerencias de búsqueda asociadas akeyword. - Datos de la cuenta
account_profile$8 por cada 1000 llamadasConsulta una cuenta medianteaccounty devuelve identidad, tipo, descripción y avatar públicos. - Titular de la cuenta
account_principal$5.56 por cada 1000 llamadasLee paraaccountlos datos públicos del principal y estado de verificación cuando existen. - Artículos de la cuenta
account_articles$8 por cada 1000 llamadasObtiene artículos públicos deaccount, con posición, fecha y señales de original o eliminado. - Artículos de hoy de la cuenta
account_today_articles$8 por cada 1000 llamadasConsulta los artículos de hoy deaccounty conserva posición y estado por pieza. - Comentarios del artículo
article_comments$6.76 por cada 1000 llamadasLee comentarios del artículo indicado porurl, con autor, likes, fijado y número de respuestas cuando existen. - Respuestas a comentarios
comment_replies$6.76 por cada 1000 llamadasObtiene respuestas paracomment_iddentro de laurl, concontent_idcompatible. - Interacciones del artículo
article_metrics$5.56 por cada 1000 llamadasConsulta porurllos contadores públicos de lectura, likes, watching, compartidos, guardados y comentarios. - Índice de WeChat
wechat_index$5.56 por cada 1000 llamadasObtiene el índice público asociado akeyword, con último valor, fecha y puntos de tendencia disponibles.