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
Últimas 24 horas
Últimos 30 días
1Solicitud
POST /api/v1/social { "platform": "douyin", "action": "post_history", "params": { "url": "https://www.douyin.com/video/7633646113853104116" } }2Respuesta JSON
{ "results": [ { "video_id": string, "captured_at": …, "like_count": number, "comment_count": number }, … ] }3Filas
video_id captured_at like_count comment_count string … number number 4CSV
douyin-post_history-sample.csv video_id,captured_at,like_count,comment_count,share_count,collect_count,platform
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.
| Campo | Tipo | Significado |
|---|---|---|
| video_id | string | ID 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_count | number | Me gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0. |
| comment_count | number | Comentarios. null significa no publicado, no 0. |
| share_count | number | Veces compartido. null significa no publicado, no 0. |
| collect_count | number | Guardados o favoritos. null significa no publicado, no 0. |
| platform | string | Identificador 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_aty dibujalike_count,comment_count,share_countycollect_countcomo líneas para ver dónde se concentró el crecimiento.Revisar un video promocionado
Compara
like_countycollect_counten 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_aty compara cómo creció cada una.Añadir el cambio que falta en una lectura por lotes
posts_batchda 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.
| Aspecto | Plataforma abierta de Douyin | EveryInfra |
|---|---|---|
| Credenciales de la app | La 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
urles 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_ates 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.
| Llamadas | Costo |
|---|---|
| 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
#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.
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
#| 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í | post_history | Identificador de la capacidad, valor fijo. |
url | body.params | string | Sí | - | 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. |
limit | body.params | integer (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
#{ "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.
| Campo | Significado |
|---|---|
video_id | ID 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_count | Me gusta. null significa que la plataforma o esta capacidad no lo publica; no es 0. |
comment_count | Comentarios. null significa no publicado, no 0. |
share_count | Veces compartido. null significa no publicado, no 0. |
collect_count | Guardados o favoritos. null significa no publicado, no 0. |
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.
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.
Capacidades de Douyin relacionadas
Con la misma clave de API de EveryInfra puedes llamar a los demás endpoints de Douyin.
- Búsqueda
search$8.33 por cada 1000 llamadasBusca videos de Douyin mediantekeywordy permite escoger ventana de publicación u orden. - Detalles
profile$0.56 por cada 1000 llamadasConsulta una cuenta poruser_idy recoge Douyin ID, apodo, biografía y contadores públicos. - Publicaciones del usuario
user_posts$0.56 por cada 1000 llamadasLista los videos de una cuenta a partir de suuser_id(el secUid), con texto, tipo de medio, duración y métricas. - Detalles del video
video$0.56 por cada 1000 llamadasAbre laurlde un video de Douyin y devuelve contenido, autor, fecha y métricas visibles. - Comentarios
comments$0.56 por cada 1000 llamadasLee comentarios de laurldel video y distingue respuesta, autor, ubicación IP mostrada y reacción del creador cuando existen. - Respuestas a comentarios
comment_replies$0.56 por cada 1000 llamadasLee las respuestas bajo un comentario de primer nivel de un video de Douyin, a partir de laurldel video y elcomment_idde una fila decommentscon respuestas. - Tendencias
trending$0.56 por cada 1000 llamadasConsulta el tablero de tendencias sin entrada obligatoria y permite seleccionarboards. - Transcripción
transcript$0.56 por cada 1000 llamadasExtrae texto disponible del video indicado porurl, junto con metadatos y métricas de la pieza. - Búsqueda de creadores
creator_search$0.56 por cada 1000 llamadasBusca cuentas candidatas mediantekeywordy permite acotar por los valores declarados defollower_rangeyuser_type. - Audiencia del creador
creator_audience$0.56 por cada 1000 llamadasPara unuser_id, consulta la distribución, el TGI y el código de ladimensionelegida; si se omite, usa el rango de precio del dispositivo. - Evolución de seguidores
creator_trend$0.56 por cada 1000 llamadasConsulta para unuser_idla seriefollower_trendy el promedio de seguidores disponibles. - Comparación del creador
creator_benchmark$0.56 por cada 1000 llamadasCompara promedios y percentiles de publicaciones, comentarios, compartidos, crecimiento y me gusta para unuser_id. - Búsqueda de creadores en Xingtu
xingtu_creator_search$0.56 por cada 1000 llamadasBusca registros de creadores de Xingtu mediantekeyword. - Analítica de creador en Xingtu
xingtu_creator_analytics$0.56 por cada 1000 llamadasUsa eldouyin_idvisible devuelto por la acción ordinariacreator_searchpara consultar una ficha analítica de Xingtu;xingtu_creator_searchno proporciona este dato. - Tarifas de creador en Xingtu
xingtu_rate_card$0.56 por cada 1000 llamadasUsa eldouyin_iddevuelto porcreator_search, no la salida dexingtu_creator_search, para consultar losrate_tiersdisponibles de un creador en Xingtu. - Rankings de creadores en Xingtu
xingtu_creator_rankings$0.56 por cada 1000 llamadasSeleccionaindustry,ranking_typeytime_windowpara consultar una instantánea acotada de un ranking de Xingtu. - Búsqueda de productos
product_search$8 por cada 1000 llamadasBusca productos mediantekeyword, hasta 30 por página, y devuelve precio, ventas, tienda, comisión y creadores colaboradores. - Productos de una tienda
shop_products$8 por cada 1000 llamadasLista los productos de una tienda de Douyin Mall a partir de sushop_idnumérico, 10 por página. - Detalles del producto
product_detail$8 por cada 1000 llamadasConsulta un producto mediante unproduct_idnumérico, con galería, variantes, tienda y cifra pública de unidades vendidas. - Productos en directo
live_product_search$0.56 por cada 1000 llamadasBusca productos actualmente en directo mediantekeywordy devuelve sulive_room_idhasta el límite indicado. - Búsqueda de hashtags
hashtag_search$15.56 por cada 1000 llamadasBusca hashtags de Douyin cuyo nombre contienekeyword, ordenados por popularidad. - Detalles del hashtag
hashtag_detail$15.56 por cada 1000 llamadasConsulta un hashtag de Douyin por suhashtag_idnumérico (dehashtag_search): nombre, reproducciones totales desde su creación, usuarios que participan, fecha de creación y enlace para compartir. - Tablero de vídeos en tendencia
billboard_video_hot$0.81 por cada 1000 llamadasLee el tablero de vídeos de Hot Spot Treasure, la herramienta de tendencias del propio Douyin: general (all), de mayor captación de seguidores o de mayor tasa de «me gusta», en la última hora, día, 3 días o 7 días. - Éxitos de cuentas pequeñas
billboard_low_fan_explosion$0.81 por cada 1000 llamadasDetecta obras de cuentas con pocos seguidores que se dispararon en Douyin, según el tablero de éxitos de cuentas pequeñas. - Tablero de visionado completo
billboard_high_completion$0.81 por cada 1000 llamadasMuestra qué obras de Douyin ven los usuarios hasta el final, a partir del tablero de alta tasa de visionado completo. - Tablero de búsquedas en alza
billboard_search_hot$0.81 por cada 1000 llamadasDescubre qué términos suben en el buscador de Douyin. - Búsqueda de cuentas en Hot Spot Treasure
billboard_account_search$0.81 por cada 1000 llamadasEncuentra cuentas de Douyin relacionadas con unakeywordobligatoria, con seguidores, «me gusta» recibidos y número de vídeos. - Búsqueda de música
music_search$8 por cada 1000 llamadasBusca en la biblioteca musical de Douyin por título, artista o nombre del sonido. - Sugerencias del buscador
search_suggest$8 por cada 1000 llamadasObtén las sugerencias que el cuadro de búsqueda de Douyin muestra al escribir unakeyword, en el orden de Douyin y conrankdesde 1. - Temas en ascenso
billboard_rise_list$0.81 por cada 1000 llamadasDetecta los temas que más rápido suben en Douyin, a partir del tablero de ascenso de Hot Spot Treasure. - Tablero de retos
billboard_challenge_hot$0.81 por cada 1000 llamadasLee de una vez el tablero de retos de Hot Spot Treasure: los 50 temas completos. - Hashtags en alza
billboard_topic_hot$0.81 por cada 1000 llamadasMira qué hashtags de Douyin se están calentando en la última hora, día, 3 días o 7 días. - Detalles de la música
music_detail$0.81 por cada 1000 llamadasConsulta una pista de Douyin con elmusic_idnumérico demusic_searcho un enlace douyin.com/music. - Capacidad de conversión en Xingtu
xingtu_conversion_ability$1.6 por cada 1000 llamadasConsulta 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 defecto30d): vídeos relacionados, mediana de reproducciones, clics en el componente y su tasa, CPC, GPM, ventas medias, productos promocionados y sus categorías. - Usuarios conectados por nivel en Xingtu
xingtu_link_structure$16 por cada 1000 llamadasConsulta cuántos usuarios cuenta Xingtu como conectados a un creador de Douyin, repartidos en los cuatro niveles de Xingtu, con su número, su proporción del total y la mediana de los creadores del mismo sector. - Vídeos recomendados en Xingtu
xingtu_recommended_videos$1.6 por cada 1000 llamadasLista los cuatro grupos de vídeos de la página de Xingtu de un creador: vídeos representativos, últimos vídeos, vídeos de pedidos de Xingtu más reproducidos y vídeos personales más reproducidos. - Origen de usuarios conectados en Xingtu
xingtu_touch_distribution$16 por cada 1000 llamadasConsulta de qué categorías de contenido proceden los usuarios conectados de un creador según Xingtu: un árbol de hasta tres niveles, normalmente contenido personal frente a contenido de Xingtu y luego categoría y subcategoría, cada nodo con su recuento. - Rendimiento de vídeos en Xingtu
xingtu_video_performance$16 por cada 1000 llamadasCompara los vídeos personales y los vídeos de pedidos de Xingtu de un creador en tasa de interacción, mediana de reproducciones y tasa de finalización. - Publicaciones en lote
posts_batch$0.56 por cada 1000 llamadasConsulta hasta 20 vídeos de Douyin a la vez conurls, cada uno como ID numérico, enlacehttps://www.douyin.com/video/<ID_de_vídeo>, enlace cortov.douyin.como texto completo de compartir que incluya un enlace corto. - Perfiles en lote
profiles_batch$0.56 por cada 1000 llamadasConsulta hasta 20 cuentas de Douyin a la vez conurls, cada una comosecUid(empieza porMS4w) o enlace de perfilhttps://www.douyin.com/user/<secUid>. - Enlaces de descarga de medios
media_links$0.56 por cada 1000 llamadasObtén enlaces de descarga de hasta 20 vídeos de Douyin a la vez conurls, cada uno como ID numérico o enlacehttps://www.douyin.com/video/<ID_de_vídeo>; no se aceptan enlaces cortos ni textos de compartir. - Publicaciones relacionadas
related_posts$0.56 por cada 1000 llamadasLista los vídeos que Douyin recomienda junto a un vídeo, a partir de suurl: ID numérico, enlacehttps://www.douyin.com/video/<ID_de_vídeo>, enlace cortov.douyin.como texto completo de compartir. - Publicaciones que usan una pista
music_posts$0.79 por cada 1000 llamadasLista los vídeos que usan una pista de Douyin, a partir de sumusic_id(tomado delmusic.idde un vídeo o demusic_detail; también vale un enlace douyin.com/music). - Reconocimiento de enlaces
resolve_links$0.79 por cada 1000 llamadasEncuentra enlaces e IDs de Douyin dentro de un texto, por ejemplo un texto completo de compartir. - Historial de tendencias
trending_history$0.79 por cada 1000 llamadasConsulta cómo se movieron los términos en tendencia de Douyin durante las últimas horas. - Colecciones de una cuenta
user_mixes$0.79 por cada 1000 llamadasLista las colecciones (mixes) que ha publicado una cuenta de Douyin, a partir de susecUidenuser_id(una cadenaMS4w) o de un enlacehttps://www.douyin.com/user/<secUid>. - Publicaciones de una colección
mix_posts$0.79 por cada 1000 llamadasLista los vídeos de una colección de Douyin a partir de sumix_id(tomado deuser_mixes; también vale un enlacehttps://www.douyin.com/collection/<ID>). - Resumen de una cuenta
user_overview$1.6 por cada 1000 llamadasObtén un resumen de una cuenta de Douyin a partir de susecUidenuser_id(una cadenaMS4w) o de un enlacehttps://www.douyin.com/user/<secUid>; no se aceptan apodos, Douyin ID ni enlaces cortos. - Sala en directo
live_room$0.79 por cada 1000 llamadasConsulta una sala en directo de Douyin a partir de suroom_idnumérico, el número dehttps://live.douyin.com/<room_id>. - Flujo de publicaciones
feed$0.56 por cada 1000 llamadasLista los vídeos que Douyin recomienda en su página de inicio o en un canal. - Canal de microdramas
series_feed$0.56 por cada 1000 llamadasLista los microdramas del canal de microdramas de Douyin, 16 por página. - Episodios de un microdrama
series_posts$0.79 por cada 1000 llamadasLista los episodios de un microdrama de Douyin a partir de suseries_id, por orden de episodio, hasta 20 por página. - Microdramas de una cuenta
user_series$0.79 por cada 1000 llamadasLista los microdramas que ha publicado una cuenta de Douyin, a partir de susecUidenuser_id(una cadenaMS4w) o de un enlacehttps://www.douyin.com/user/<secUid>, hasta 20 por página. - Comentarios superpuestos en el video
danmaku$0.56 por cada 1000 llamadasLee los comentarios superpuestos (danmaku) de un vídeo de Douyin a partir de suurl: un ID numérico, un enlacehttps://www.douyin.com/video/<ID_de_vídeo>, un enlace cortov.douyin.como un texto completo de compartir que incluya un enlace corto. - Clasificación de espectadores
live_viewers$0.56 por cada 1000 llamadasLee la clasificación de espectadores de una emisión de Douyin a partir de sulive_id: hasta 200 espectadores en una respuesta, cada uno conrank,user_id,douyin_id,nickname,avatar_url,is_verifiedyurl. - Detalles de un microdrama
series_detail$0.79 por cada 1000 llamadasConsulta un microdrama de Douyin a partir de suseries_idnumérico (deseries_feedouser_series; también vale un enlace para compartir). - Detalles de una colección
mix_detail$0.56 por cada 1000 llamadasConsulta una colección (mix) de Douyin a partir de sumix_idnumérico (deuser_mixes; también vale un enlacehttps://www.douyin.com/collection/<ID>). - Detalles de una emisión
live_session$0.79 por cada 1000 llamadasConsulta una emisión de Douyin a partir de sulive_id(de las filas delive_roomouser_live; cambia en cada directo y no es el número del enlace de la sala). - Estado de directo del usuario
user_live$0.79 por cada 1000 llamadasComprueba si un anfitrión de Douyin está en directo ahora, a partir de susecUidenuser_id(una cadenaMS4w) o de un enlacehttps://www.douyin.com/user/<secUid>. - Perfil por ID numérico
profile_by_id$0.56 por cada 1000 llamadasBusca una cuenta de Douyin por suuidnumérico: elauthor_uidde las filas de vídeos y comentarios, o eluiddeprofile.