API Reference

Audio Download API

Audio Download API pozwala wyciągać i pobierać ścieżki audio z wideo lub źródeł audio-only. To asynchroniczne API: inicjujesz job, a następnie odpytyjesz wynik.

x-api-key:stringwymagane

Ten nagłówek określa prywatny klucz potrzebny do dostępu do Hunt.

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

query:stringwymagane

URL, z którego ma zostać pobrane audio.

download_type:stringopc

Pożądany typ pobierania.

audio: pobiera tylko audio (domyślnie)

domyślnie:audio

audio_quality:stringopc

Pożądana jakość audio.

best: najlepsza dostępna jakość (domyślnie)
320kbps: wysoka jakość
256kbps: standardowa jakość
128kbps: niska jakość

domyślnie:best

audio_format:stringopc

Pożądany format wyjściowy audio.

mp3: format MP3 (domyślnie)
m4a: MPEG-4 Audio
wav: Waveform Audio File Format

Uwaga: to preferencja formatu. Postaramy się dostarczyć żądany format, ale ze względu na ograniczenia techniczne lub problemy z konwersją finalny format może się różnić.

domyślnie:mp3

max_duration:numberopc

Maksymalny czas trwania pobieranego materiału w sekundach. Jeśli audio jest dłuższe, pobierzemy tylko do tej długości. Przydatne do ograniczenia rozmiaru plików lub wycięcia fragmentów.

webhook_url:stringopc

URL webhooka, na który zostaną wysłane wyniki. Gdy jest podany, system spróbuje wysłać odpowiedź do 3 razy z 5-sekundowym odstępem. Wyniki są wysyłane jako POST.

webhook_authorization:stringopc

Nagłówek Authorization dla webhooka. Pozwala dodać uwierzytelnianie do Twojego endpointu webhook.

Response

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

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

Sprawdź status joba używając job_id zwróconego w Kroku 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 to liczba od 0 do 100 podczas działania joba (Queued → 0, Running → 1–99, terminal → 100). Wartości statusu: Queued, Running, CompletedJob, Error, NotFound, BadRequest.

Potrzebujesz tylko metadanych bez pobierania pliku? Użyj Media Metadata API (GET https://api.huntapi.com/v1/media/metadata) - synchronicznie, 1 kredyt.

Powiązane

Uwagi

Niektórych materiałów audio nie da się pobrać z następujących powodów:

Prywatna treść: gdy treść jest ustawiona jako prywatna przez właściciela
Treść niedostępna: gdy treść została usunięta lub nie jest już dostępna
Ograniczenie wiekowe: gdy treść jest ograniczona wiekowo

W takich przypadkach API zwróci opisowy komunikat błędu.

Uzyskaj API Key

Response

Response Example (Running)

Response Example (Completed)

Powiązane

Uwagi

VIDEO API