> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API de resultados do Brave Search

> Retorna, para uma consulta, resultados orgânicos do índice próprio do Brave, FAQ, painel de conhecimento, notícias, vídeos, discussões e locais.

`BRAVE_SEARCH` abre a página de resultados do Brave com uma consulta e retorna resultados orgânicos, anúncios, FAQ, o painel de conhecimento, notícias, vídeos, discussões, locais e buscas relacionadas. O Brave responde do próprio índice e renderiza a página no servidor, então os resultados chegam com a página e nenhum navegador roda.

| | |
| - | - |
| `taskType` | `BRAVE_SEARCH` |
| Entrada | `query` ou `prompt` (obrigatório), até 600 caracteres e 75 palavras; `country`, `lang`, `safesearch`, `freshness`, `page` |
| Créditos | 0.3 por tarefa |
| País | Padrão `US`. Os mercados do Brave estão abaixo. |
| Localização | Não suportada (`422 LOCATION_UNSUPPORTED`). |

## Requisição

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "BRAVE_SEARCH", "payload": { "query": "como funciona uma bomba de calor no frio", "country": "PT" } }'
```

A tarefa roda de forma assíncrona. Leia o resultado como descrito em [Tarefas assíncronas](https://docs.querying.ai/pt/concepts/async-tasks.md).

## Parâmetros

| Campo | Obrigatório | Descrição |
| - | - | - |
| `query` | Sim, ou `prompt` | A consulta, até 600 caracteres e 75 palavras. |
| `prompt` | Sim, ou `query` | Aceito quando falta `query`. Se ambos vierem, `BRAVE_SEARCH` lê `query`. |
| `country` | Não | O mercado a buscar: `AR`, `AU`, `AT`, `BE`, `BR`, `CA`, `CL`, `DK`, `FI`, `FR`, `DE`, `GR`, `HK`, `IN`, `ID`, `IT`, `JP`, `KR`, `MY`, `MX`, `NL`, `NZ`, `NO`, `CN`, `PL`, `PT`, `PH`, `RU`, `SA`, `ZA`, `ES`, `SE`, `CH`, `TW`, `TR`, `GB`, `US` ou `ALL`. Padrão `US`; `ALL` busca em todos os mercados. |
| `lang` | Não | O idioma dos resultados, um código do Brave como `en`, `ko`, `ja`, `de`, `pt-br` ou `zh-hant`. Padrão é o idioma do país. |
| `safesearch` | Não | `off`, `moderate` (padrão) ou `strict`. |
| `freshness` | Não | `pd` (último dia), `pw` (última semana), `pm` (último mês), `py` (último ano), ou um intervalo `YYYY-MM-DDtoYYYY-MM-DD`. |
| `page` | Não | Página de resultados, 1 a 10. Cada página traz até 20 resultados e o Brave avança pouco, então páginas vizinhas se sobrepõem. |

## Resposta

Cada bloco que a resposta traz é incluído; o que falta é omitido.

```json theme={"theme":"css-variables"}
{
  "organicResults": [
    { "position": 1, "title": "...", "link": "https://...", "snippet": "...", "date": "2026-11-13T04:00:00.000Z", "siteName": "...", "extraSnippets": ["..."] }
  ],
  "ads": [{ "position": 1, "title": "...", "link": "https://...", "description": "...", "displayedLink": "..." }],
  "peopleAlsoAsk": [{ "question": "...", "snippet": "...", "link": "https://..." }],
  "knowledgeGraph": { "title": "...", "type": "...", "description": "...", "attributes": [{ "key": "...", "value": "..." }], "profiles": ["https://..."] },
  "topStories": [{ "title": "...", "link": "https://...", "source": "...", "date": "2 days ago", "snippet": "..." }],
  "videoResults": [{ "title": "...", "link": "https://...", "platform": "...", "duration": "1:02", "views": 1234 }],
  "discussions": [{ "position": 1, "title": "...", "link": "https://...", "source": "...", "question": "...", "topComment": "..." }],
  "locations": [{ "position": 1, "title": "...", "link": "https://...", "address": "...", "coordinates": { "latitude": 37.5, "longitude": 127 } }],
  "alteredQuery": "...",
  "relatedSearches": [{ "query": "...", "link": "https://..." }],
  "moreResultsAvailable": true,
  "page": 1
}
```

| Campo | Descrição |
| - | - |
| `organicResults` | Sempre presente. `position` conta a partir de 1 em cada página. `snippet` é a descrição do Brave com a marcação intacta. `date` traz a data que a página imprime antes do trecho. `siteName` é o nome do editor. |
| `ads` | Anúncios, com o `link` de destino do anunciante e o `displayedLink` exibido. O Brave os coloca entre os resultados orgânicos, o que mantém a `position`. |
| `peopleAlsoAsk` | O bloco de FAQ do Brave: `question`, a resposta como `snippet` e a página de origem. |
| `knowledgeGraph` | O painel de conhecimento: título, categoria, descrição, os dados da entidade em `attributes` e seus `profiles` (páginas oficiais). |
| `topStories` | Notícias. `date` são as palavras do Brave ("2 days ago"). |
| `videoResults` | Vídeos, com `platform`, `channel`, `duration` e `views`. |
| `discussions` | Tópicos de fórum, com a `question` do tópico e seu `topComment` quando o Brave os traz. |
| `locations` | Locais de uma consulta local: `address`, `coordinates`, `phoneNumber`, `openingHours` e o `link` do provedor. |
| `alteredQuery` | Presente quando o corretor do Brave trocou a consulta antes da busca. |
| `relatedSearches` | As buscas relacionadas do Brave, com o `link` que executa cada uma. |
| `moreResultsAvailable` | `true` quando há resultados além desta página. |
| `page` | A página retornada. |

Não há payload HTML, então `include` nada acrescenta.

Os termos da API do Brave limitam o armazenamento de resultados da API além do necessário para operar um app. Agora a página é lida, o alcance é outro, e a resposta do Brave é necessária antes de guardá-los.

## Limites e erros

* Uma consulta com mais de 600 caracteres ou 75 palavras retorna `422 VALIDATION_ERROR` no envio.
* Um `country` fora da lista, um `lang` desconhecido, um `safesearch` fora dos três valores, um `freshness` malformado ou uma `page` fora de 1 a 10 retornam `422 VALIDATION_ERROR`.
* Uma requisição limitada pelo Brave responde `BRAVE_HTTP_429` após nova tentativa em outro endereço. `BRAVE_UNEXPECTED_PAGE` significa uma página que este motor não lê, e `BRAVE_TIMEOUT` que não houve resposta a tempo.
* Outros erros de requisição estão em [Erros](https://docs.querying.ai/pt/concepts/errors.md).

## Relacionado

* [Bing Search](https://docs.querying.ai/pt/engines/bing-search.md) para a página de resultados do Bing e seu resumo de IA
* [Scrape](https://docs.querying.ai/pt/engines/web-scrape.md) para ler a página inteira de um resultado


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.