API de Capacidad de conversión en Xingtu de Douyin
Salud de la API
- Salud 24 h
- Normal
- Tiempo medio 24 h
- —
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Últimas 24 horas
Últimos 30 días
Consulta las cifras de conversión que Xingtu muestra para los vídeos de pedidos de Xingtu de un creador en los últimos 7, 30 o 90 días (time_window, por defecto 30d): vídeos relacionados, mediana de reproducciones, clics en el componente y su tasa, CPC, GPM, ventas medias, productos promocionados y sus categorías. Casi todo llega como rangos con la redacción de Xingtu, como 500-1000; los abiertos, como «10 % o más», llegan en chino. Solo los creadores con pedidos de Xingtu en el periodo tienen cifras; el resto devuelve un resultado vacío, que no se cobra.
Precio $1.6 por 1.000 solicitudes ($0.001597 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
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra Douyin: Capacidad de conversión en Xingtu (douyin/xingtu_conversion_ability).
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 douyin y action en xingtu_conversion_ability, y los parámetros dentro de params.
- Parámetros obligatorios:
- douyin_id: ID visible de Douyin del creador (unique_id, de creator_search) o el creator_id de 19 dígitos de Xingtu que devuelve xingtu_creator_search. Si el creador no está en Xingtu, el resultado llega vacío y no se cobra.
- Parámetros opcionales:
- time_window: Periodo de las cifras de Xingtu: 7d, 30d (por defecto) o 90d, contado hacia atrás desde hoy. No es el periodo de los rankings de xingtu_creator_rankings. (valores admitidos: 30d / 7d / 90d)
- Devuelve un objeto. Campos principales: creator_id, time_window (Periodo de las cifras (xingtu_conversio…), related_video_count (Vídeos que Xingtu usó para las cifras d…), video_play_median (Mediana de reproducciones de esos vídeo…), component_click_count_range (Rango de clics en el componente con la…), component_click_rate_range (Rango de la tasa de clics en el compone…), cpc_range_cny (Rango de coste por clic en yuanes (xing…), gpm_range_cny (Rango de GPM en yuanes, ventas por cada…), average_sales_range_cny (Rango de ventas medias en yuanes (xingt…), product_count (Productos que el creador promocionó en…), product_price_range_cny (Rango de precios de esos productos en y…), categories (En xingtu_conversion_ability, las categ…).
- Cuerpo de solicitud de ejemplo:
{
"platform": "douyin",
"action": "xingtu_conversion_ability",
"params": {
"douyin_id": "XiaoZhenlla"
}
}
- Precio: $1.6 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í | douyin | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | xingtu_conversion_ability | Identificador de la capacidad, valor fijo. |
douyin_id | body.params | string | Sí | - | ID visible de Douyin del creador (unique_id, de creator_search) o el creator_id de 19 dígitos de Xingtu que devuelve xingtu_creator_search. Si el creador no está en Xingtu, el resultado llega vacío y no se cobra. |
time_window | body.params | string (enum) | No | - | Periodo de las cifras de Xingtu: 7d, 30d (por defecto) o 90d, contado hacia atrás desde hoy. No es el periodo de los rankings de xingtu_creator_rankings.Valores permitidos30d7d90d |
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": "douyin",
"action": "xingtu_conversion_ability",
"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
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 la definición de la API, con … como marcadores. No es el resultado de una llamada real.
{
"id": "req_…",
"platform": "douyin",
"action": "xingtu_conversion_ability",
"results": {
"creator_id": …,
"time_window": …,
"related_video_count": …,
"video_play_median": …,
"component_click_count_range": …,
"component_click_rate_range": …,
"cpc_range_cny": …,
"gpm_range_cny": …,
"average_sales_range_cny": …,
"product_count": …,
"product_price_range_cny": …,
"categories": …,
"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.
| Campo | Significado |
|---|---|
creator_id | Conserva el significado de la plataforma |
time_window | Periodo de las cifras (xingtu_conversion_ability): 7d, 30d o 90d, como se pidió. |
related_video_count | Vídeos que Xingtu usó para las cifras de conversión del periodo (xingtu_conversion_ability). |
video_play_median | Mediana de reproducciones de esos vídeos (xingtu_conversion_ability). |
component_click_count_range | Rango de clics en el componente con la redacción de Xingtu (xingtu_conversion_ability), como 500-1000; los rangos abiertos, como «menos de 500», llegan en chino. |
component_click_rate_range | Rango de la tasa de clics en el componente (xingtu_conversion_ability), como 2%-5%; los rangos abiertos, como «10 % o más», llegan en chino. |
cpc_range_cny | Rango de coste por clic en yuanes (xingtu_conversion_ability), como 6-8. |
gpm_range_cny | Rango de GPM en yuanes, ventas por cada mil reproducciones (xingtu_conversion_ability), como 10-30. |
average_sales_range_cny | Rango de ventas medias en yuanes (xingtu_conversion_ability), como 2000-5000; no aparece si el creador oculta sus ventas en Xingtu. |
product_count | Productos que el creador promocionó en el periodo (xingtu_conversion_ability). |
product_price_range_cny | Rango de precios de esos productos en yuanes (xingtu_conversion_ability), como 2000-5000; las decenas de miles pueden llevar la unidad china de 10.000. |
categories | En xingtu_conversion_ability, las categorías de productos promocionados: [{name, share (de 0 a 1), sales_range_cny}], solo si el creador promocionó productos. En xingtu_touch_distribution, las categorías de contenido de las que proceden los usuarios conectados, hasta tres niveles: [{name, touch_count, subcategories (misma forma)}]. |
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.