API de Enlaces de descarga de medios de Douyin

Obtén los enlaces de descarga de video de varias publicaciones de Douyin de una vez con urls, junto con las portadas y los request_headers que debes enviar al descargar. Cada elemento de urls es una llamada, a $0.56 por cada 1000 llamadas.

  • Los enlaces van firmados y caducan; la hora de caducidad está en expires_at.
  • Con fresh en true se omite la caché y los enlaces se obtienen de nuevo en el momento.
  • 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": "media_links",
      "params": {
        "urls": [
          "https://www.douyin.com/video/<VIDEO_ID_A>"
        ]
      }
    }
  2. 2Respuesta JSON

    {
      "results": [
        {
          "media_type": string,
          "video_url": string,
          "video_url_expires_at": string,
          "video_width": number
        },
        …
      ]
    }
  3. 3Filas

    media_typevideo_urlvideo_url_expires_atvideo_width
    stringstringstringnumber
  4. 4CSV

    douyin-media_links-sample.csv id,url,media_type,video_url,video_url_expires_at,video_width,video_height,video_size_bytes,has_watermark,best_stream,stream_count,cover_image_url,covers,image_urls,audio_url,request_headers,expires_at,fetched_at,platform,input

Entra una solicitud con urls y sale una fila por publicación con video_url, best_stream y request_headers, que se muestran como tabla de campos y se pueden 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
idstringIdentificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
urlstringEnlace al registro en la plataforma.
media_typestringTipo de medio: video, o image en las publicaciones de imágenes.
video_urlstringURL de reproducción del vídeo (firmada y con caducidad; descárgala pronto si necesitas conservarla). Null para notas de imágenes o si la fuente no la trae.
video_url_expires_atstringConserva el significado de la plataforma
video_widthnumberAncho del vídeo en píxeles.
video_heightnumberAlto del vídeo en píxeles.
video_size_bytes—Tamaño del archivo de vídeo en bytes (media_links).
has_watermarkbooleanConserva el significado de la plataforma
best_stream—La secuencia de vídeo de mayor tasa de bits (media_links): {url, bitrate (bps), width, height, size_bytes, expires_at}.
stream_count—Cuántas secuencias de vídeo de distinta calidad tiene el vídeo (media_links).
cover_image_urlstringURL de la imagen de portada: la portada de un vídeo o nota en las filas de search, user_posts, posts_batch, related_posts, mix_posts, music_posts y media_links; la portada de la música en music_search y music_detail; la imagen del tema en billboard_topic_hot; la portada de la colección en user_mixes; la portada de la sala en live_room. Los enlaces firmados caducan.
covers—Imágenes de portada (media_links): [{url, width, height, expires_at}]; la primera es la misma que cover_image_url.
image_urls—Lista de enlaces de imagen en el orden en que los muestra la plataforma; no aparece si no hay imágenes.
audio_urlstringEnlace de audio: la pista de audio del vídeo en transcript (mp3) y la reproducción de la pista en music_search y music_detail, y la música de fondo del vídeo en media_links; puede caducar.
request_headers—Cabeceras que debes enviar al descargar los enlaces (media_links), por ejemplo {"Referer": "https://www.douyin.com/"}. Sin ellas la descarga puede ser rechazada.
expires_at—Cuándo deja de funcionar el primer enlace que caduca de la fila (media_links, ISO 8601, UTC). Pasado ese momento, vuelve a pedir los enlaces con fresh=true.
fetched_at—Cuándo se obtuvieron los enlaces (media_links, ISO 8601, UTC); sin fresh pueden venir de una caché.
platformstringIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).
input—La entrada de urls a la que responde esta fila, devuelta tal como la enviaste (posts_batch, profiles_batch, media_links). Úsala para emparejar cada fila con tu entrada.

Casos de uso

  • Obtener direcciones de descarga en bloque

    Pon en urls un conjunto de IDs o enlaces de video y lee video_url de cada fila para descargar.

  • Elegir el flujo de mayor tasa de bits

    Lee best_stream; contiene la dirección, la tasa de bits, el tamaño en píxeles y el tamaño del archivo del flujo con mayor tasa de bits.

  • Enviar las cabeceras correctas al descargar

    Envía sin cambios las cabeceras de request_headers (por ejemplo Referer); una descarga sin ellas puede rechazarse.

  • Volver a pedir tras la caducidad

    Cuando haya pasado expires_at, solicita de nuevo con fresh en true para obtener un conjunto nuevo de enlaces.

Plataforma abierta de Douyin frente a EveryInfra

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

AspectoPlataforma abierta de DouyinEveryInfra
Canales de autorizaciónLa documentación indica que la plataforma abierta de Douyin ofrece la autorización por cuatro canales: WEB, Android, iOS y JS.No integras ningún SDK de autorización de Douyin ni JSSDK. Envía una solicitud HTTPS normal con tu clave de API de EveryInfra en la cabecera y pon las publicaciones en urls.

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 los enlaces de descarga de publicaciones, así que aquí solo se compara el acceso. Fuentes oficiales: Guía general de autorización

Límites y detalles a tener en cuenta

  • urls es un arreglo; la referencia de parámetros indica cuántos elementos admite una llamada; el mismo elemento solo puede aparecer una vez.
  • Cada elemento debe ser un ID numérico de video, o un enlace de video que contenga ese ID; no se aceptan enlaces cortos ni textos de compartir.
  • Se factura por elemento, una llamada cada uno; los elementos que no se pudieron leer no se cobran y aparecen en missed de la respuesta.
  • Los enlaces van firmados y caducan; expires_at es la hora del enlace que caduca antes en esa fila.
  • has_watermark es true cuando el archivo de video lleva marca de agua.
  • Sin fresh, los enlaces pueden venir de la caché; la hora en que se obtuvieron está en fetched_at.
  • Solo admite llamadas síncronas.

Precios

Cada elemento de urls cuenta como una llamada de $0.000556, así que pagas por el número de elementos y no por campo; los elementos que no se pudieron leer no se cobran. Las llamadas fallidas y los resultados vacíos no se cobran.

LlamadasCosto
10,000$5.56
100,000$55.56
1,000,000$555.56

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": "media_links",
  "params": {
    "urls": [
      "https://www.douyin.com/video/<VIDEO_ID_A>"
    ]
  }
}'

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 media_links, 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: Enlaces de descarga de medios (douyin/media_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 media_links, y los parámetros dentro de params.
- Parámetros obligatorios:
  - urls: Los vídeos de los que quieres enlaces de descarga, en una lista de hasta 20 entradas; cada entrada solo puede aparecer una vez.
- Parámetros opcionales:
  - fresh: En media_links: con true se omiten los enlaces en caché y se obtienen de nuevo; por defecto false. Los enlaces van firmados y caducan; expires_at indica cuándo.
  - 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: id, url, media_type (Tipo de medio: video, o image en las pu…), video_url (URL de reproducción del vídeo (firmada…), video_url_expires_at, video_width (Ancho del vídeo en píxeles), video_height (Alto del vídeo en píxeles), video_size_bytes (Tamaño del archivo de vídeo en bytes (m…), has_watermark, best_stream (La secuencia de vídeo de mayor tasa de…), stream_count (Cuántas secuencias de vídeo de distinta…), cover_image_url (URL de la imagen de portada: la portada…); 19 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "douyin",
  "action": "media_links",
  "params": {
    "urls": [
      "https://www.douyin.com/video/<VIDEO_ID_A>"
    ]
  }
}
- Precio: $0.56 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Este endpoint solo funciona en modo síncrono; no añadas "mode": "async" al cuerpo.
- 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ímedia_linksIdentificador de la capacidad, valor fijo.
urlsbody.paramsarraySí-Los vídeos de los que quieres enlaces de descarga, en una lista de hasta 20 entradas; cada entrada solo puede aparecer una vez. Cada entrada es un ID numérico de vídeo o un enlace https://www.douyin.com/video/<ID_de_vídeo>; no se aceptan enlaces cortos ni textos de compartir. Se cobra por vídeo; los que no se encuentran no se cobran. Las filas llevan input, la entrada que enviaste.
freshbody.paramsbooleanNo-En media_links: con true se omiten los enlaces en caché y se obtienen de nuevo; por defecto false. Los enlaces van firmados y caducan; expires_at indica cuándo.
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": "media_links",  "results": [    {      "id": …,      "url": …,      "media_type": …,      "video_url": …,      "video_url_expires_at": …,      "video_width": …,      "video_height": …,      "video_size_bytes": …,      "has_watermark": …,      "best_stream": …,      "stream_count": …,      "cover_image_url": …,      "covers": …,      "image_urls": …,      "audio_url": …,      "request_headers": …,      "expires_at": …,      "fetched_at": …,      "platform": …,      "input": …    }  ],  "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
idIdentificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
urlEnlace al registro en la plataforma.
media_typeTipo de medio: video, o image en las publicaciones de imágenes.
video_urlURL de reproducción del vídeo (firmada y con caducidad; descárgala pronto si necesitas conservarla). Null para notas de imágenes o si la fuente no la trae.
video_url_expires_atConserva el significado de la plataforma
video_widthAncho del vídeo en píxeles.
video_heightAlto del vídeo en píxeles.
video_size_bytesTamaño del archivo de vídeo en bytes (media_links).
has_watermarkConserva el significado de la plataforma
best_streamLa secuencia de vídeo de mayor tasa de bits (media_links): {url, bitrate (bps), width, height, size_bytes, expires_at}.
stream_countCuántas secuencias de vídeo de distinta calidad tiene el vídeo (media_links).
cover_image_urlURL de la imagen de portada: la portada de un vídeo o nota en las filas de search, user_posts, posts_batch, related_posts, mix_posts, music_posts y media_links; la portada de la música en music_search y music_detail; la imagen del tema en billboard_topic_hot; la portada de la colección en user_mixes; la portada de la sala en live_room. Los enlaces firmados caducan.
coversImágenes de portada (media_links): [{url, width, height, expires_at}]; la primera es la misma que cover_image_url.
image_urlsLista de enlaces de imagen en el orden en que los muestra la plataforma; no aparece si no hay imágenes.
audio_urlEnlace de audio: la pista de audio del vídeo en transcript (mp3) y la reproducción de la pista en music_search y music_detail, y la música de fondo del vídeo en media_links; puede caducar.
request_headersCabeceras que debes enviar al descargar los enlaces (media_links), por ejemplo {"Referer": "https://www.douyin.com/"}. Sin ellas la descarga puede ser rechazada.
expires_atCuándo deja de funcionar el primer enlace que caduca de la fila (media_links, ISO 8601, UTC). Pasado ese momento, vuelve a pedir los enlaces con fresh=true.
fetched_atCuándo se obtuvieron los enlaces (media_links, ISO 8601, UTC); sin fresh pueden venir de una caché.
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).
inputLa entrada de urls a la que responde esta fila, devuelta tal como la enviaste (posts_batch, profiles_batch, media_links). Úsala para emparejar cada fila con tu entrada.

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 enlaces de descarga de Douyin?

Una fila por cada publicación leída: id, url, media_type, video_url, video_size_bytes, has_watermark, best_stream, stream_count, cover_image_url, covers, audio_url, request_headers, expires_at y fetched_at, además de input.

¿Qué hago cuando caduca un enlace?

Mira expires_at. Pasada esa hora, solicita de nuevo con fresh en true; la llamada obtiene enlaces nuevos en el momento.

¿Y si la descarga se rechaza?

Envía los request_headers de esa fila, por ejemplo Referer. Una descarga sin ellos puede rechazarse.

¿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. Con un enlace corto o un texto de compartir, pásalo antes a posts_batch (acepta ambos) y usa el id de la fila devuelta.

¿Cómo se facturan los enlaces de descarga?

Cada elemento de urls es una llamada de $0.000556, o $0.56 por cada 1000 llamadas. 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