API Reference
API de téléchargement vidéo
/library/video-download
L’API de téléchargement vidéo permet de télécharger des vidéos depuis des plateformes comme YouTube, d’extraire l’audio et de récupérer des métadonnées. Il s’agit d’une API asynchrone : vous initiez un job puis vous récupérez le résultat via polling.
Cet en-tête contient la clé privée nécessaire pour accéder à Hunt.
Endpoint : GET https://api.huntapi.com/v1/video/download
L’URL de la vidéo à télécharger (ex. URL YouTube).
Qualité vidéo souhaitée. Options : best, 1080p, 720p, 480p, 360p.
Note : les vidéos de plus d’1 heure sont limitées à 720p.
Type de contenu à télécharger :
audio_video: vidéo avec audio (par défaut)audio: piste audio uniquementvideo: piste vidéo uniquement
Format de sortie préféré : mp4, webm, mkv (au mieux).
Durée maximale en secondes. Le contenu dépassant cette durée est tronqué.
URL à laquelle envoyer un callback POST lorsque le job est terminé.
En-tête Authorization pour la requête webhook.
Réponse
{
"job_id": "0193443f-fb80-9d19-29ba-82bc77c7cd84"
}Endpoint : GET https://api.huntapi.com/v1/jobs/{job_id}
Vérifiez le statut du job en utilisant le job_id retourné à l’étape 1.
Response Example (Running)
{
"id": "019ff14c-49fe-09b5-0cd5-e6c575481a6b",
"status": "Running",
"success": null,
"endpoint": "/api/video/download",
"progress": 63,
"created_at": "2026-08-11T14:48:56.574227Z",
"started_at": "2026-08-11T14:48:56.577590Z",
"completed_at": null,
"duration_ms": null,
"args": {
"query": "https://www.youtube.com/watch?v=Z5YP8kznWZs",
"download_type": "audio_video",
"video_quality": "720p"
},
"result": null
}Response Example (Completed)
{
"id": "0193305e-e144-a995-3acc-6703bb48e13a",
"status": "CompletedJob",
"success": true,
"endpoint": "/api/video/download",
"progress": 100,
"created_at": "2024-11-15T15:09:04.709497Z",
"started_at": "2024-11-15T15:09:04.714422Z",
"completed_at": "2024-11-15T15:10:44.268Z",
"duration_ms": 99592,
"args": {
"query": "https://yt.com/watch?v=..."
},
"result": {
"metadata": {
"title": "The New Claude 3.5 Sonnet",
"view_count": 82398,
"upload_date": 1729641600
},
"response": "https://s3.huntapi.com/videos/32f88fc4-e728-4c45-b27c-6ee539575595.webm"
}
}progress est un nombre de 0 à 100 pendant l’exécution du job (Queued → 0, Running → 1–99, terminal → 100). Statuts : Queued, Running, CompletedJob, Error, NotFound, BadRequest.
Besoin des métadonnées sans télécharger le fichier ? Utilisez l’API Media Metadata (GET https://api.huntapi.com/v1/media/metadata) - synchrone, 1 crédit.