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 /api/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 /api/v1/jobs/{job_id}

Vérifiez le statut du job en utilisant le job_id retourné à l’étape 1.

Exemple de réponse (Completed)

{
    "id": "0193305e-e144-a995-3acc-6703bb48e13a",
    "status": "CompletedJob",
    "success": true,
    "created_at": "2024-11-15T15:09:04.709497Z",
    "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"
    }
}

Obtenir une clé API

Réponse

Exemple de réponse (Completed)

VIDEO API