API Reference

Video Download API

De Video Download API stelt je in staat video’s te downloaden van platformen zoals YouTube, audio te extraheren en metadata op te halen. Dit is een asynchrone API: je start een job en pollt daarna het resultaat.

x-api-key:stringvereist

Deze header specificeert de private key die je nodig hebt voor Hunt-toegang.

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

query:stringvereist

De URL van de video om te downloaden (bijv. een YouTube-URL).

video_quality:stringopt

Gewenste videokwaliteit. Opties: best, 1080p, 720p, 480p, 360p. Let op: video’s langer dan 1 uur zijn beperkt tot 720p.

standaard:best

download_type:stringopt

Content type om te downloaden:

audio_video: video met audio (standaard)
audio: alleen audiotrack
video: alleen videotrack

standaard:audio_video

video_format:stringopt

Voorkeurs-outputformaat: mp4, webm, mkv. (Best effort)

standaard:mp4

max_duration:numberopt

Maximale duur in seconden. Content boven deze duur wordt ingekort.

webhook_url:stringopt

URL om een POST-callback te ontvangen wanneer de job klaar is.

webhook_authorization:stringopt

Authorization header voor de webhookrequest.

Response

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

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

Controleer de status van je job met de job_id uit Stap 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 is een getal van 0 tot 100 terwijl de job loopt (Queued → 0, Running → 1–99, terminal → 100). Statuswaarden: Queued, Running, CompletedJob, Error, NotFound, BadRequest.

Alleen metadata nodig zonder download? Gebruik de Media Metadata API (GET https://api.huntapi.com/v1/media/metadata) - synchroon, 1 credit.

Gerelateerd

API Key ophalen

Response

Response Example (Running)

Response Example (Completed)

Gerelateerd

VIDEO API