API Reference

API di download video

La Video Download API ti consente di scaricare video da piattaforme come YouTube, estrarre audio e recuperare metadati. Questa è un’API asincrona: avvii un job e poi fai polling per ottenere il risultato.

x-api-key:stringrichiesto

Questo header specifica la chiave privata necessaria per l’accesso a Hunt.

Endpoint: GET /api/v1/video/download

query:stringrichiesto

L’URL del video da scaricare (ad es. URL YouTube).

video_quality:stringopz

Qualità video desiderata. Opzioni: best, 1080p, 720p, 480p, 360p. Nota: i video più lunghi di 1 ora sono limitati a 720p.

default:best

download_type:stringopz

Tipo di contenuto da scaricare:

audio_video: video con audio (default)
audio: solo traccia audio
video: solo traccia video

default:audio_video

video_format:stringopz

Formato di output preferito: mp4, webm, mkv. (best effort)

default:mp4

max_duration:numberopz

Durata massima in secondi. I contenuti oltre questo limite vengono tagliati.

webhook_url:stringopz

URL per ricevere un callback POST quando il job termina.

webhook_authorization:stringopz

Header Authorization per la richiesta webhook.

Response

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

Endpoint: GET /api/v1/jobs/{job_id}

Verifica lo stato del job usando il job_id restituito dallo Step 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"
    }
}

Ottieni API Key

Response

Response Example (Completed)

VIDEO API