GET
https://api.nyqo.dev/api/v1/youtube/downloadYouTube Download
Baixa áudio (MP3) ou vídeo (MP4) do YouTube em alta qualidade. Perfeito para salvar músicas, podcasts, tutoriais e vídeos offline. Retorna o arquivo diretamente como stream.
Slug youtube-download· requer autenticação nyq_· erros padrão em /docs
Requisição
curl "https://api.nyqo.dev/api/v1/youtube/download?url=https%3A%2F%2Fexemplo.com%2Fconteudo&format=mp3" \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
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
url | string | sim | URL do vídeo do YouTube (ex: https://www.youtube.com/watch?v=...) ou URL curta (youtu.be/...) |
format | string | não | Formato de saída: 'mp3' para áudio ou 'mp4' para vídeo (padrão: mp3) |
Resposta
| Campo | Tipo | Descrição |
|---|---|---|
stream | binary | Arquivo de áudio/vídeo com Content-Disposition para download |
X-Title | header | Título do vídeo |
X-Author | header | Nome do canal/autor |
X-Duration | header | Duração em segundos |
X-Thumbnail | header | URL da thumbnail do vídeo |
Exemplo de retorno (stream/binário)
Retorna o arquivo de áudio/vídeo diretamente.
Headers: X-Title, X-Author, X-Duration, X-Thumbnail, X-Quality, Content-DispositionEste 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.
# YouTube Download
`GET https://api.nyqo.dev/api/v1/youtube/download`
Baixa áudio (MP3) ou vídeo (MP4) do YouTube em alta qualidade. Perfeito para salvar músicas, podcasts, tutoriais e vídeos offline. Retorna o arquivo diretamente como stream.
Categoria: Downloads · Slug: `youtube-download`
## Autenticação
```http
Authorization: Bearer nyq_sua_chave_aqui
```
Também aceito: `X-API-Key: nyq_sua_chave_aqui`. Nunca via query string (`?api_key`).
## Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `url` | `string` | sim | URL do vídeo do YouTube (ex: https://www.youtube.com/watch?v=...) ou URL curta (youtu.be/...) |
| `format` | `string` | não | Formato de saída: 'mp3' para áudio ou 'mp4' para vídeo (padrão: mp3) |
## Resposta
| Campo | Tipo | Descrição |
| --- | --- | --- |
| `stream` | `binary` | Arquivo de áudio/vídeo com Content-Disposition para download |
| `X-Title` | `header` | Título do vídeo |
| `X-Author` | `header` | Nome do canal/autor |
| `X-Duration` | `header` | Duração em segundos |
| `X-Thumbnail` | `header` | URL da thumbnail do vídeo |
## Exemplo (curl)
```bash
curl "https://api.nyqo.dev/api/v1/youtube/download?url=https%3A%2F%2Fexemplo.com%2Fconteudo&format=mp3" \n -H "Authorization: Bearer nyq_sua_chave_aqui"
```
## Exemplo de resposta
```json
Retorna o arquivo de áudio/vídeo diretamente.
Headers: X-Title, X-Author, X-Duration, X-Thumbnail, X-Quality, Content-Disposition
```
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; aguardeRetry-After. Detalhes em rate limits.
Tabela completa em /docs — códigos de erro.