POST/v1/extract

Extrair mídia de uma URL

Recebe uma URL pública e devolve variantes. Vídeo e áudio podem vir separados.

Corpo da requisição

url

string

Obrigatório. URL pública do post ou vídeo.

prefer

string

Opcional, best-effort, maxLength 20. Valores desconhecidos degradam em silêncio.

download_links

boolean

Opcional. false não emite download_url.

requires_mux é um campo da resposta. Se for verdadeiro, usa POST /v1/assemble; ignorá-lo entrega vídeo mudo no YouTube.

pedido
{
  "url": "https://example.invalid/x/status/1"
}
resposta 200
{
  "ok": true,
  "items": [
    {
      "variants": [
        { "type": "video", "resolution": "1080p", "has_audio": false },
        { "type": "audio", "has_audio": true }
      ],
      "requires_mux": true,
      "download_url": "https://EDGE_BASE_URL/dl/{token}",
      "expires_at": "2026-09-04T18:22:00Z"
    }
  ]
}