API Reference

API de téléchargement audio

L’API de téléchargement audio permet d’extraire et de télécharger des pistes audio depuis des vidéos ou des sources audio-only. 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/audio/download

query:stringrequis

URL à partir de laquelle télécharger l’audio.

download_type:stringopt

Type de téléchargement souhaité.

audio : télécharge uniquement l’audio (option par défaut)

défaut :audio

audio_quality:stringopt

Qualité audio souhaitée.

best : meilleure qualité disponible (par défaut)
320kbps : haute qualité
256kbps : qualité standard
128kbps : basse qualité

défaut :best

audio_format:stringopt

Format de sortie souhaité pour l’audio.

mp3 : format MP3 (par défaut)
m4a : format MPEG-4 Audio
wav : Waveform Audio File Format

Note : il s’agit d’une préférence de format. Nous faisons au mieux, mais selon les limitations techniques ou des problèmes de conversion, le format final peut différer de celui demandé.

défaut :mp3

max_duration:numberopt

Durée maximale du contenu téléchargé en secondes. Si l’audio dépasse cette valeur, seul le contenu jusqu’à cette durée sera téléchargé. Utile pour limiter la taille des fichiers ou extraire des portions spécifiques.

webhook_url:stringopt

URL du webhook où envoyer les résultats. Quand elle est fournie, le système tente d’envoyer la réponse jusqu’à 3 fois, avec 5 secondes d’intervalle entre chaque tentative. Les résultats sont envoyés via une requête POST.

webhook_authorization:stringopt

En-tête Authorization pour le webhook. Ce paramètre permet d’ajouter une authentification à votre endpoint 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/audio/download",
    "progress": 47,
    "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"
    },
    "result": null
}

Response Example (Completed)

{
    "id": "0193443f-fb80-9d19-29ba-82bc77c7cd84",
    "status": "CompletedJob",
    "success": true,
    "endpoint": "/api/audio/download",
    "progress": 100,
    "duration_ms": 42110,
    "args": {
        "query": "https://www.youtube.com/watch?v=example"
    },
    "result": {
        "metadata": {
            "title": "Example Audio Title",
            "duration": 180,
            "upload_date": 1729641600
        },
        "response": "https://s3.huntapi.com/audios/audio_id.mp3"
    }
}

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

Notes

Certains audios ne peuvent pas être téléchargés pour les raisons suivantes :

Contenu privé : si le contenu est défini comme privé par son propriétaire
Contenu indisponible : si le contenu a été supprimé ou n’est plus accessible
Contenu soumis à limite d’âge : si le contenu est restreint par âge

Dans ces cas, l’API renverra un message d’erreur explicatif.

Obtenir une clé API

Réponse

Response Example (Running)

Response Example (Completed)

Voir aussi

Notes

VIDEO API