API de Historial de tendencias de Douyin
Consulta cómo les fue a las frases en tendencia en un periodo pasado: first_seen_at, last_seen_at, best_rank, peak_hot_value e is_on_board. hours fija cuánto mirar atrás, por $0.79 por cada 1000 llamadas.
boardadmite el tablero hotspot, entertainment, social o challenge.hoursmira entre 1 y 168 horas atrás, y el valor por defecto es 24.- 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": "trending_history", "params": {} }2Respuesta JSON
{ "results": [ { "keyword": string, "board": string, "first_seen_at": …, "last_seen_at": … }, … ] }3Filas
keyword board first_seen_at last_seen_at string string … … 4CSV
douyin-trending_history-sample.csv keyword,board,first_seen_at,last_seen_at,snapshot_count,best_rank,peak_hot_value,is_on_board,platform
board y hours opcionales, y salen las frases que estuvieron en el tablero en ese periodo; cada fila de results es una frase, 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 |
|---|---|---|
| keyword | string | Palabra clave: la frase en tendencia en trending y trending_history, el término de búsqueda en billboard_search_hot y la búsqueda sugerida en search_suggest. |
| board | string | Tablero al que pertenece la entrada: hotspot, entertainment, social, challenge o seeding. |
| first_seen_at | — | Cuándo se registró por primera vez el término en el tablero dentro de la ventana (trending_history, ISO 8601, UTC). |
| last_seen_at | — | Cuándo se registró por última vez el término en el tablero dentro de la ventana (trending_history, ISO 8601, UTC). |
| snapshot_count | — | Cuántas veces se registró el término en el tablero dentro de la ventana (trending_history); el tablero se registra cada diez minutos aproximadamente. |
| best_rank | — | Mejor posición que alcanzó el término en la ventana (trending_history); 1 es la más alta. No aparece en los términos fijados que no tienen posición. |
| peak_hot_value | — | Valor de calor más alto que alcanzó el término en la ventana (trending_history), con la misma escala que hot_value en trending. |
| is_on_board | — | Si el término seguía en el tablero en la última instantánea (trending_history). |
| platform | string | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
Casos de uso
Encontrar las frases que estuvieron en el tablero ayer
Pon
hoursen 24 y leefirst_seen_atylast_seen_atpara ver qué frases estuvieron solo un rato en el tablero.Separar los temas que ya salieron
Una frase con
is_on_boarden false ya no estaba en el tablero en el último registro. Compárala con las que siguen en él.Ordenar los temas por su pico
Ordena por
peak_hot_valuede mayor a menor y mira despuésbest_rankpara encontrar las frases más calientes del periodo.Estimar cuánto duró un tema
snapshot_countes cuántas veces se registró la frase en el tablero. Los registros llegan más o menos cada 10 minutos, así que multiplica para estimar el tiempo en el tablero.
Límites y detalles a tener en cuenta
boardadmitehotspot(por defecto),entertainment,socialochallenge. No admiteseeding.hoursadmite de 1 a 168, y el valor por defecto es 24.snapshot_countcuenta cuántas veces se registró la frase en el tablero durante el periodo, aproximadamente un registro cada 10 minutos.- En
best_rank, 1 es lo más alto. Una frase fijada sin posición no trae esta clave. first_seen_atylast_seen_atson horas ISO 8601 en UTC.
Precios
Pagas $0.000792 por llamada, no por frase. 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": "trending_history",
"params": {}
}'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 trending_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 tendencias (douyin/trending_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 trending_history, y los parámetros dentro de params.
- No hay parámetros obligatorios.
- Parámetros opcionales:
- board: Tablero que se lee: hotspot (por defecto), entertainment, social o challenge. (valores admitidos: challenge / entertainment / hotspot / social)
- hours: En trending_history: cuántas horas mirar atrás, de 1 a 168 (24 por defecto).
- 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: keyword (Palabra clave: la frase en tendencia en…), board (Tablero al que pertenece la entrada: ho…), first_seen_at (Cuándo se registró por primera vez el t…), last_seen_at (Cuándo se registró por última vez el té…), snapshot_count (Cuántas veces se registró el término en…), best_rank (Mejor posición que alcanzó el término e…), peak_hot_value (Valor de calor más alto que alcanzó el…), is_on_board (Si el término seguía en el tablero en l…).
- Cuerpo de solicitud de ejemplo:
{
"platform": "douyin",
"action": "trending_history",
"params": {}
}
- 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í | trending_history | Identificador de la capacidad, valor fijo. |
board | body.params | string (enum) | No | - | Tablero que se lee: hotspot (por defecto), entertainment, social o challenge.Valores permitidoschallengeentertainmenthotspotsocial |
hours | body.params | integer | No | - | En trending_history: cuántas horas mirar atrás, de 1 a 168 (24 por defecto). |
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": "trending_history", "results": [ { "keyword": …, "board": …, "first_seen_at": …, "last_seen_at": …, "snapshot_count": …, "best_rank": …, "peak_hot_value": …, "is_on_board": …, "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 |
|---|---|
keyword | Palabra clave: la frase en tendencia en trending y trending_history, el término de búsqueda en billboard_search_hot y la búsqueda sugerida en search_suggest. |
board | Tablero al que pertenece la entrada: hotspot, entertainment, social, challenge o seeding. |
first_seen_at | Cuándo se registró por primera vez el término en el tablero dentro de la ventana (trending_history, ISO 8601, UTC). |
last_seen_at | Cuándo se registró por última vez el término en el tablero dentro de la ventana (trending_history, ISO 8601, UTC). |
snapshot_count | Cuántas veces se registró el término en el tablero dentro de la ventana (trending_history); el tablero se registra cada diez minutos aproximadamente. |
best_rank | Mejor posición que alcanzó el término en la ventana (trending_history); 1 es la más alta. No aparece en los términos fijados que no tienen posición. |
peak_hot_value | Valor de calor más alto que alcanzó el término en la ventana (trending_history), con la misma escala que hot_value en trending. |
is_on_board | Si el término seguía en el tablero en la última instantánea (trending_history). |
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 tendencias?
Una fila por frase: keyword, board, first_seen_at, last_seen_at, snapshot_count, best_rank, peak_hot_value e is_on_board.
¿En qué se diferencia de trending?
trending lee el tablero en el momento de la llamada, y cada fila es la posición actual de una frase. trending_history lee las frases que estuvieron en un tablero durante un periodo, y cada fila resume una frase: primera vez en el tablero, última vez, mejor posición y pico de popularidad.
¿Cuánto cuesta una llamada?
Cuesta $0.000792 por llamada, o $0.79 por cada 1000 llamadas, y se factura por llamada, no por frase. 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. - Historial de métricas de una publicación
post_history$0.79 por cada 1000 llamadasLee el historial guardado delike_count,comment_count,share_countycollect_countde un vídeo de Douyin. - 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. - 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.