Spotify Download — Nyqo API

Requisição

curl "https://api.nyqo.dev/api/v1/spotify/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

Nome	Tipo	Obrigatório	Descrição
`url`	`string`	sim	URL da faixa no Spotify (ex: https://open.spotify.com/track/...)

Resposta

Campo	Tipo	Descrição
`stream`	`binary`	Arquivo MP3 com Content-Disposition para download
`X-Title`	`header`	Nome da faixa
`X-Artist`	`header`	Nome do(s) artista(s)
`X-Album`	`header`	Nome do álbum
`X-Image-URL`	`header`	URL da capa do álbum

Exemplo de retorno (stream/binário)

Retorna o arquivo MP3 diretamente.
Headers: X-Title, X-Artist, X-Album, X-Image-URL, X-Duration, X-Year, 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.

# Spotify Download

`GET https://api.nyqo.dev/api/v1/spotify/download`

Baixa uma faixa do Spotify em formato MP3 de alta qualidade. Ideal para salvar músicas para ouvir offline. Retorna o arquivo diretamente como stream.

Categoria: Downloads · Slug: `spotify-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 da faixa no Spotify (ex: https://open.spotify.com/track/...) |

## Resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `stream` | `binary` | Arquivo MP3 com Content-Disposition para download |
| `X-Title` | `header` | Nome da faixa |
| `X-Artist` | `header` | Nome do(s) artista(s) |
| `X-Album` | `header` | Nome do álbum |
| `X-Image-URL` | `header` | URL da capa do álbum |

## Exemplo (curl)

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

## Exemplo de resposta

```json
Retorna o arquivo MP3 diretamente.
Headers: X-Title, X-Artist, X-Album, X-Image-URL, X-Duration, X-Year, 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.