https://api.nyqo.dev/api/v1/youtube/searchYouTube 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.
Slug youtube-search· requer autenticação nyq_· erros padrão em /docs
Playground
modo demoExecute esta API agora, sem instalar nada. A chamada sai do seu navegador para a Nyqo (mesma origem) usando uma chave sua — a resposta aparece aqui embaixo, formatada.
Use uma chave sua, criada no painel. Ela fica só na memória desta página, vai direto para a Nyqo e nunca aparece no resultado —não compartilhe nem cole sua chave em sites de terceiros. Gerencie em Minhas chaves.
Entre na sua conta para testar esta API
O playground funciona com uma chave da sua conta. Criar a conta leva menos de um minuto.
Esta API não está nos seus pacotes atuais
Para executar esta chamada, contrate um pacote que inclua esta API — ou troque pelos pacotes que já têm ela.
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 API ou chave fora do escopo. Veja planos. - ·
429 rate_limited— usos esgotados ou velocidade acima do limite; aguarde oRetry-After. Detalhes em limites de uso.
Tabela completa em /docs — códigos de erro.