API de Datos de la cuenta de Cuentas oficiales de WeChat

Lee el perfil básico de una cuenta oficial por account: name, account_type (cuenta de suscripción o de servicio), description, avatar_url, account_id y biz, por $8 por cada 1000 llamadas.

  • account admite un WeChat ID, el ID original que empieza por gh_, o un enlace de la cuenta o de un artículo que la identifique.
  • biz es el mismo valor que __biz en los enlaces de sus artículos.
  • 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
Normal
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
Normal

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

    POST /api/v1/social
    {
      "platform": "wechat_oa",
      "action": "account_profile",
      "params": {
        "account": "36氪"
      }
    }
  2. 2Respuesta JSON

    {
      "results": {
        "account_id": "gh_240fbf8b33e4",
        "name": "36氪",
        "account_type": "订阅号",
        …
      }
    }
  3. 3Campos

    account_idnameaccount_type
    gh_240fbf8b33e436氪订阅号
  4. 4CSV

    wechat_oa-account_profile-sample.csv account_id,name,account_type,description,avatar_url,biz,platform

Entra una solicitud con account y sale un objeto JSON; name y account_type son campos suyos, y se muestran como tabla de campos y se pueden descargar en CSV.

Qué datos obtienes

La tabla muestra una llamada real para 36氪, obtenida el 24 de octubre de 2026, 19:16 (UTC), que devolvió un objeto. En tus llamadas recibes estos campos, tal como figuran en la referencia de campos.

account_idnameaccount_typedescriptionavatar_urlbizplatform
gh_240fbf8b33e436氪订阅号nullnullnullwechat_oa

Casos de uso

  • Distinguir cuentas de suscripción y de servicio

    Lee account_type y separa las cuentas de tu lista en cuentas de suscripción y cuentas de servicio.

  • Llevar una ficha por cuenta

    Guarda account_id, name, description y biz, y después relaciona el __biz de un enlace de artículo con la ficha.

  • Completar cuentas encontradas en la búsqueda

    Cuando account_search devuelve candidatas, pasa el ghid como account aquí para añadir account_type.

Interfaz de la plataforma abierta de WeChat para los detalles de una cuenta autorizada frente a EveryInfra

Así se comparan la interfaz «obtener los detalles de la cuenta autorizada» de la plataforma abierta de WeChat y account_profile de EveryInfra en información básica y tipo de cuenta.

AspectoInterfaz de la plataforma abierta de WeChat para los detalles de una cuenta autorizadaEveryInfra
Información básicaLa página dice que la API obtiene la información básica del autorizante, incluidos el avatar, el apodo, el tipo de cuenta, el tipo de verificación, el ID original y más.avatar_url, name, account_type, account_id, description y biz. El tipo de verificación y los datos del titular están en account_principal.
Tipo de cuentaservice_type_info es el tipo de la cuenta oficial o del miniprograma. En los valores del ID de tipo, 0 es una cuenta de suscripción y 2 es una cuenta de servicio.account_type devuelve directamente el tipo de cuenta de suscripción o de servicio.

La documentación de la plataforma abierta de WeChat está en chino. La tabla muestra una traducción de la página de detalles de la cuenta autorizada, cotejada el 2026-11-22; la página no indica fecha de actualización. La interfaz oficial solo permite que una plataforma de terceros lea una cuenta autorizada, con component_access_token. Fuentes oficiales: Obtener los detalles de la cuenta autorizada

Límites y detalles a tener en cuenta

  • account es obligatorio. Admite el WeChat ID de la cuenta, el ID original que empieza por gh_, o un enlace de la cuenta o de un artículo que la identifique. Un WeChat ID personal no sirve.
  • account_type es cuenta de suscripción o de servicio. No indica el estado de verificación; para la verificación y los datos del titular, lee account_principal.
  • biz es el valor del parámetro __biz de los enlaces de artículos, y los enlaces de artículos de una misma cuenta llevan el mismo valor.
  • Una llamada lee una cuenta.

Precios

Pagas $0.008 por llamada, no por fila. Las llamadas fallidas y los resultados vacíos no se cobran.

LlamadasCosto
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

#
bash
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": "account_profile",
  "params": {
    "account": "36氪"
  }
}'

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 account_profile, y copia la página o ábrela en Markdown para dársela a un asistente de IA.

POST

Prompt para IA

#
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Cuentas oficiales de WeChat: Datos de la cuenta (wechat_oa/account_profile).

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 account_profile, y los parámetros dentro de params.
- Parámetros obligatorios:
  - account: 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.
- Devuelve un objeto. Campos principales: account_id (ID de la cuenta oficial (su WeChat ID)), name, account_type, description, avatar_url, biz.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "wechat_oa",
  "action": "account_profile",
  "params": {
    "account": "36氪"
  }
}
- 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

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-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.
platformbodystringSíwechat_oaIdentificador de la plataforma, valor fijo.
actionbodystringSíaccount_profileIdentificador de la capacidad, valor fijo.
accountbody.paramsstringSí-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_principal obtiene la información del titular, account_articles el listado de artículos históricos y account_today_articles los artículos del día.

Ejemplo de respuesta

#
Obtenida el 24 de octubre de 2026, 19:16 (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). id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
json
{  "id": "req_…",  "platform": "wechat_oa",  "action": "account_profile",  "results": {    "account_id": "gh_240fbf8b33e4",    "name": "36氪",    "account_type": "订阅号",    "platform": "wechat_oa"  },  "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.

CampoSignificado
account_idID de la cuenta oficial (su WeChat ID).
nameNombre del propio objeto, en capacidades de cuentas, productos y negocios.
account_typeConserva el significado de la plataforma
descriptionResumen o descripción, normalmente más breve que text.
avatar_urlEnlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar.
bizConserva el significado de la plataforma
platformIdentificador 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.

Errores

Referencias oficiales

#

Solo sirven para contrastar objetos y términos. No implican autorización ni respaldo de la plataforma a EveryInfra.

  • 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í.

    Comprobado el 2026-09-04

Preguntas frecuentes

¿Qué campos devuelve el perfil de la cuenta?

account_id, name, account_type, description, avatar_url y biz.

¿Qué identificador uso en account?

Puedes usar el ID original que empieza por gh_, que es único dentro de WeChat. También sirven el WeChat ID de la cuenta o un enlace que la identifique, como un enlace de uno de sus artículos. Si solo conoces el nombre, busca antes con account_search.

¿Cómo averiguo quién es el titular de una cuenta?

Este perfil no lo trae. Pasa el mismo valor de account a account_principal, que devuelve la empresa, el operador y los datos de verificación.

¿Cuánto cuesta leer una cuenta?

Cuesta $0.008 por llamada, o $8 por cada 1000 llamadas, y una llamada lee una cuenta. Las llamadas fallidas y los resultados vacíos no se cobran.

Con la misma clave de API de EveryInfra puedes llamar a los demás endpoints de Cuentas oficiales de WeChat.

Google Analytics solo si aceptas. Privacidad