Autenticación con Bearer token
Envía un token privado ed_live desde tu backend. No lo expongas en JavaScript del navegador ni en repositorios públicos.
Authorization: Bearer ed_live_xxxAPI REST de EasyDown
Documentación de la API para descargar videos
Convierte la URL pública de una publicación en una respuesta normalizada con todas las imágenes, videos, audios, miniaturas, duraciones y calidades disponibles.
Endpoint de producción
POST https://api.easydown.org/api/v1/parseUn formato de petición
curl -X POST https://api.easydown.org/api/v1/parse \
+ -H "Authorization: Bearer ed_live_xxx" \
+ -H "Content-Type: application/json" \
+ -d '{"url":"https://www.instagram.com/reel/EXAMPLE/"}'Guías de API por plataforma
Cada guía documenta las familias de URL reales, la respuesta multimedia, los requisitos de proxy, el contenido no compatible y los errores propios de la plataforma.
YouTube
API para descargar contenido de YouTube
TikTok
API para descargar contenido de TikTok
API para descargar contenido de Instagram
Twitter / X
API para descargar contenido de Twitter / X
Threads
API para descargar contenido de Threads
Bilibili
API para descargar contenido de Bilibili
Xiaohongshu / RedNote
API para descargar contenido de Xiaohongshu / RedNote
Douyin
API para descargar contenido de Douyin
Kuaishou / Kwai
API para descargar contenido de Kuaishou / Kwai
API para descargar contenido de Weibo
Toutiao
API para descargar contenido de Toutiao
Estructura de respuesta unificada
Todas las plataformas comparten status, data y msg. Una respuesta puede incluir images, videos y audios a la vez; procesa las matrices completas.
{
"status": 200,
"data": {
"platform": "instagram",
"title": "Example public post",
"thumbnail": "https://cdn.example.com/cover.jpg",
"duration": 18,
"images": [],
"videos": [
{
"url": "https://cdn.example.com/video.mp4",
"quality": "HD",
"mimeType": "video/mp4",
"width": 1080,
"height": 1920,
"hasAudio": true,
"source": "direct"
}
],
"audios": []
},
"msg": "success"
}Campos de la respuesta
| Campo | Tipo | Significado |
|---|---|---|
| platform | string | Nombre normalizado de la plataforma, por ejemplo instagram o youtube. |
| title | string | Título o texto del contenido cuando está disponible. |
| thumbnail | string | URL de la imagen de vista previa cuando está disponible. |
| duration | number | Duración en segundos; normalmente es 0 para imágenes y galerías. |
| images[] | array | Matriz de imágenes descargables con url, width y height. |
| videos[] | array | Matriz de videos con url, quality, mimeType, dimensiones, hasAudio y source. |
| audios[] | array | Matriz de audios descargables cuando la plataforma ofrece una pista separada. |
Solo se descuenta un crédito cuando se devuelven archivos
Una respuesta correcta con al menos una URL de imagen, video o audio cuesta 1 crédito. Los enlaces no compatibles, errores de autenticación, fallos de origen y resultados vacíos no consumen créditos.
Permisos del token
Los tokens pueden ser permanentes o caducar en una fecha. Limita cada token a plataformas concretas, edita sus permisos sin cambiar el valor o restablécelo para rotar el secreto.
Errores y comportamiento de facturación
| HTTP | Código | Significado |
|---|---|---|
| 401 | missing_token / invalid_token | Falta la cabecera Authorization o el token no es válido. |
| 401 | token_expired | El token ha caducado. Edita la clave o crea una nueva. |
| 403 | platform_not_allowed | El token no tiene permiso para esta plataforma. |
| 402 | insufficient_credits | La cuenta no tiene créditos suficientes. |
| 400 | 302 | El formato de la URL no es compatible o no corresponde a una publicación individual. |
| 200 | 304 | EasyDown no pudo obtener archivos descargables de este enlace público. |
Principios comunes para el proxy multimedia
Descarga el archivo desde tu backend; las CDN de origen suelen bloquear CORS o las vistas previas entre dominios.
Envía un User-Agent de navegador y el Referer u Origin indicado en la guía de la plataforma.
Reenvía Range para archivos grandes y vuelve a analizar la publicación cuando caduque una URL firmada.
No guardes cookies de origen ni tokens de API en el código frontend.
Solo publicaciones públicas individuales
El contenido privado, eliminado, exclusivo para usuarios conectados, protegido con DRM, en directo, de perfiles, búsquedas, colecciones o no disponible por región queda fuera del alcance. Procesa solo contenido que tengas derecho a usar.
Preguntas frecuentes sobre la API
¿Qué plataformas admite la API para descargar videos?
EasyDown incluye guías para URLs públicas individuales de YouTube, TikTok, Instagram, Twitter/X, Threads, Bilibili, Douyin, Xiaohongshu/RedNote, Kuaishou/Kwai, Weibo y Toutiao.
¿Todas las plataformas utilizan el mismo endpoint REST?
Sí. Envía una URL a https://api.easydown.org/api/v1/parse mediante POST con un Bearer token privado. Las guías explican las diferencias entre plataformas.
¿Cuándo consume un crédito una petición?
Solo cuando la respuesta contiene al menos una URL descargable de imagen, video o audio. Los errores, enlaces no compatibles y resultados vacíos no consumen créditos.
¿Puedo llamar a la API directamente desde el navegador?
Utiliza un backend, una función serverless o un servicio protegido. Una llamada directa expondría el token y algunos archivos requieren cabeceras de plataforma o un proxy.