API de Reconocimiento de enlaces de Douyin
Pasa un texto (un texto de compartir completo, por ejemplo) como text y encuentra dentro los enlaces e IDs de videos, usuarios, música, colecciones y salas en vivo de Douyin; cada uno encontrado es una fila, por $0.79 por cada 1000 llamadas.
resource_typeindica de qué tipo es, yresource_idpuede ir directo al endpoint correspondiente.needs_expansiones true para un enlace corto que aún no se ha expandido.- 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": "resolve_links", "params": { "text": "https://www.douyin.com/video/7539330955225484584" } }2Respuesta JSON
{ "results": [ { "matched_text": …, "match_type": …, "resource_type": …, "resource_id": … }, … ] }3Filas
matched_text match_type resource_type resource_id … … … … 4CSV
douyin-resolve_links-sample.csv matched_text,match_type,resource_type,resource_id,handle,url,needs_expansion,id_created_at,platform
text y sale cada enlace o ID encontrado; cada fila de results es uno, 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 |
|---|---|---|
| matched_text | — | El fragmento exacto del texto que coincidió (resolve_links). |
| match_type | — | Cómo aparece la coincidencia en el texto (resolve_links): link para un enlace, id para un ID suelto, etc. |
| resource_type | — | Qué es lo reconocido (resolve_links): video, user, music, mix para una colección, live para una sala en directo, y otros. |
| resource_id | — | ID del elemento reconocido (resolve_links): ID de vídeo, secUid, ID de música, etc., listo para enviarlo a la acción correspondiente. |
| handle | — | El Douyin ID o el nombre cuando la coincidencia es un usuario (resolve_links); no aparece en los demás casos. |
| url | string | Enlace al registro en la plataforma. |
| needs_expansion | — | Si la coincidencia es un enlace corto que hay que expandir para saber a qué apunta (resolve_links); en true, resource_id puede venir vacío. |
| id_created_at | — | Fecha de creación que se lee en el propio ID (resolve_links, ISO 8601, UTC): el ID de un vídeo de Douyin lleva dentro su fecha de publicación. |
| platform | string | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
Casos de uso
Sacar el ID del video de un texto de compartir
Pasa el texto de compartir completo como
texty lee la fila cuyoresource_typees video; suresource_ides el ID del video.Encontrar al autor y leer su perfil
Cuando el texto contiene un enlace de perfil de usuario, la fila cuyo
resource_typees user da el secUid, que puedes pasar aprofiles_batcho aprofile.Clasificar un montón de enlaces por tipo
Usa
resource_type(video, usuario, música, colección, sala en vivo, etc.) para enviar cada elemento reconocido al endpoint correspondiente.Calcular cuándo se publicó un video
Lee
id_created_at, la fecha de creación calculada a partir del propio ID del video.
Límites y detalles a tener en cuenta
textes obligatorio y es un texto, por ejemplo un texto de compartir completo.- Cada elemento encontrado es una fila;
match_typeindica si se encontró como enlace (link) o como ID simple (id), etc. needs_expansiones true para un enlace corto que aún hay que expandir para saber a qué apunta; entoncesresource_idpuede estar vacío.handleexiste solo cuando el elemento encontrado es un usuario, y es el ID de Douyin o el nombre.id_created_ates la fecha de creación calculada a partir del propio ID; el ID de un video de Douyin lleva dentro su hora de publicación.
Precios
Cada llamada cuesta $0.000792 y se factura por llamada, no por fila encontrada; una llamada procesa un texto. 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": "resolve_links",
"params": {
"text": "https://www.douyin.com/video/7539330955225484584"
}
}'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 resolve_links, 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: Reconocimiento de enlaces (douyin/resolve_links).
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 resolve_links, y los parámetros dentro de params.
- Parámetros obligatorios:
- text: Un texto, por ejemplo un texto completo de compartir, en el que resolve_links busca enlaces e IDs de vídeo, usuario, música, colección y sala en directo de Douyin.
- 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: matched_text (El fragmento exacto del texto que coinc…), match_type (Cómo aparece la coincidencia en el text…), resource_type (Qué es lo reconocido (resolve_links): v…), resource_id (ID del elemento reconocido (resolve_lin…), handle (El Douyin ID o el nombre cuando la coin…), url, needs_expansion (Si la coincidencia es un enlace corto q…), id_created_at (Fecha de creación que se lee en el prop…).
- Cuerpo de solicitud de ejemplo:
{
"platform": "douyin",
"action": "resolve_links",
"params": {
"text": "https://www.douyin.com/video/7539330955225484584"
}
}
- 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í | resolve_links | Identificador de la capacidad, valor fijo. |
text | body.params | string | Sí | - | Un texto, por ejemplo un texto completo de compartir, en el que resolve_links busca enlaces e IDs de vídeo, usuario, música, colección y sala en directo de Douyin. |
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": "resolve_links", "results": [ { "matched_text": …, "match_type": …, "resource_type": …, "resource_id": …, "handle": …, "url": …, "needs_expansion": …, "id_created_at": …, "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 |
|---|---|
matched_text | El fragmento exacto del texto que coincidió (resolve_links). |
match_type | Cómo aparece la coincidencia en el texto (resolve_links): link para un enlace, id para un ID suelto, etc. |
resource_type | Qué es lo reconocido (resolve_links): video, user, music, mix para una colección, live para una sala en directo, y otros. |
resource_id | ID del elemento reconocido (resolve_links): ID de vídeo, secUid, ID de música, etc., listo para enviarlo a la acción correspondiente. |
handle | El Douyin ID o el nombre cuando la coincidencia es un usuario (resolve_links); no aparece en los demás casos. |
url | Enlace al registro en la plataforma. |
needs_expansion | Si la coincidencia es un enlace corto que hay que expandir para saber a qué apunta (resolve_links); en true, resource_id puede venir vacío. |
id_created_at | Fecha de creación que se lee en el propio ID (resolve_links, ISO 8601, UTC): el ID de un vídeo de Douyin lleva dentro su fecha de publicación. |
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 reconocimiento de enlaces?
Una fila por cada enlace o ID encontrado en el texto: matched_text, match_type, resource_type, resource_id, handle, url, needs_expansion e id_created_at.
¿Qué significa que needs_expansion sea true?
El elemento encontrado es un enlace corto que aún hay que expandir para saber a qué apunta; entonces resource_id puede estar vacío.
¿Y si el texto contiene varios enlaces?
Cada elemento encontrado es una fila; distínguelos con resource_type y resource_id.
¿Cuánto cuesta reconocer un texto?
Cuesta $0.000792 por llamada, o $0.79 por cada 1000 llamadas, y se factura por llamada, no por fila encontrada. 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). - 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.