Lyrics Search — Nyqo API

Requisição

curl "https://api.nyqo.dev/api/v1/search/lyrics?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	Nome da música e/ou artista (ex: 'Bohemian Rhapsody Queen')

Resposta

Campo	Tipo	Descrição
`title`	`string`	Título da música
`artist`	`string`	Nome do artista
`lyrics`	`string`	Letra completa da música
`url`	`string`	URL da fonte original

Exemplo de resposta real

{
		"success": true,
		"data": {
		  "title": "Bohemian Rhapsody",
		  "artist": "Queen",
		  "lyrics": "Is this the real life...",
		  "url": "https://..."
		}
}

Levar essa referência para o seu agente/LLM

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

# Lyrics Search

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

Pesquisa a letra completa de uma música por nome e/ou artista. Útil para encontrar letras de músicas para karaokê, estudo ou simplesmente para cantar junto.

Categoria: Pesquisa · Slug: `lyrics-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 | Nome da música e/ou artista (ex: 'Bohemian Rhapsody Queen') |

## Resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `title` | `string` | Título da música |
| `artist` | `string` | Nome do artista |
| `lyrics` | `string` | Letra completa da música |
| `url` | `string` | URL da fonte original |

## Exemplo (curl)

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

## Exemplo de resposta

```json
{
		"success": true,
		"data": {
		  "title": "Bohemian Rhapsody",
		  "artist": "Queen",
		  "lyrics": "Is this the real life...",
		  "url": "https://..."
		}
}
```

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.