API Reference

Audio Download API

Die Audio Download API ermöglicht es Ihnen, Audiospuren aus Videos oder Audio-only-Quellen zu extrahieren und herunterzuladen. Dies ist eine asynchrone API: Sie starten einen Job und pollen anschließend das Ergebnis.

x-api-key:stringerforderlich

Dieser Header enthält den privaten Schlüssel, den Sie für den Zugriff auf Hunt benötigen.

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

query:stringerforderlich

URL, von der Audio heruntergeladen werden soll.

download_type:stringopt

Gewünschter Download-Typ.

audio: lädt nur Audio herunter (Standard)

Standard:audio

audio_quality:stringopt

Gewünschte Audioqualität.

best: beste verfügbare Qualität (Standard)
320kbps: hohe Qualität
256kbps: Standardqualität
128kbps: niedrige Qualität

Standard:best

audio_format:stringopt

Gewünschtes Ausgabeformat für Audio.

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

Hinweis: Dies ist eine Formatpräferenz. Wir versuchen das gewünschte Format bereitzustellen, aber aufgrund technischer Einschränkungen oder Konvertierungsproblemen kann das Ausgabeformat abweichen.

Standard:mp3

max_duration:numberopt

Maximale Dauer des heruntergeladenen Inhalts in Sekunden. Wenn der Audio-Stream länger ist, wird nur bis zu dieser Dauer heruntergeladen. Nützlich, um Dateigrößen zu begrenzen oder bestimmte Abschnitte zu extrahieren.

webhook_url:stringopt

Webhook-URL, an die Ergebnisse gesendet werden. Wenn gesetzt, versucht das System die Antwort bis zu 3 Mal zu senden (5 Sekunden Abstand). Die Ergebnisse werden per POST gesendet.

webhook_authorization:stringopt

Authorization-Header für den Webhook. Damit können Sie Ihren Webhook-Endpunkt authentifizieren.

Response

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

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

Prüfen Sie den Status Ihres Jobs mit der job_id aus Schritt 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 ist eine Zahl von 0 bis 100 während der Job läuft (Queued → 0, Running → 1–99, terminal → 100). Statuswerte: Queued, Running, CompletedJob, Error, NotFound, BadRequest.

Nur Metadaten ohne Download? Nutzen Sie die Media Metadata API (GET https://api.huntapi.com/v1/media/metadata) - synchron, 1 Credit.

Verwandt

Hinweise

Einige Audios können aus folgenden Gründen nicht heruntergeladen werden:

Privater Inhalt: Wenn der Inhalt vom Besitzer als privat markiert ist
Nicht verfügbar: Wenn der Inhalt gelöscht wurde oder nicht mehr zugänglich ist
Altersbeschränkung: Wenn der Inhalt altersbeschränkt ist

In diesen Fällen gibt die API eine erklärende Fehlermeldung zurück.

API-Key erhalten

Response

Response Example (Running)

Response Example (Completed)

Verwandt

Hinweise

VIDEO API