API Reference

API de Download de Vídeo

A API de Download de Vídeo permite descarregar vídeos de plataformas como o YouTube, extrair áudio e obter metadados. Esta é uma API assíncrona: inicia um job e depois faz polling para obter o resultado.

x-api-key:stringobrigatório

Este header especifica a chave privada necessária para aceder ao Hunt.

Endpoint: GET /api/v1/video/download

query:stringobrigatório

O URL do vídeo a descarregar (por exemplo, URL do YouTube).

video_quality:stringopc

Qualidade de vídeo desejada. Opções: best, 1080p, 720p, 480p, 360p. Nota: vídeos com mais de 1 hora são limitados a 720p.

padrão:best

download_type:stringopc

Tipo de conteúdo a descarregar:

audio_video: vídeo com áudio (por defeito)
audio: apenas áudio
video: apenas vídeo

padrão:audio_video

video_format:stringopc

Formato de saída preferido: mp4, webm, mkv. (best effort)

padrão:mp4

max_duration:numberopc

Duração máxima em segundos. Conteúdo acima deste limite é cortado.

webhook_url:stringopc

URL para receber um callback POST quando o job terminar.

webhook_authorization:stringopc

Header Authorization para o webhook.

Resposta

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

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

Verifique o estado do job usando o job_id devolvido no Passo 1.

Exemplo de resposta (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"
    }
}

Obter API Key

Resposta

Exemplo de resposta (Completed)

VIDEO API