YouTube Download — Nyqo API

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-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.

# 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; aguarde Retry-After. Detalhes em rate limits.

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