API Reference

Video Download API

Die Video Download API ermöglicht es Ihnen, Videos von Plattformen wie YouTube herunterzuladen, Audio zu extrahieren und Metadaten abzurufen. Dies ist eine asynchrone API: Sie starten einen Job und pollen anschließend das Ergebnis.

x-api-key:stringerforderlich

Dieser Header enthält den privaten Schlüssel, den Sie für den Zugriff auf Hunt benötigen.

Endpoint: GET /api/v1/video/download

query:stringerforderlich

Die URL des Videos, das heruntergeladen werden soll (z. B. YouTube-URL).

video_quality:stringopt

Gewünschte Videoqualität. Optionen: best, 1080p, 720p, 480p, 360p. Hinweis: Videos länger als 1 Stunde sind auf 720p begrenzt.

Standard:best

download_type:stringopt

Inhaltstyp zum Download:

audio_video: Video mit Audio (Standard)
audio: nur Audiospur
video: nur Videospur

Standard:audio_video

video_format:stringopt

Bevorzugtes Ausgabeformat: mp4, webm, mkv (Best-Effort).

Standard:mp4

max_duration:numberopt

Maximale Dauer in Sekunden. Inhalte, die länger sind, werden gekürzt.

webhook_url:stringopt

URL für einen POST-Callback, sobald der Job abgeschlossen ist.

webhook_authorization:stringopt

Authorization-Header für die Webhook-Anfrage.

Response

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

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

Prüfen Sie den Status Ihres Jobs mit der job_id aus Schritt 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 erhalten

Response

Response Example (Completed)

VIDEO API