Documentación de la API para descargar videos

Guía de plataforma de la API REST de EasyDown

API para descargar contenido de Twitter / X

Envía una URL pública completa de Twitter / X 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 Twitter / X y recibir videos, audios, imágenes y metadatos estructurados mediante una petición REST autenticada.

API para descargar videos de Twitter / X · API de medios de Twitter / X

Endpoint REST de producción

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

Formatos de URL pública compatibles

x.com/{user}/status/{id}twitter.com/{user}/status/{id}x.com/i/status/{id}

Ejemplo de petición real

https://x.com/Taozhishuishui/status/2041638397358260556/video/1

curl -X POST https://api.easydown.org/api/v1/parse \
  -H "Authorization: Bearer ed_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://x.com/Taozhishuishui/status/2041638397358260556/video/1"}'

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

Muestra las variantes de video accesibles desde la publicación pública, con la calidad indicada cuando está disponible.

{
  "status": 200,
  "data": {
    "platform": "twitter",
    "title": "Example twitter 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": []
  },
  "msg": "success"
}

Reglas de descarga y proxy

Descarga los archivos desde tu backend con un User-Agent de navegador, Referer: https://x.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://x.com/ Range: bytes=0-

Contenido no compatible o no disponible

No admite perfiles, búsquedas, Spaces, publicaciones privadas o eliminadas ni enlaces directos de la CDN multimedia.

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 Twitter / X.

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 Twitter / X admite la API de descarga?

Los formatos públicos compatibles incluyen x.com/{user}/status/{id}, twitter.com/{user}/status/{id}, x.com/i/status/{id}. No admite perfiles, búsquedas, Spaces, publicaciones privadas o eliminadas ni enlaces directos de la CDN multimedia.

¿Qué archivos devuelve la API de Twitter / X?

Muestra las variantes de video accesibles desde la publicación pública, con la calidad indicada cuando está disponible.

¿Cómo debe descargar mi aplicación los archivos de Twitter / X?

Descarga los archivos desde tu backend con un User-Agent de navegador, Referer: https://x.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 Twitter / X?

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.