Lyrics Search

Parâmetros

Resposta

Exemplo de resposta real

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

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