Announcement
|
por Hunt Team

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:

StatusProgress
Queued0
Running199
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

  1. Solo infoGET https://api.huntapi.com/v1/media/metadata
  2. ArchivoGET 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.

VIDEO API

Discover why Hunt is the preferred API provider for developers.