API Reference

Audio Download API

Audio Download API gør det muligt at udtrække og downloade lydspor fra videoer eller rene lydkilder. Dette er et asynkront API: du starter et job og poller derefter resultatet.

x-api-key:stringpåkrævet

Denne header angiver den private nøgle, du skal bruge for adgang til Hunt.

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

query:stringpåkrævet

URL at downloade lyd fra.

download_type:stringvalgfri

Ønsket downloadtype.

audio: downloader kun lyd (standard)

standard:audio

audio_quality:stringvalgfri

Ønsket lydkvalitet.

best: bedst tilgængelige kvalitet (standard)
320kbps: høj kvalitet
256kbps: standard kvalitet
128kbps: lav kvalitet

standard:best

audio_format:stringvalgfri

Ønsket outputformat for lyd.

mp3: MP3-format (standard)
m4a: MPEG-4 Audio
wav: Waveform Audio File Format

Bemærk: dette er en formatpræference. Vi gør vores bedste for at levere det ønskede format, men pga. tekniske begrænsninger eller konverteringsproblemer kan det endelige format afvige fra det ønskede.

standard:mp3

max_duration:numbervalgfri

Maksimal varighed af det downloadede indhold i sekunder. Hvis lyden er længere end denne værdi, downloades kun op til denne varighed. Nyttigt for at begrænse filstørrelser eller udtrække specifikke dele.

webhook_url:stringvalgfri

URL til webhook hvor resultater sendes. Når den er angivet, forsøger systemet at sende svaret op til 3 gange med 5 sekunders delay mellem forsøg. Resultater sendes som en POST-forespørgsel.

webhook_authorization:stringvalgfri

Authorization header til webhook. Dette giver mulighed for at tilføje autentificering til dit webhook-endpoint.

Response

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

Endpoint: GET https://api.huntapi.com/v1/jobs/{job_id}

Tjek status på dit job ved at bruge job_id fra Trin 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 er et tal fra 0 til 100, mens jobbet kører (Queued → 0, Running → 1–99, terminal → 100). Statusværdier: Queued, Running, CompletedJob, Error, NotFound, BadRequest.

Kun metadata uden download? Brug Media Metadata API (GET https://api.huntapi.com/v1/media/metadata) - synkron, 1 credit.

Relateret

Noter

Nogle lydfiler kan ikke downloades af følgende årsager:

Privat indhold: hvis indholdet er sat som privat af ejeren
Utilgængeligt indhold: hvis indholdet er slettet eller ikke længere kan tilgås
Aldersbegrænset indhold: hvis indholdet er aldersbegrænset

I disse tilfælde vil API’et returnere en forklarende fejlbesked.

Få API-nøgle

Response

Response Example (Running)

Response Example (Completed)

Relateret

Noter

VIDEO API