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

Prüfen Sie den Status Ihres Jobs mit der job_id aus Schritt 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"
    }
}

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 (Completed)

Hinweise

VIDEO API