Web Search — Nyqo API

Requisição

curl "https://api.nyqo.dev/api/v1/search/web?q=exemplo%20de%20busca&max=5" \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 pergunta
`max`	`integer`	não	Máximo de resultados (1-10, padrão: 5)

Resposta

Campo	Tipo	Descrição
`results`	`object[]`	Lista de resultados com título, URL e descrição

Exemplo de resposta real

{
		"success": true,
		"data": [
		  {"position": 1, "title": "Exemplo", "url": "https://exemplo.com", "description": "Descrição do resultado"}
		]
}

Levar essa referência para o seu agente/LLM

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

# Web Search

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

Pesquisa na web via DuckDuckGo e retorna resultados orgânicos. Ideal para buscar informações, notícias e sites sem necessidade de usar o Google. Retorna título, URL e descrição de cada resultado.

Categoria: Pesquisa · Slug: `web-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 pergunta |
| `max` | `integer` | não | Máximo de resultados (1-10, padrão: 5) |

## Resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `results` | `object[]` | Lista de resultados com título, URL e descrição |

## Exemplo (curl)

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

## Exemplo de resposta

```json
{
		"success": true,
		"data": [
		  {"position": 1, "title": "Exemplo", "url": "https://exemplo.com", "description": "Descrição do resultado"}
		]
}
```

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.