Documentación de la API para descargar videos

Guía de plataforma de la API REST de EasyDown

API para descargar contenido de Douyin

Envía una URL pública completa de Douyin al endpoint REST compartido. La respuesta conserva todos los archivos disponibles para que tu backend elija el formato adecuado.

Integra la API de Easydown para analizar enlaces públicos de Douyin y recibir videos, audios, imágenes y metadatos estructurados mediante una petición REST autenticada.

API para descargar videos de Douyin · API de medios de Douyin

Endpoint REST de producción

POST https://api.easydown.org/api/v1/parse

Formatos de URL pública compatibles

v.douyin.com/{code}douyin.com/video/{id} or /share/video/{id}douyin.com/note/{id} or /share/note/{id}douyin.com/shipin/{id}douyin.com/lvdetail/{id} or /vsdetail/{id}so.douyin.com/video/detail?aweme_id={id}douyin.com/user/{userId}?vid={id}douyin.com/...?modal_id={id}douyin.com, iesdouyin.com, or aweme.snssdk.com /aweme/v1/play?...video_id={id}*.douyinpic.com, *.douyinvod.com, or *.douyinstatic.com media URL

Ejemplo de petición real

https://so.douyin.com/video/detail?aweme_id=7642916558104300826

curl -X POST https://api.easydown.org/api/v1/parse \
  -H "Authorization: Bearer ed_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://so.douyin.com/video/detail?aweme_id=7642916558104300826"}'

Ejemplo de respuesta de la plataforma

La estructura común permanece estable; la plataforma determina qué matrices multimedia y atributos se completan.

Comportamiento de los archivos

Puede devolver video, imágenes, audio, portadas y variantes de la CDN que estén disponibles para la publicación.

{
  "status": 200,
  "data": {
    "platform": "douyin",
    "title": "Example douyin public post",
    "thumbnail": "https://cdn.example.com/thumbnail.jpg",
    "duration": 24,
    "images": [
      {
        "url": "https://cdn.example.com/content-image.jpg",
        "width": 1080,
        "height": 1350
      }
    ],
    "videos": [
      {
        "url": "https://cdn.example.com/video.mp4",
        "quality": "HD",
        "mimeType": "video/mp4",
        "width": 1080,
        "height": 1920,
        "hasAudio": true,
        "source": "direct"
      }
    ],
    "audios": [
      {
        "url": "https://cdn.example.com/audio.m4a",
        "quality": "128kbps",
        "mimeType": "audio/mp4"
      }
    ]
  },
  "msg": "success"
}

Reglas de descarga y proxy

Descarga los archivos desde tu backend con un User-Agent de navegador, Referer: https://www.douyin.com/ y la cabecera Range para archivos grandes. Vuelve a analizar la publicación si caduca una URL firmada.

Cabeceras recomendadas para el backend

User-Agent: Mozilla/5.0 Referer: https://www.douyin.com/ Range: bytes=0-

Contenido no compatible o no disponible

No admite perfiles, búsquedas, colecciones, páginas de seguimiento, directos, publicaciones privadas ni enlaces compartidos caducados.

Procesa solo contenido público que tengas derecho a utilizar. EasyDown no elude la privacidad, el DRM, el contenido eliminado ni las restricciones de acceso.

Solución de problemas de la plataforma

Comprueba que la URL corresponda a una publicación pública compatible de Douyin.

Vuelve a analizar el enlace original si el archivo devuelve 403 o 404.

No expongas el token de API ni las cookies de origen en JavaScript del navegador.

Flujo de integración REST

  1. 1

    Crea un token privado y autoriza esta plataforma en sus permisos.

  2. 2

    Envía una URL pública completa al endpoint compartido mediante POST.

  3. 3

    Selecciona los elementos necesarios de images, videos y audios y descárgalos desde tu backend.

Preguntas sobre la API de descarga

¿Qué URLs de Douyin admite la API de descarga?

Los formatos públicos compatibles incluyen v.douyin.com/{code}, douyin.com/video/{id} or /share/video/{id}, douyin.com/note/{id} or /share/note/{id}, douyin.com/shipin/{id}, douyin.com/lvdetail/{id} or /vsdetail/{id}, so.douyin.com/video/detail?aweme_id={id}, douyin.com/user/{userId}?vid={id}, douyin.com/...?modal_id={id}, douyin.com, iesdouyin.com, or aweme.snssdk.com /aweme/v1/play?...video_id={id}, *.douyinpic.com, *.douyinvod.com, or *.douyinstatic.com media URL. No admite perfiles, búsquedas, colecciones, páginas de seguimiento, directos, publicaciones privadas ni enlaces compartidos caducados.

¿Qué archivos devuelve la API de Douyin?

Puede devolver video, imágenes, audio, portadas y variantes de la CDN que estén disponibles para la publicación.

¿Cómo debe descargar mi aplicación los archivos de Douyin?

Descarga los archivos desde tu backend con un User-Agent de navegador, Referer: https://www.douyin.com/ y la cabecera Range para archivos grandes. Vuelve a analizar la publicación si caduca una URL firmada.

¿Cómo se factura una petición correcta a la API de Douyin?

Se descuenta 1 crédito solo cuando la respuesta contiene al menos una URL de imagen, video o audio. Los errores, enlaces no compatibles y resultados vacíos no consumen créditos.