Pesquisa

Web Search

GET

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.

Endpoint

https://api.misaka.com.br/api/v1/search/web

Testar agora Ver keys

GET /api/v1/search/web

Testar este endpoint

Gere uma API Key no painel para testar

Gerar key

Parâmetros

q string obrigatório

Termo de pesquisa ou pergunta

max integer opcional

Máximo de resultados (1-10, padrão: 5)

Código de exemplo

curl -X GET "https://api.misaka.com.br/api/v1/search/web?q=VALOR&max=VALOR" \
  -H "Authorization: Bearer SUA_API_KEY"

import requests

resp = requests.get(
    "https://api.misaka.com.br/api/v1/search/web",
    params={"q": "VALOR", "max": "VALOR"},
    headers={"Authorization": "Bearer SUA_API_KEY"}
)
print(resp.json())

const params = new URLSearchParams({q: "VALOR", max: "VALOR"});
const resp = await fetch("https://api.misaka.com.br/api/v1/search/web" + "?" + params.toString(), {
  headers: { "Authorization": "Bearer SUA_API_KEY" }
});
const data = await resp.json();
console.log(data);

req, _ := http.NewRequest("GET", "https://api.misaka.com.br/api/v1/search/web?q=VALOR&max=VALOR", nil)
req.Header.Set("Authorization", "Bearer SUA_API_KEY")
resp, _ := http.DefaultClient.Do(req)

$opts = ["http" => [
    "header" => "Authorization: Bearer SUA_API_KEY"
]];
$ctx = stream_context_create($opts);
$resp = file_get_contents("https://api.misaka.com.br/api/v1/search/web?q=VALOR&max=VALOR", false, $ctx);
$data = json_decode($resp, true);

Campos da resposta

results object[]

Lista de resultados com título, URL e descrição

Exemplo de resposta

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

Códigos de erro

401

API key ausente ou inválida

403

Key sem permissão para este endpoint

429

Rate limit excedido

400

Parâmetro obrigatório ausente ou inválido

500

Erro interno do servidor