API Reference

Audio Download API

De Audio Download API laat je audiotracks extraheren en downloaden uit video’s of audio-only bronnen. Dit is een asynchrone API: je start een job en pollt daarna het resultaat.

x-api-key:stringvereist

Deze header specificeert de private key die je nodig hebt voor Hunt-toegang.

Endpoint: GET /api/v1/audio/download

query:stringvereist

URL om audio van te downloaden.

download_type:stringopt

Gewenst downloadtype.

audio: downloadt alleen audio (standaard)

standaard:audio

audio_quality:stringopt

Gewenste audiokwaliteit.

best: best beschikbare kwaliteit (standaard)
320kbps: hoge kwaliteit
256kbps: standaardkwaliteit
128kbps: lage kwaliteit

standaard:best

audio_format:stringopt

Gewenst outputformaat voor audio.

mp3: MP3-formaat (standaard)
m4a: MPEG-4 Audio
wav: Waveform Audio File Format

Let op: dit is een formaatvoorkeur. We doen ons best om het gevraagde formaat te leveren, maar door technische beperkingen of conversieproblemen kan het uiteindelijke formaat afwijken.

standaard:mp3

max_duration:numberopt

Maximale duur van de gedownloade content in seconden. Als de audio langer is, wordt alleen tot deze duur gedownload. Handig om bestandsgroottes te beperken of specifieke delen te extraheren.

webhook_url:stringopt

URL van de webhook waar resultaten naartoe worden gestuurd. Als dit is ingesteld, probeert het systeem tot 3 keer te posten met 5 seconden vertraging tussen pogingen. Resultaten worden als een POST request verstuurd.

webhook_authorization:stringopt

Authorization header voor de webhook. Hiermee kun je authenticatie toevoegen aan je webhook endpoint.

Response

{
    "job_id": "0193443f-fb80-9d19-29ba-82bc77c7cd84"
}

Endpoint: GET /api/v1/jobs/{job_id}

Controleer de status van je job met de job_id uit Stap 1.

Response Example (Completed)

{
    "id": "0193443f-fb80-9d19-29ba-82bc77c7cd84",
    "status": "CompletedJob",
    "result": {
        "metadata": {
            "title": "Example Audio Title",
            "duration": 180,
            "upload_date": 1729641600
        },
        "response": "https://s3.huntapi.com/audios/audio_id.mp3"
    }
}

Opmerkingen

Sommige audio’s kunnen niet worden gedownload om de volgende redenen:

Privécontent: als de content door de eigenaar als privé is ingesteld
Niet beschikbaar: als de content is verwijderd of niet langer toegankelijk is
Leeftijdsbeperkte content: als de content leeftijdsbeperkt is

In deze gevallen retourneert de API een verklarende foutmelding.

API Key ophalen

Response

Response Example (Completed)

Opmerkingen

VIDEO API