SoundCloud Download

Requisição

curl "https://api.nyqo.dev/api/v1/soundcloud/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 SoundCloud (ex: https://soundcloud.com/artista/faixa)

Resposta

Campo	Tipo	Descrição
`stream`	`binary`	Arquivo MP3 com Content-Disposition para download
`X-Title`	`header`	Título da faixa
`X-Artist`	`header`	Nome do artista
`X-Genre`	`header`	Gênero musical
`X-Thumbnail`	`header`	URL da capa da faixa

Exemplo de retorno (stream/binário)

Retorna o arquivo MP3 diretamente.
Headers: X-Title, X-Artist, X-Genre, X-Thumbnail, X-Duration, X-Likes, X-Plays, 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.

# SoundCloud Download

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

Baixa uma faixa do SoundCloud em formato MP3. Perfeito para salvar músicas de artistas independentes e sets de DJ. Retorna o arquivo diretamente como stream.

Categoria: Downloads · Slug: `soundcloud-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 SoundCloud (ex: https://soundcloud.com/artista/faixa) |

## Resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `stream` | `binary` | Arquivo MP3 com Content-Disposition para download |
| `X-Title` | `header` | Título da faixa |
| `X-Artist` | `header` | Nome do artista |
| `X-Genre` | `header` | Gênero musical |
| `X-Thumbnail` | `header` | URL da capa da faixa |

## Exemplo (curl)

```bash
curl "https://api.nyqo.dev/api/v1/soundcloud/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-Genre, X-Thumbnail, X-Duration, X-Likes, X-Plays, 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.