API de Cuentas oficiales de WeChat
Busca y consulta cuentas oficiales de WeChat, miniprogramas, artículos, comentarios, métricas e índice de palabras. Cuenta, URL, comentario y palabra clave son identificadores distintos.
Verificación, principal y métricas proceden de la información pública disponible. La API no administra cuentas, publica mensajes ni accede a conversaciones o datos de suscriptores.
Disponibilidad de la plataforma
- Salud 24 h
- 71 %
Últimos 30 días
Funciones disponibles
Cada acción de Cuentas oficiales de WeChat, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar artículos de cuentas oficialesarticle_search | Busca artículos de cuentas oficiales mediante keyword, con categoría o subtipo opcionales. | $5.56 por 1.000 solicitudes | Saludable · salud 97 % |
Leer el contenido de un artículoarticle_detail | Obtiene el artículo completo indicado por url con 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. | $5.56 por 1.000 solicitudes | Disponible · salud 75 % |
Buscar cuentas oficiales de WeChataccount_search | Busca cuentas oficiales por keyword y devuelve nombre, alias, descripción y señales de verificación. | $5.56 por 1.000 solicitudes | Normal |
Buscar miniprogramas de WeChatmini_program_search | Descubre miniprogramas mediante keyword, conservando nombre, icono, descripción y si aparece como minijuego. | $5.56 por 1.000 solicitudes | No disponible temporalmente |
Consultar sugerencias de búsquedasearch_suggestions | Obtiene sugerencias de búsqueda asociadas a keyword. | $5.56 por 1.000 solicitudes | No disponible temporalmente |
Consultar el perfil de una cuenta oficialaccount_profile | Consulta una cuenta mediante account y devuelve identidad, tipo, descripción y avatar públicos. | $5.56 por 1.000 solicitudes | Normal |
Consultar el titular de la cuentaaccount_principal | Lee para account los datos públicos del principal y estado de verificación cuando existen. | $5.56 por 1.000 solicitudes | Normal |
Listar artículos de una cuentaaccount_articles | Obtiene artículos públicos de account, con posición, fecha y señales de original o eliminado. | $5.56 por 1.000 solicitudes | Normal |
Listar los artículos publicados hoyaccount_today_articles | Consulta los artículos de hoy de account y conserva posición y estado por pieza. | $5.56 por 1.000 solicitudes | No disponible temporalmente |
Leer comentarios de un artículoarticle_comments | Lee comentarios del artículo indicado por url, con autor, likes, fijado y número de respuestas cuando existen. | $5.56 por 1.000 solicitudes | Normal |
Leer respuestas de un comentariocomment_replies | Obtiene respuestas para comment_id dentro de la url, con content_id compatible. | $5.56 por 1.000 solicitudes | No disponible temporalmente |
Consultar métricas públicas del artículoarticle_metrics | Consulta por url los contadores públicos de lectura, likes, watching, compartidos, guardados y comentarios. | $5.56 por 1.000 solicitudes | Normal |
Consultar el índice de una palabrawechat_index | Obtiene el índice público asociado a keyword, con último valor, fecha y puntos de tendencia disponibles. | $5.56 por 1.000 solicitudes | No disponible temporalmente |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Cuentas oficiales de WeChat?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
article_searchBuscar artículos de cuentas oficiales Busca artículos de cuentas oficiales mediante | keyword | category, sub_type | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 400 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $5.56 por 1.000 solicitudes | id · title · summary · url · cover_image_url · account_name · posted_at · relative_time · kind · platform |
article_detailLeer el contenido de un artículo Obtiene el artículo completo indicado por | url | — | Entrega síncrona | — | $5.56 por 1.000 solicitudes | id · title · url · content_text · content_html · author · account_name · account_ghid · digest · cover_image_url · images · hashtags · is_original · posted_at · ip_region · platform |
account_searchBuscar cuentas oficiales de WeChat Busca cuentas oficiales por | keyword | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 400 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $5.56 por 1.000 solicitudes | account_id · ghid · name · description · alias · avatar_url · verify_flag · biz · platform |
mini_program_searchBuscar miniprogramas de WeChat Descubre miniprogramas mediante | keyword | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 400 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $5.56 por 1.000 solicitudes | id · name · description · icon_url · username · is_minigame · platform |
search_suggestionsConsultar sugerencias de búsqueda Obtiene sugerencias de búsqueda asociadas a | keyword | — | Entrega síncrona | — | $5.56 por 1.000 solicitudes | suggestions · count · platform |
account_profileConsultar el perfil de una cuenta oficial Consulta una cuenta mediante | account | — | Entrega síncrona | — | $5.56 por 1.000 solicitudes | account_id · name · account_type · description · avatar_url · biz · platform |
account_principalConsultar el titular de la cuenta Lee para | account | — | Entrega síncrona | — | $5.56 por 1.000 solicitudes | account_id · ghid · name · description · company_name · owner_name · customer_type · verify_status · verify_type · verified_at · registered_country · registered_at · is_overseas · last_login_province · authorized_agents · platform |
account_articlesListar artículos de una cuenta Obtiene artículos públicos de | account | — | Entrega síncrona | El catálogo declara defaultLimit = 8 y maxLimit = 160 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $5.56 por 1.000 solicitudes | id · title · url · cover_image_url · posted_at · position · is_original · is_deleted · account_name · account_id · account_ghid · platform |
account_today_articlesListar los artículos publicados hoy Consulta los artículos de hoy de | account | — | Entrega síncrona | — | $5.56 por 1.000 solicitudes | id · title · url · cover_image_url · posted_at · position · is_original · is_deleted · account_name · account_id · account_ghid · platform |
article_commentsLeer comentarios de un artículo Lee comentarios del artículo indicado por | url | — | Entrega síncrona | El catálogo declara defaultLimit = 13 y maxLimit = 260 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $5.56 por 1.000 solicitudes | id · text · author_name · author_avatar_url · like_count · posted_at · is_top · reply_count · country · province · platform |
comment_repliesLeer respuestas de un comentario Obtiene respuestas para | url, comment_id | content_id | Entrega síncrona | — | $5.56 por 1.000 solicitudes | id · text · author_name · author_avatar_url · like_count · posted_at · country · province · city · platform |
article_metricsConsultar métricas públicas del artículo Consulta por | url | — | Entrega síncrona | — | $5.56 por 1.000 solicitudes | read_count · like_count · watching_count · share_count · collect_count · comment_count · platform |
wechat_indexConsultar el índice de una palabra Obtiene el índice público asociado a | keyword | — | Entrega síncrona | — | $5.56 por 1.000 solicitudes | keyword · latest_index · latest_date · data_points · trend · platform |
¿Qué significan los parámetros de Cuentas oficiales de WeChat article_search?
Busca artículos de cuentas oficiales mediante keyword, con categoría o subtipo opcionales. Devuelve cuenta, resumen y fecha visibles; no recupera mensajes privados ni garantiza texto íntegro.
keywordObligatorio- Usa
article_searchpara buscar artículos,account_searchpara cuentas oficiales,mini_program_searchpara miniprogramas,search_suggestionspara obtener sugerencias de búsqueda ywechat_indexpara consultar el índice de una palabra clave. Ninguna de estas acciones busca en chats personales de WeChat. categoryOpcional- 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_typeOpcional- Parámetro compatible con
categoryque usa los mismos cinco valores. El valor que envíes se convertirá a mayúsculas. Si usas ambos parámetros,categorytiene prioridad.
¿Qué significan los parámetros de Cuentas oficiales de WeChat article_detail?
Obtiene el artículo completo indicado por url con 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. No incluye los comentarios ni amplía otras secciones de la cuenta.
urlObligatorio- Las acciones
article_comments,comment_replies,article_metricsyarticle_detailrequieren el enlace propio del artículo enmp.weixin.qq.com: abre el artículo y copia su enlace (un enlace corto /s/<id> o uno con__biz,mid,idxysn). Los enlaces temporales copiados de los resultados de búsqueda (consignature/timestamp) pueden no poder leerse; en ese caso la llamada devuelve 422 antes de cobrar nada. Las acciones de tipo cuenta solo usan este parámetro como la entrada de menor prioridad para identificar la cuenta oficial.
¿Qué significan los parámetros de Cuentas oficiales de WeChat account_search?
Busca cuentas oficiales por keyword y devuelve nombre, alias, descripción y señales de verificación. La coincidencia no prueba identidad legal ni suscripción del usuario.
keywordObligatorio- Usa
article_searchpara buscar artículos,account_searchpara cuentas oficiales,mini_program_searchpara miniprogramas,search_suggestionspara obtener sugerencias de búsqueda ywechat_indexpara consultar el índice de una palabra clave. Ninguna de estas acciones busca en chats personales de WeChat.WeChat: nickname, alias y original ID — La documentación de WeChat separa `nick_name`, `alias` y `user_name`, y señala que el alias puede faltar. En los resultados, `name`, `account_id` y `ghid` deben conservarse como identificadores distintos. · Consultada
¿Qué significan los parámetros de Cuentas oficiales de WeChat mini_program_search?
Descubre miniprogramas mediante keyword, conservando nombre, icono, descripción y si aparece como minijuego. No ejecuta el programa ni concede acceso a sus datos internos.
keywordObligatorio- Usa
article_searchpara buscar artículos,account_searchpara cuentas oficiales,mini_program_searchpara miniprogramas,search_suggestionspara obtener sugerencias de búsqueda ywechat_indexpara consultar el índice de una palabra clave. Ninguna de estas acciones busca en chats personales de WeChat.
¿Qué significan los parámetros de Cuentas oficiales de WeChat search_suggestions?
Obtiene sugerencias de búsqueda asociadas a keyword. Son términos devueltos para esa consulta, no volumen de búsqueda, ranking o tendencia histórica.
keywordObligatorio- Usa
article_searchpara buscar artículos,account_searchpara cuentas oficiales,mini_program_searchpara miniprogramas,search_suggestionspara obtener sugerencias de búsqueda ywechat_indexpara consultar el índice de una palabra clave. Ninguna de estas acciones busca en chats personales de WeChat.
¿Qué significan los parámetros de Cuentas oficiales de WeChat account_profile?
Consulta una cuenta mediante account y devuelve identidad, tipo, descripción y avatar públicos. No abre el backend de la cuenta ni valida a su titular.
accountObligatorio- Identificador de una cuenta oficial. Puedes usar el ID de WeChat, el ID original que empieza por
gh_o una URL de cuenta o artículo desde la que se pueda identificar la cuenta. No es un ID de WeChat personal.account_principalobtiene la información del titular,account_articlesel listado de artículos históricos yaccount_today_articleslos artículos del día.WeChat: Tipo de cuenta, tipo de certificación y nombre de la entidad — La documentación oficial de WeChat describe por separado el tipo de cuenta, el tipo de certificación y el nombre de la entidad titular. El nombre que se muestra en la cuenta no equivale al nombre de la entidad. Esta referencia solo sirve para contrastar la terminología y no implica que se disponga de permisos de gestión de cuentas autorizadas por la plataforma, ni que su `access_token` o `appid` puedan usarse como parámetros aquí. · Consultada
¿Qué significan los parámetros de Cuentas oficiales de WeChat account_principal?
Lee para account los datos públicos del principal y estado de verificación cuando existen. No sustituye una comprobación registral ni revela credenciales administrativas.
accountObligatorio- Identificador de una cuenta oficial. Puedes usar el ID de WeChat, el ID original que empieza por
gh_o una URL de cuenta o artículo desde la que se pueda identificar la cuenta. No es un ID de WeChat personal.account_principalobtiene la información del titular,account_articlesel listado de artículos históricos yaccount_today_articleslos artículos del día.WeChat: Tipo de cuenta, tipo de certificación y nombre de la entidad — La documentación oficial de WeChat describe por separado el tipo de cuenta, el tipo de certificación y el nombre de la entidad titular. El nombre que se muestra en la cuenta no equivale al nombre de la entidad. Esta referencia solo sirve para contrastar la terminología y no implica que se disponga de permisos de gestión de cuentas autorizadas por la plataforma, ni que su `access_token` o `appid` puedan usarse como parámetros aquí. · Consultada
¿Qué significan los parámetros de Cuentas oficiales de WeChat account_articles?
Obtiene artículos públicos de account, con posición, fecha y señales de original o eliminado. El lote no garantiza todo el archivo ni contenido retirado.
accountObligatorio- Identificador de una cuenta oficial. Puedes usar el ID de WeChat, el ID original que empieza por
gh_o una URL de cuenta o artículo desde la que se pueda identificar la cuenta. No es un ID de WeChat personal.account_principalobtiene la información del titular,account_articlesel listado de artículos históricos yaccount_today_articleslos artículos del día.
¿Qué significan los parámetros de Cuentas oficiales de WeChat account_today_articles?
Consulta los artículos de hoy de account y conserva posición y estado por pieza. No es una suscripción en tiempo real ni incluye días anteriores.
accountObligatorio- Identificador de una cuenta oficial. Puedes usar el ID de WeChat, el ID original que empieza por
gh_o una URL de cuenta o artículo desde la que se pueda identificar la cuenta. No es un ID de WeChat personal.account_principalobtiene la información del titular,account_articlesel listado de artículos históricos yaccount_today_articleslos artículos del día.
¿Qué significan los parámetros de Cuentas oficiales de WeChat article_comments?
Lee comentarios del artículo indicado por url, con autor, likes, fijado y número de respuestas cuando existen. No publica ni garantiza todos los comentarios.
urlObligatorio- Las acciones
article_comments,comment_replies,article_metricsyarticle_detailrequieren el enlace propio del artículo enmp.weixin.qq.com: abre el artículo y copia su enlace (un enlace corto /s/<id> o uno con__biz,mid,idxysn). Los enlaces temporales copiados de los resultados de búsqueda (consignature/timestamp) pueden no poder leerse; en ese caso la llamada devuelve 422 antes de cobrar nada. Las acciones de tipo cuenta solo usan este parámetro como la entrada de menor prioridad para identificar la cuenta oficial.WeChat: Diferencia entre comentarios de un artículo y comentarios destacados — La documentación de WeChat sobre comentarios distingue entre el artículo, el ID del comentario, la marca de destacado y la información de la respuesta. El alcance de los comentarios en el backend de la API oficial autorizada no es el mismo que el visible a través de esta consulta. El campo `is_top` tampoco debe interpretarse directamente como la marca de destacado del `comment_type` oficial. · Consultada
¿Qué significan los parámetros de Cuentas oficiales de WeChat comment_replies?
Obtiene respuestas para comment_id dentro de la url, con content_id compatible. Conserva ubicación mostrada y autor; no reconstruye conversaciones ajenas al comentario.
urlObligatorio- Las acciones
article_comments,comment_replies,article_metricsyarticle_detailrequieren el enlace propio del artículo enmp.weixin.qq.com: abre el artículo y copia su enlace (un enlace corto /s/<id> o uno con__biz,mid,idxysn). Los enlaces temporales copiados de los resultados de búsqueda (consignature/timestamp) pueden no poder leerse; en ese caso la llamada devuelve 422 antes de cobrar nada. Las acciones de tipo cuenta solo usan este parámetro como la entrada de menor prioridad para identificar la cuenta oficial. comment_idObligatorio- ID del comentario de destino para la acción
comment_replies. Debes obtenerlo de los resultados dearticle_commentspara el mismo artículo y debe corresponder con laurlque envíes. No es el ID del artículo.WeChat: Respuestas existentes y gestión de comentarios — WeChat considera la visualización de comentarios, la publicación de respuestas, su eliminación y la gestión de destacados como operaciones distintas. La acción `comment_replies` solo lee las respuestas existentes; que su nombre incluya `replies` no significa que permita publicar, eliminar o gestionar comentarios. · Consultada content_idOpcional- Parámetro compatible con
comment_id, pero con menor prioridad.
¿Qué significan los parámetros de Cuentas oficiales de WeChat article_metrics?
Consulta por url los contadores públicos de lectura, likes, watching, compartidos, guardados y comentarios. Es una instantánea y no una serie histórica o analítica privada.
urlObligatorio- Las acciones
article_comments,comment_replies,article_metricsyarticle_detailrequieren el enlace propio del artículo enmp.weixin.qq.com: abre el artículo y copia su enlace (un enlace corto /s/<id> o uno con__biz,mid,idxysn). Los enlaces temporales copiados de los resultados de búsqueda (consignature/timestamp) pueden no poder leerse; en ese caso la llamada devuelve 422 antes de cobrar nada. Las acciones de tipo cuenta solo usan este parámetro como la entrada de menor prioridad para identificar la cuenta oficial.
¿Qué significan los parámetros de Cuentas oficiales de WeChat wechat_index?
Obtiene el índice público asociado a keyword, con último valor, fecha y puntos de tendencia disponibles. No representa búsquedas exactas, usuarios únicos ni una métrica propia de EveryInfra.
keywordObligatorio- Usa
article_searchpara buscar artículos,account_searchpara cuentas oficiales,mini_program_searchpara miniprogramas,search_suggestionspara obtener sugerencias de búsqueda ywechat_indexpara consultar el índice de una palabra clave. Ninguna de estas acciones busca en chats personales de WeChat.
Cómo usar la API de Cuentas oficiales de WeChat
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"wechat_oa","action":"article_search","params":{"keyword":"<keyword>"}}'
Guías de Cuentas oficiales de WeChat
Ejemplos completos y métodos basados en estas acciones. Comprueba primero en esta página las acciones, parámetros y campos actuales; los ejemplos y límites de un artículo no sustituyen al catálogo en vivo.
Plan de seguimiento de reputación en múltiples plataformas: registra el alcance de la recolección antes de evaluar cambios negativos.
Diseña un proceso de seguimiento de reputación trazable a partir de listas de objetivos, identidades de comentarios y cursores incrementales; usa muestras locales para demostrar la deduplicación y las brechas de recolección, conserva la revisión manual y evita presentar casos de éxito de clientes.
Leer el artículo →Inicio con la API de datos unificada: del directorio de capacidades al primer resultado disponible
Integra datos multiplataforma usando platform, action y params: comprende el directorio de capacidades, completa una solicitud mínima, gestiona tareas asíncronas, resultados parciales y facturación, y establece registros de datos trazables.
Leer el artículo →Preguntas sobre la API de Cuentas oficiales de WeChat
¿Cómo llamo a la API de Cuentas oficiales de WeChat?
Envía POST /api/v1/social con platform igual a wechat_oa, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Cuentas oficiales de WeChat?
Devuelve JSON estructurado. Por ejemplo, el esquema de article_search incluye title, summary, cover_image_url y account_name. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Cuentas oficiales de WeChat?
La documentación de WeChat separa nick_name, alias y user_name, y señala que el alias puede faltar. En los resultados, name, account_id y ghid deben conservarse como identificadores distintos.
¿Qué parámetros son obligatorios?
Depende de la acción. article_search requiere keyword; article_detail requiere url; account_search requiere keyword; consulta las demás acciones en la lista de funciones.
¿Las acciones de Cuentas oficiales de WeChat responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.