Synced Lyrics

Parâmetros

Resposta

Exemplo de resposta real

{
		"success": true,
		"data": {
		  "song_title": "Bohemian Rhapsody",
		  "artist_name": "Queen",
		  "album_name": "A Night at the Opera",
		  "duration_seconds": 354,
		  "plain_lyric": "Is this the real life...",
		  "synced_lyrics": "[00:00.00] Is this the real life..."
		}
		}

# Synced Lyrics

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

Pesquisa letras sincronizadas (com timestamps) de uma música no formato LRC. Perfeito para players de música que suportam lyrics sincronizadas.

Categoria: Pesquisa · Slug: `synced-lyrics`

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

## Resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `song_title` | `string` | Título da música |
| `artist_name` | `string` | Nome do artista |
| `album_name` | `string` | Nome do álbum |
| `duration_seconds` | `integer` | Duração total em segundos |
| `plain_lyric` | `string` | Letra sem timestamps (texto puro) |
| `synced_lyrics` | `string` | Letra sincronizada com timestamps no formato LRC |

## Exemplo (curl)

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

## Exemplo de resposta

```json
{
		"success": true,
		"data": {
		  "song_title": "Bohemian Rhapsody",
		  "artist_name": "Queen",
		  "album_name": "A Night at the Opera",
		  "duration_seconds": 354,
		  "plain_lyric": "Is this the real life...",
		  "synced_lyrics": "[00:00.00] Is this the real life..."
		}
		}
```

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.