API Reference

API de téléchargement vidéo

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.

x-api-key:stringrequis

Cet en-tête contient la clé privée nécessaire pour accéder à Hunt.

Endpoint : GET https://api.huntapi.com/v1/video/download

query:stringrequis

L’URL de la vidéo à télécharger (ex. URL YouTube).

video_quality:stringopt

Qualité vidéo souhaitée. Options : best, 1080p, 720p, 480p, 360p. Note : les vidéos de plus d’1 heure sont limitées à 720p.

défaut :best

download_type:stringopt

Type de contenu à télécharger :

audio_video : vidéo avec audio (par défaut)
audio : piste audio uniquement
video : piste vidéo uniquement

défaut :audio_video

video_format:stringopt

Format de sortie préféré : mp4, webm, mkv (au mieux).

défaut :mp4

max_duration:numberopt

Durée maximale en secondes. Le contenu dépassant cette durée est tronqué.

webhook_url:stringopt

URL à laquelle envoyer un callback POST lorsque le job est terminé.

webhook_authorization:stringopt

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.

Voir aussi

Obtenir une clé API

Réponse

Response Example (Running)

Response Example (Completed)

Voir aussi

VIDEO API