Documentación de la API de descarga de vídeos
Nuestra API de descarga de vídeos de Any4K.com te permite descargar fácilmente vídeos desde las plataformas de redes sociales más populares, como YouTube, TikTok y Twitter. La API admite diferentes calidades y formatos de vídeo y ofrece funciones de extracción de vídeo y audio.
Endpoints de la API
Verificación de información del vídeo
Devuelve los metadatos del vídeo y los formatos de descarga disponibles.
Endpoint: https://api.any4k.com/v1/dlp/check
Método: POST
Content-Type: application/json
Parámetros de la solicitud
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| url | string | Sí | La URL del vídeo a descargar |
| lang | string | No | Código de idioma (por defecto: en) |
| country | string | No | Código de país (por defecto: US) |
| platform | string | No | Nombre de la plataforma (por defecto: Web) |
| deviceId | string | No | Identificador único del dispositivo |
Ejemplo de solicitud
cURL
curl -X POST https://api.any4k.com/v1/dlp/check \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.youtube.com/watch?v=VIDEO_ID",
"lang": "en",
"country": "US",
"platform": "Web",
"deviceId": "your-device-id"
}'
Node.js
const axios = require('axios');
async function checkVideo() {
try {
const response = await axios.post('https://api.any4k.com/v1/dlp/check', {
url: 'https://www.youtube.com/watch?v=VIDEO_ID',
lang: 'en',
country: 'US',
platform: 'Web',
deviceId: 'your-device-id'
}, {
headers: {
'Content-Type': 'application/json'
}
});
console.log(response.data);
} catch (error) {
console.error('Error:', error.response.data);
}
}
Formato de respuesta
{
"err_code": 0,
"err_msg": "",
"data": {
"id": "VIDEO_ID",
"title": "Título del vídeo",
"description": "Descripción del vídeo",
"duration": 180,
"view_count": 1000000,
"upload_date": "20240401",
"extractor": "youtube",
"is_live": false,
"thumbnail": "https://example.com/thumbnail.jpg",
"download": [
{
"id": "format_id",
"ext": "mp4",
"res_text": "1080p",
"filesize": 104857600
}
],
"raw_video": [
{
"id": "format_id",
"ext": "mp4",
"res_text": "4K",
"filesize": 524288000,
"vcodec": "h264"
}
],
"raw_audio": [
{
"id": "format_id",
"ext": "m4a",
"filesize": 3145728,
"acodec": "aac",
"asr": 44100
}
]
}
}
Descarga del vídeo
Descarga el vídeo en el formato indicado.
Endpoint: https://api.any4k.com/v1/dlp/download
Método: POST
Content-Type: application/json
Parámetros de la solicitud
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| url | string | Sí | La URL del vídeo |
| format | string | Sí | ID de formato obtenido en la respuesta de verificación |
| lang | string | No | Código de idioma (por defecto: en) |
| country | string | No | Código de país (por defecto: US) |
Ejemplo de solicitud
cURL
curl -X POST https://api.any4k.com/v1/dlp/download \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.youtube.com/watch?v=VIDEO_ID",
"format": "format_id",
"lang": "en",
"country": "US"
}'
Node.js
const axios = require('axios');
async function downloadVideo() {
try {
const response = await axios.post('https://api.any4k.com/v1/dlp/download', {
url: 'https://www.youtube.com/watch?v=VIDEO_ID',
format: 'format_id',
lang: 'en',
country: 'US'
}, {
headers: {
'Content-Type': 'application/json'
},
responseType: 'stream'
});
// Gestionar el flujo de vídeo
response.data.pipe(fs.createWriteStream('video.mp4'));
} catch (error) {
console.error('Error:', error.message);
}
}
Códigos de error
| Código | Descripción |
|---|---|
| 0 | Éxito |
| 400 | Solicitud incorrecta: parámetros inválidos |
| 401 | No autorizado: clave de API inválida |
| 403 | Prohibido: acceso denegado |
| 404 | No encontrado: vídeo no encontrado |
| 429 | Demasiadas solicitudes: límite de tasa superado |
| 500 | Error interno del servidor |
| 502 | Bad Gateway: error de la plataforma de vídeo |
Plataformas compatibles
- YouTube
- TikTok
- Vimeo
- Dailymotion
- Y muchas más...
Límites de uso
- Versión gratuita: 100 solicitudes por día
- Versión Pro: 1000 solicitudes por día
- Versión Enterprise: límites personalizados
Buenas prácticas
- Comprueba siempre la información del vídeo antes de descargarlo
- Gestiona correctamente los límites de uso
- Implementa un manejo de errores adecuado
- Cachea las respuestas siempre que sea posible
- Utiliza valores de timeout razonables
Soporte
Para soporte técnico o consultas, contacta con:
- Correo: api@any4k.com
- Documentación: https://any4k.com/api
Frequently Asked Questions
¿Qué puede hacer la API de descarga de vídeos de Any4K?
Puede verificar URLs de vídeo públicas, devolver metadatos y formatos disponibles, y lanzar descargas mediante los endpoints documentados.
¿Qué plataformas son compatibles?
La API está pensada para plataformas populares como YouTube, TikTok, Twitter/X, Facebook, Instagram, Vimeo, Dailymotion, Twitch y otras cuando exista acceso público.
¿Es necesario llamar al endpoint de verificación antes de descargar?
Sí. Verifica primero la información del vídeo para mostrar los formatos, detectar vídeos no compatibles y elegir la opción de descarga adecuada.