API de Analítica de creador en Xingtu de Douyin

POST

Salud de la API

Salud 24 h
Normal
Tiempo medio 24 h
—
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
Normal

Usa el douyin_id visible devuelto por la acción ordinaria creator_search para consultar una ficha analítica de Xingtu; xingtu_creator_search no proporciona este dato. No lo confundas con user_id ni creator_id; tipo, grado, métricas, señales comerciales y cotización mínima no acreditan identidad legal ni rendimiento futuro.

Douyin Analítica de creador en Xingtu lee la ficha comercial de un creador en Xingtu, la plataforma de Douyin para colaboraciones con marcas, a partir del ID de Douyin que aparece en su perfil. Devuelve el creator_id de Xingtu, el tipo y el grado del creador, su género, ciudad y provincia, los seguidores, la media de reproducciones que publica Xingtu, la categoría, los temas de contenido y las etiquetas, si figura como creador de Xingtu, si tiene habilitado el comercio electrónico y la cotización mínima publicada. Antes de una contratación, marcas y agencias consultan esta ficha para medir el tamaño de la audiencia, las reproducciones habituales de un video y el precio de partida.

average_play_count es la cifra propia de Xingtu, útil porque las páginas públicas de Douyin no muestran reproducciones, pero no es una previsión de resultados futuros. lowest_quote_cny es una cotización en yuanes, no un precio cerrado. is_xingtu_creator indica si la cuenta es un creador de Xingtu, y city llega en el idioma de la plataforma, sin normalizar.

Precio $0.56 por 1.000 solicitudes ($0.000556 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.

Prompt para IA

Pégalo en tu asistente de IA. Ya incluye los parámetros, los campos de respuesta y una solicitud de ejemplo de este endpoint, así que el asistente puede preguntarte qué necesitas y luego escribir el script.

Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Douyin: Analítica de creador en Xingtu (douyin/xingtu_creator_analytics).

Contrato del 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 douyin y action en xingtu_creator_analytics, y los parámetros dentro de params.
- Parámetros obligatorios:
  - douyin_id: ID visible de la cuenta de Douyin (unique_id) devuelto por la acción ordinaria creator_search y requerido por xingtu_creator_analytics y xingtu_rate_card; xingtu_creator_search no lo devuelve.
- Devuelve un objeto. Campos principales: creator_id, creator_type, follower_count, average_play_count, city, province, gender (Género tal como lo muestra la cuenta), category_id, content_themes, tags, creator_grade, is_xingtu_creator; 14 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "douyin",
  "action": "xingtu_creator_analytics",
  "params": {
    "douyin_id": "XiaoZhenlla"
  }
}
- Precio: $0.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ídouyinIdentificador de la plataforma, valor fijo.
actionbodystringSíxingtu_creator_analyticsIdentificador de la capacidad, valor fijo.
douyin_idbody.paramsNo declaradoSí-ID visible de la cuenta de Douyin (unique_id) devuelto por la acción ordinaria creator_search y requerido por xingtu_creator_analytics y xingtu_rate_card; xingtu_creator_search no lo devuelve. Es distinto de un user_id secUid, del creator_id de Xingtu y del apodo.

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": "douyin",
  "action": "xingtu_creator_analytics",
  "params": {
    "douyin_id": "XiaoZhenlla"
  }
}'

[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

Vista previa de campos

Todavía no hay una muestra real para estos parámetros de ejemplo: se muestra la estructura de la respuesta y sus campos según el contrato, con … como marcadores. No es el resultado de una llamada real.

json
{
  "id": "req_…",
  "platform": "douyin",
  "action": "xingtu_creator_analytics",
  "results": {
    "creator_id": …,
    "creator_type": …,
    "follower_count": …,
    "average_play_count": …,
    "city": …,
    "province": …,
    "gender": …,
    "category_id": …,
    "content_themes": …,
    "tags": …,
    "creator_grade": …,
    "is_xingtu_creator": …,
    "ecommerce_enabled": …,
    "lowest_quote_cny": …,
    "platform": …
  },
  "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
creator_idConserva el significado de la plataforma
creator_typeConserva el significado de la plataforma
follower_countSeguidores. null significa no publicado, no 0.
average_play_countConserva el significado de la plataforma
cityNombre de la ciudad en el idioma de la plataforma, sin normalizar.
provinceConserva el significado de la plataforma
genderGénero tal como lo muestra la cuenta.
category_idConserva el significado de la plataforma
content_themesConserva el significado de la plataforma
tagsLista de etiquetas. Si no hay, es una lista vacía, no null.
creator_gradeConserva el significado de la plataforma
is_xingtu_creatorConserva el significado de la plataforma
ecommerce_enabledConserva el significado de la plataforma
lowest_quote_cnyConserva el significado de la plataforma
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Preguntas frecuentes

¿De dónde saco el douyin_id?

Es el ID de Douyin que se ve en el perfil del creador, y Douyin Búsqueda de creadores lo devuelve para cada cuenta que encuentra. Los resultados de Douyin Búsqueda de creadores en Xingtu no lo incluyen: traen los ID comerciales y las cotizaciones de Xingtu, que aquí no sirven. Tampoco funcionan el secUid, que suele empezar por MS4w, ni el apodo de la cuenta.

¿En qué se diferencian creator_id y douyin_id?

douyin_id es el identificador público que pasas como entrada, el que aparece en el perfil. creator_id es el ID estable que Xingtu asigna al mismo creador; no coincide con ese identificador ni con el secUid que usan otras capacidades de Douyin. Guarda los dos para cruzar más adelante los datos de Xingtu con los de perfil, audiencia y videos.

¿lowest_quote_cny es lo que costará una colaboración?

No. Es la cotización más baja que Xingtu muestra para el creador, en yuanes: un precio publicado, no el importe de una operación cerrada. Para ver todos los niveles de tarifa, con sus condiciones de liquidación y si están disponibles, consulta Douyin Tarifas de creador en Xingtu con el mismo douyin_id.

Errores y facturación

401
Falta la clave o no es válida. La autenticación se comprueba antes que los parámetros, así que las solicitudes sin autenticar no ven el esquema de parámetros.
422
Nombre o valor de parámetro incorrecto. El error enumera los parámetros y valores permitidos de esta capacidad y la opción más cercana; ocurre antes de cualquier cobro.
402
Saldo insuficiente. Recarga primero.
429
Se alcanzó el límite de solicitudes por minuto de la cuenta (todas sus claves API cuentan juntas; antes se aplica el límite propio de una clave si es menor). Espera lo que indique Retry-After y vuelve a intentarlo; un paquete de velocidad en la consola sube el límite.
503
No se pudo completar ahora. Cualquier cargo de la llamada vuelve automáticamente a tu saldo, y el recibo de facturación de la respuesta indica el resultado real, también cuando aún no se conoce. No reenvíes a ciegas.
200 vacío
La solicitud terminó sin datos y no se cobra (billing.reason = empty_result_refunded).