> ## 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 de Brave Search

> Devuelve, para una consulta, resultados orgánicos del índice propio de Brave, FAQ, panel de conocimiento, noticias, vídeos, debates y lugares.

`BRAVE_SEARCH` abre la página de resultados de Brave con una consulta y devuelve resultados orgánicos, anuncios, FAQ, el panel de conocimiento, noticias, vídeos, debates, lugares y búsquedas relacionadas. Brave responde desde su propio índice y renderiza la página en el servidor, así que los resultados llegan con la página y no se ejecuta un navegador.

| | |
| - | - |
| `taskType` | `BRAVE_SEARCH` |
| Entrada | `query` o `prompt`(obligatorio), hasta 600 caracteres y 75 palabras; `country`, `lang`, `safesearch`, `freshness`, `page` |
| Créditos | 0.3 por tarea |
| País | Valor por defecto `US`. Los mercados de Brave están abajo. |
| Ubicación | No compatible(`422 LOCATION_UNSUPPORTED`). |

## Solicitud

```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": "cómo funciona una bomba de calor en clima frío", "country": "ES" } }'
```

La tarea se ejecuta de forma asíncrona. Lea el resultado como se describe en [Tareas asíncronas](https://docs.querying.ai/es/concepts/async-tasks.md).

## Parámetros

| Campo | Obligatorio | Descripción |
| - | - | - |
| `query` | Sí, o `prompt` | La consulta, hasta 600 caracteres y 75 palabras. |
| `prompt` | Sí, o `query` | Se acepta cuando falta `query`. Si llegan ambos, `BRAVE_SEARCH` lee `query`. |
| `country` | No | El 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` o `ALL`. Por defecto `US`; `ALL` busca en todos los mercados. |
| `lang` | No | El idioma de los resultados, un código de Brave como `en`, `ko`, `ja`, `de`, `pt-br` o `zh-hant`. Por defecto, el idioma del país. |
| `safesearch` | No | `off`, `moderate` (por defecto) o `strict`. |
| `freshness` | No | `pd` (último día), `pw` (última semana), `pm` (último mes), `py` (último año), o un rango `YYYY-MM-DDtoYYYY-MM-DD`. |
| `page` | No | Página de resultados, 1 a 10. Cada página lleva hasta 20 resultados y Brave avanza poco, así que las páginas vecinas se solapan. |

## Respuesta

Se incluye cada bloque que trae la respuesta; el que no trae, se omite.

```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 | Descripción |
| - | - |
| `organicResults` | Siempre presente. `position` cuenta desde 1 en cada página. `snippet` es la descripción de Brave con su marcado intacto. `date` recoge la fecha que la página imprime delante del extracto. `siteName` es el nombre del editor. |
| `ads` | Anuncios, con el `link` de destino del anunciante y el `displayedLink` mostrado. Brave los coloca entre los resultados orgánicos, lo que conserva su `position`. |
| `peopleAlsoAsk` | El bloque de FAQ de Brave: `question`, la respuesta como `snippet` y la página de la que sale. |
| `knowledgeGraph` | El panel de conocimiento: título, categoría, descripción, los datos de la entidad en `attributes` y sus `profiles` (páginas oficiales). |
| `topStories` | Noticias. `date` son las palabras de Brave ("2 days ago"). |
| `videoResults` | Vídeos, con `platform`, `channel`, `duration` y `views`. |
| `discussions` | Hilos de foro, con la `question` del hilo y su `topComment` cuando Brave los trae. |
| `locations` | Lugares para una consulta de ubicación: `address`, `coordinates`, `phoneNumber`, `openingHours` y el `link` del proveedor. |
| `alteredQuery` | Presente cuando el corrector de Brave cambió la consulta antes de buscar. |
| `relatedSearches` | Las búsquedas relacionadas de Brave, con el `link` que ejecuta cada una. |
| `moreResultsAvailable` | `true` cuando hay resultados más allá de esta página. |
| `page` | La página devuelta. |

No hay payload HTML, así que `include` no añade nada.

Los términos de la API de Brave limitan guardar resultados de la API más allá de lo que exige operar una app. Ahora se lee la página, así que el alcance es otro, y la respuesta de Brave hace falta antes de conservarlos.

## Límites y errores

* Una consulta de más de 600 caracteres o 75 palabras devuelve `422 VALIDATION_ERROR` al enviarla.
* Un `country` fuera de la lista, un `lang` desconocido, un `safesearch` fuera de los tres valores, un `freshness` mal formado o una `page` fuera de 1 a 10 devuelven `422 VALIDATION_ERROR`.
* Una petición limitada por Brave responde `BRAVE_HTTP_429` tras reintentar en otra dirección. `BRAVE_UNEXPECTED_PAGE` significa que Brave respondió con una página que este motor no lee, y `BRAVE_TIMEOUT` que no respondi�� a tiempo.
* Otros errores de petición están en [Errores](https://docs.querying.ai/es/concepts/errors.md).

## Relacionado

* [Bing Search](https://docs.querying.ai/es/engines/bing-search.md) para la página de resultados de Bing y su resumen de IA
* [Scrape](https://docs.querying.ai/es/engines/web-scrape.md) para leer la página entera de un resultado


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