YouTube Search — Nyqo API

Requisição

curl "https://api.nyqo.dev/api/v1/youtube/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 ou frase-chave

Resposta

Campo	Tipo	Descrição
`video_id`	`string`	ID único do vídeo no YouTube
`url`	`string`	URL completa do vídeo
`title`	`string`	Título do vídeo
`thumbnail`	`string`	URL da thumbnail em alta resolução
`duration`	`integer`	Duração do vídeo em segundos
`views`	`integer`	Número de visualizações
`author`	`string`	Nome do canal

Exemplo de resposta real

{
	 "success": true,
	 "data": {
	   "video_id": "dQw4w9WgXcQ",
	   "url": "https://youtube.com/watch?v=dQw4w9WgXcQ",
	   "title": "Título do vídeo",
	   "thumbnail": "https://i.ytimg.com/...",
	   "duration": 212,
	   "views": 1000000,
	   "author": "Canal"
	 }
}

Levar essa referência para o seu agente/LLM

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

# YouTube Search

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

Pesquisa vídeos no YouTube por palavra-chave. Retorna informações detalhadas incluindo duração, visualizações e thumbnail. Útil para encontrar vídeos relacionados a um tema.

Categoria: Downloads · Slug: `youtube-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 ou frase-chave |

## Resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `video_id` | `string` | ID único do vídeo no YouTube |
| `url` | `string` | URL completa do vídeo |
| `title` | `string` | Título do vídeo |
| `thumbnail` | `string` | URL da thumbnail em alta resolução |
| `duration` | `integer` | Duração do vídeo em segundos |
| `views` | `integer` | Número de visualizações |
| `author` | `string` | Nome do canal |

## Exemplo (curl)

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

## Exemplo de resposta

```json
{
	 "success": true,
	 "data": {
	   "video_id": "dQw4w9WgXcQ",
	   "url": "https://youtube.com/watch?v=dQw4w9WgXcQ",
	   "title": "Título do vídeo",
	   "thumbnail": "https://i.ytimg.com/...",
	   "duration": 212,
	   "views": 1000000,
	   "author": "Canal"
	 }
}
```

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.