API de Titular de la cuenta de Cuentas oficiales de WeChat

Lee quién está detrás de una cuenta oficial por account: company_name, owner_name, customer_type, verify_status, verify_type, verified_at, además de registered_country, registered_at e is_overseas, por $5.56 por cada 1000 llamadas.

  • customer_type es personal, empresa, gobierno o medio.
  • authorized_agents lista las agencias autorizadas.
  • 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
31 %
Tiempo medio 24 h
36.17 s
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
Casi sin servicio

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

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

    {
      "results": {
        "ghid": "gh_240fbf8b33e4",
        "name": "36氪",
        "company_name": "北京多氪信息科技有限公司",
        "verify_status": true,
        …
      }
    }
  3. 3Campos

    ghidnamecompany_nameverify_status
    gh_240fbf8b33e436氪北京多氪信息科技有限公司true
  4. 4CSV

    wechat_oa-account_principal-sample.csv 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

Entra una solicitud con account y sale un objeto JSON; company_name y verify_status 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_idghidnamedescriptioncompany_nameowner_namecustomer_typeverify_statusverify_typeverified_atregistered_countryregistered_atis_overseaslast_login_provinceauthorized_agentsplatform
nullgh_240fbf8b33e436氪null北京多氪信息科技有限公司nullnulltruenullnullnullnullnullnullnullwechat_oa

Casos de uso

  • Comprobar el titular antes de colaborar

    Lee company_name y owner_name y mira si coinciden con el titular que dice la otra parte.

  • Separar cuentas de empresa y personales

    Usa customer_type para clasificar las cuentas en personal, empresa, gobierno y medio.

  • Señalar cuentas con titular en el extranjero

    is_overseas indica si el titular está en el extranjero, registered_country es el país de registro y last_login_province es la provincia del último inicio de sesión.

  • Leer las fechas de verificación y de registro

    verified_at es la fecha de verificación y registered_at es la fecha de registro. Lee los dos campos por separado.

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_principal de EveryInfra en el nombre del titular y el tipo de verificación.

AspectoInterfaz de la plataforma abierta de WeChat para los detalles de una cuenta autorizadaEveryInfra
Nombre del titularprincipal_name es el nombre del titular.company_name es el nombre de la empresa del titular verificado y owner_name es el nombre del operador.
Tipo de verificaciónverify_type_info es el tipo de verificación de la cuenta oficial o del miniprograma. Entre los valores del ID de tipo están -1 para sin verificar, 0 para verificación de WeChat y 1 para verificación de Sina Weibo.verify_status es el estado de verificación, verify_type es el tipo de verificación y verified_at es la fecha de verificación.

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 y se escribe como en account_profile: un WeChat ID, 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.
  • Aquí no se devuelven el avatar, el tipo de cuenta de suscripción o de servicio ni biz. Léelos en account_profile.
  • customer_type es el tipo de titular: personal, empresa, gobierno o medio.
  • verified_at y registered_at son la fecha de verificación y la de registro. Son dos fechas distintas.
  • Una llamada lee una cuenta.

Precios

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

LlamadasCosto
10,000$55.56
100,000$555.56
1,000,000$5,555.56

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_principal",
  "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_principal, 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: Titular de la cuenta (wechat_oa/account_principal).

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_principal, 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)), ghid, name, description, company_name, owner_name, customer_type, verify_status, verify_type, verified_at, registered_country, registered_at; 15 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=wechat_oa.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "wechat_oa",
  "action": "account_principal",
  "params": {
    "account": "36氪"
  }
}
- Precio: $5.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

#
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_principalIdentificador 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_principal",  "results": {    "ghid": "gh_240fbf8b33e4",    "name": "36氪",    "company_name": "北京多氪信息科技有限公司",    "verify_status": true,    "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).
ghidConserva el significado de la plataforma
nameNombre del propio objeto, en capacidades de cuentas, productos y negocios.
descriptionResumen o descripción, normalmente más breve que text.
company_nameConserva el significado de la plataforma
owner_nameConserva el significado de la plataforma
customer_typeConserva el significado de la plataforma
verify_statusConserva el significado de la plataforma
verify_typeConserva el significado de la plataforma
verified_atConserva el significado de la plataforma
registered_countryConserva el significado de la plataforma
registered_atConserva el significado de la plataforma
is_overseasConserva el significado de la plataforma
last_login_provinceConserva el significado de la plataforma
authorized_agentsConserva 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 la información del titular?

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 y authorized_agents.

¿Qué paso como account?

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. Si solo conoces el nombre, usa antes account_search y toma el ghid de la fila que elijas.

¿En qué se diferencia de account_profile?

Esta capacidad lee el lado del titular: empresa, operador, tipo de titular, verificación y registro. account_profile lee el lado de la cuenta: avatar, tipo de cuenta de suscripción o de servicio y biz. Las dos usan el mismo account.

¿Cuánto cuesta leer una cuenta?

Cuesta $0.005556 por llamada, o $5.56 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