Requisição

curl "https://api.nyqo.dev/api/v1/facebook/download?url=https%3A%2F%2Fexemplo.com%2Fconteudo" \n  -H "Authorization: Bearer nyq_sua_chave_aqui"

Troque nyq_sua_chave_aqui pela sua chave do painel. Também aceito via header X-API-Key — nunca na query string.

Parâmetros

NomeTipoObrigatórioDescrição
urlstringsimURL do vídeo do Facebook (ex: https://www.facebook.com/username/videos/...)

Resposta

CampoTipoDescrição
streambinaryArquivo de vídeo MP4 com Content-Disposition para download
X-ResolutionheaderResolução do vídeo disponível
X-ThumbnailheaderURL da thumbnail do vídeo

Exemplo de retorno (stream/binário)

Retorna o arquivo de vídeo MP4 diretamente.
Headers: X-Resolution, X-Thumbnail, Content-Disposition

Este endpoint devolve o arquivo direto no corpo da resposta (stream) com metadados nos headersX-* — não um JSON.

Levar essa referência para o seu agente/LLM

Copie a doc em Markdown — mesmo formato das skills e do llms.txt.

Erros comuns

  • · 401 unauthorized — sem chave ou chave inválida. Confira autenticação.
  • · 403 forbidden — plano sem esta rota ou chave fora do escopo. Veja planos.
  • · 429 rate_limited — quota estourada; aguarde Retry-After. Detalhes em rate limits.

Tabela completa em /docs — códigos de erro.