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

Controleer de status van je job met de job_id uit Stap 1.

Response Example (Completed)

{
    "id": "0193305e-e144-a995-3acc-6703bb48e13a",
    "status": "CompletedJob",
    "success": true,
    "created_at": "2024-11-15T15:09:04.709497Z",
    "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"
    }
}

API Key ophalen

Response

Response Example (Completed)

VIDEO API