API de Historial de métricas de una publicación de Douyin

Lee las capturas registradas de «me gusta», comentarios, compartidos y guardados de una publicación por su ID de video o su enlace de video; cada fila tiene su propio captured_at, por $0.79 por cada 1000 llamadas.

  • Las filas van de la más antigua a la más reciente, y el intervalo entre registros varía.
  • Acepta un ID de video o un enlace de video, no un enlace corto ni un texto de compartir.
  • Las llamadas fallidas y los resultados vacíos 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": "douyin",
      "action": "post_history",
      "params": {
        "url": "https://www.douyin.com/video/7633646113853104116"
      }
    }
  2. 2Respuesta JSON

    {
      "results": [
        {
          "video_id": string,
          "captured_at": …,
          "like_count": number,
          "comment_count": number
        },
        …
      ]
    }
  3. 3Filas

    video_idcaptured_atlike_countcomment_count
    string…numbernumber
  4. 4CSV

    douyin-post_history-sample.csv video_id,captured_at,like_count,comment_count,share_count,collect_count,platform

Entra una solicitud con url y salen los registros de la publicación; cada fila de results trae los cuatro contadores de un momento, y se muestra como tabla de campos y se puede descargar en CSV.

Qué datos obtienes

Este endpoint aún no tiene una muestra real pública. La tabla lista los campos, tipos y significados que devuelve cada fila, sin valores.

CampoTipoSignificado
video_idstringID del vídeo: en comments, el vídeo al que pertenece el comentario; en post_history, el vídeo que consultaste.
captured_at—Cuándo se registró esta instantánea de los contadores del vídeo (post_history, ISO 8601, UTC); las filas van de la más antigua a la más reciente, sin intervalo fijo.
like_countnumberMe gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0.
comment_countnumberComentarios. null significa no publicado, no 0.
share_countnumberVeces compartido. null significa no publicado, no 0.
collect_countnumberGuardados o favoritos. null significa no publicado, no 0.
platformstringIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Casos de uso

  • Dibujar la curva de interacción de una publicación

    Ordena por captured_at y dibuja like_count, comment_count, share_count y collect_count como líneas para ver dónde se concentró el crecimiento.

  • Revisar un video promocionado

    Compara like_count y collect_count en cada registro tras la publicación para ver en qué periodo se concentró la interacción.

  • Comparar la tendencia de dos publicaciones

    Lee cada publicación una vez, alinea las filas por captured_at y compara cómo creció cada una.

  • Añadir el cambio que falta en una lectura por lotes

    posts_batch da los contadores de interacción del momento de la lectura; para ver el cambio, usa este endpoint.

Plataforma abierta de Douyin frente a EveryInfra

Así se comparan la guía general de autorización de la plataforma abierta de Douyin y post_history de EveryInfra en el acceso.

AspectoPlataforma abierta de DouyinEveryInfra
Credenciales de la appLa documentación indica que el tercero envía el code, junto con ClientKey y ClientSecret, a una API para obtener un access_token.No necesitas ClientKey ni ClientSecret para obtener una credencial. La cabecera lleva tu clave de API de EveryInfra y la solicitud lleva solo url.

La documentación de la plataforma abierta de Douyin está en chino; la tabla muestra una traducción, cotejada con su guía general de autorización el 2026-11-22. La página no indica fecha de actualización. La documentación no describe las capturas históricas de las cifras de una publicación, así que aquí solo se compara el acceso. Fuentes oficiales: Guía general de autorización

Límites y detalles a tener en cuenta

  • url es obligatorio: un ID numérico de video, o un enlace de video que contenga ese ID. No se aceptan enlaces cortos ni textos de compartir.
  • Cada fila es un registro, y captured_at es la hora del registro; las filas van de la más antigua a la más reciente, y el intervalo entre registros varía.
  • Algunas publicaciones tienen muy pocos registros o ninguno.
  • Una llamada devuelve todo el conjunto de registros, sin paginación.
  • Los cuatro contadores son los valores del momento del registro.

Precios

Cada llamada cuesta $0.000792 y se factura por llamada, no por registro; una llamada devuelve todo el conjunto de registros. Las llamadas fallidas y los resultados vacíos no se cobran.

LlamadasCosto
10,000$7.92
100,000$79.17
1,000,000$791.67

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": "douyin",
  "action": "post_history",
  "params": {
    "url": "https://www.douyin.com/video/7633646113853104116"
  }
}'

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 post_history, 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 Douyin: Historial de métricas de una publicación (douyin/post_history).

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 post_history, y los parámetros dentro de params.
- Parámetros obligatorios:
  - url: El vídeo de Douyin cuyas instantáneas de «me gusta», comentarios, compartidos y guardados quieres: un ID numérico o un enlace que lo contenga, como https://www.douyin.com/video/<ID_de_vídeo>.
- Parámetros opcionales:
  - limit: Número máximo de filas que devuelve esta llamada, un entero de 1 o más. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas.
- Devuelve una lista de registros. Campos principales de cada registro: video_id (ID del vídeo: en comments, el vídeo al…), captured_at (Cuándo se registró esta instantánea de…), like_count, comment_count, share_count, collect_count.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "douyin",
  "action": "post_history",
  "params": {
    "url": "https://www.douyin.com/video/7633646113853104116"
  }
}
- Precio: $0.79 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ípost_historyIdentificador de la capacidad, valor fijo.
urlbody.paramsstringSí-El vídeo de Douyin cuyas instantáneas de «me gusta», comentarios, compartidos y guardados quieres: un ID numérico o un enlace que lo contenga, como https://www.douyin.com/video/<ID_de_vídeo>. No se aceptan enlaces cortos ni textos de compartir.
limitbody.paramsinteger (1–)No-Número máximo de filas que devuelve esta llamada, un entero de 1 o más. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas.

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.
json
{  "id": "req_…",  "platform": "douyin",  "action": "post_history",  "results": [    {      "video_id": …,      "captured_at": …,      "like_count": …,      "comment_count": …,      "share_count": …,      "collect_count": …,      "platform": …    }  ],  "count": …,  "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
video_idID del vídeo: en comments, el vídeo al que pertenece el comentario; en post_history, el vídeo que consultaste.
captured_atCuándo se registró esta instantánea de los contadores del vídeo (post_history, ISO 8601, UTC); las filas van de la más antigua a la más reciente, sin intervalo fijo.
like_countMe gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0.
comment_countComentarios. null significa no publicado, no 0.
share_countVeces compartido. null significa no publicado, no 0.
collect_countGuardados o favoritos. null significa no publicado, no 0.
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

Preguntas frecuentes

¿Qué devuelve la API de historial de publicaciones?

Las capturas registradas de la publicación, un registro por fila: video_id, captured_at, like_count, comment_count, share_count y collect_count.

¿Los registros están espaciados de forma regular?

No. Las filas van ordenadas por captured_at de la más antigua a la más reciente, los intervalos son largos o cortos, y algunas publicaciones tienen muy pocos registros o ninguno.

¿Puedo pasar un enlace corto v.douyin.com?

No. Solo acepta un ID numérico de video o un enlace de video que contenga ese ID; no se aceptan enlaces cortos ni textos de compartir.

¿Cuánto cuesta leer los registros?

Cuesta $0.000792 por llamada, o $0.79 por cada 1000 llamadas, y se factura por llamada, no por registro. 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 Douyin.

Google Analytics solo si aceptas. Privacidad