API Reference

Video Download API

Video Download API pozwala pobierać filmy z platform takich jak YouTube, wyciągać audio oraz pobierać metadane. 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/video/download

query:stringwymagane

URL wideo do pobrania (np. URL YouTube).

video_quality:stringopc

Pożądana jakość wideo. Opcje: best, 1080p, 720p, 480p, 360p. Uwaga: filmy dłuższe niż 1 godzina są ograniczone do 720p.

domyślnie:best

download_type:stringopc

Typ treści do pobrania:

audio_video: wideo z audio (domyślnie)
audio: tylko ścieżka audio
video: tylko ścieżka wideo

domyślnie:audio_video

video_format:stringopc

Preferowany format wyjściowy: mp4, webm, mkv. (best effort)

domyślnie:mp4

max_duration:numberopc

Maksymalny czas trwania w sekundach. Treści przekraczające limit są przycinane.

webhook_url:stringopc

URL do otrzymania callbacku POST, gdy job się zakończy.

webhook_authorization:stringopc

Nagłówek Authorization dla webhooka.

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/video/download",
    "progress": 63,
    "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_video",
        "video_quality": "720p"
    },
    "result": null
}

Response Example (Completed)

{
    "id": "0193305e-e144-a995-3acc-6703bb48e13a",
    "status": "CompletedJob",
    "success": true,
    "endpoint": "/api/video/download",
    "progress": 100,
    "created_at": "2024-11-15T15:09:04.709497Z",
    "started_at": "2024-11-15T15:09:04.714422Z",
    "completed_at": "2024-11-15T15:10:44.268Z",
    "duration_ms": 99592,
    "args": {
        "query": "https://yt.com/watch?v=..."
    },
    "result": {
        "metadata": {
            "title": "The New Claude 3.5 Sonnet",
            "view_count": 82398,
            "upload_date": 1729641600
        },
        "response": "https://s3.huntapi.com/videos/32f88fc4-e728-4c45-b27c-6ee539575595.webm"
    }
}

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

Uzyskaj API Key

Response

Response Example (Running)

Response Example (Completed)

Powiązane

VIDEO API