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

# Web Search

> Execute uma busca na web impulsionada por IA pela API da Croma e receba resultados estruturados: URLs, títulos, autores, datas, trechos e pontuações.

Executa uma busca na web impulsionada por IA e retorna resultados estruturados: URLs, títulos,
autores, datas, trechos em destaque e pontuações de relevância.

`POST /global/web-search/v1`

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | **Obrigatório.** De 3 a 300 caracteres. |
| `limit` | integer | De 1 a 25 resultados. Padrão `10`. |

```bash theme={"dark"}
curl https://api.croma.run/global/web-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "croma api colombia", "limit": 10 }'
```

<Warning>
  No plano gratuito, o Web Search tem um teto de **100 solicitações por hora**
  por organização. Os planos pagos não têm teto por hora: cada chamada consome
  10 créditos do plano. Consulte [Limites de taxa](/pt/rate-limits).
</Warning>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, campos de resposta e um playground interativo.
</Card>


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