Spotify Search — Nyqo API

Requisição

curl "https://api.nyqo.dev/api/v1/spotify/search?q=exemplo%20de%20busca" \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
`q`	`string`	sim	Termo de pesquisa (nome da música, artista ou álbum)

Resposta

Campo	Tipo	Descrição
`results`	`object[]`	Lista de faixas com nome, artistas e link do Spotify

Exemplo de resposta real

{
	 "success": true,
	 "data": [
	   {"name": "Blinding Lights", "artists": "The Weeknd", "link": "https://open.spotify.com/track/..."}
	 ]
}

Levar essa referência para o seu agente/LLM

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

# Spotify Search

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

Pesquisa faixas no Spotify por palavra-chave. Retorna resultados com links diretos para as faixas no Spotify.

Categoria: Downloads · Slug: `spotify-search`

## 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 |
| --- | --- | --- | --- |
| `q` | `string` | sim | Termo de pesquisa (nome da música, artista ou álbum) |

## Resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `results` | `object[]` | Lista de faixas com nome, artistas e link do Spotify |

## Exemplo (curl)

```bash
curl "https://api.nyqo.dev/api/v1/spotify/search?q=exemplo%20de%20busca" \n  -H "Authorization: Bearer nyq_sua_chave_aqui"
```

## Exemplo de resposta

```json
{
	 "success": true,
	 "data": [
	   {"name": "Blinding Lights", "artists": "The Weeknd", "link": "https://open.spotify.com/track/..."}
	 ]
}
```

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.

Estamos em manutenção

Requisição

Parâmetros

Resposta

Levar essa referência para o seu agente/LLM

Erros comuns