Metadatos de media y progreso de jobs
Hemos publicado varias novedades de media que faltaban: inspeccionar una URL sin descargar, y ver el avance de una descarga.
Media Metadata (sin descarga)
¿Necesitas título, duración, miniatura o canal antes de gastar un crédito de descarga? Llama:
GET https://api.huntapi.com/v1/media/metadata?query=https://www.youtube.com/watch?v=VIDEO_ID
x-api-key: YOUR_API_KEY
Este endpoint es síncrono. Recibes un objeto metadata en la misma respuesta - sin job_id, sin polling. Coste: 1 crédito por llamada exitosa.
Docs: Media Metadata API.
Úsalo para previsualizar una URL, armar un catálogo o decidir calidad / max_duration antes de un job de descarga.
Progreso de jobs de descarga (0–100)
Las descargas de vídeo y audio siguen siendo asíncronas. Lo nuevo en GET https://api.huntapi.com/v1/jobs/{id} es el campo numérico progress:
| Status | Progress |
|---|---|
Queued | 0 |
Running | 1–99 |
CompletedJob / Error / … | 100 |
Haz poll cada 1–2 segundos mientras el job esté Queued o Running. Los webhooks siguen disponibles.
Referencias actualizadas:
Modelo mental rápido
- Solo info →
GET https://api.huntapi.com/v1/media/metadata - Archivo →
GET https://api.huntapi.com/v1/video/download(o/v1/audio/download) → poll/v1/jobs/{id}
Crea una clave en app.huntapi.com y prueba primero una llamada de metadata - la forma más barata de confirmar que una URL sirve.