> ## 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

> Búsqueda web impulsada por IA con resultados estructurados y puntuados.

Ejecuta una búsqueda web impulsada por IA y devuelve resultados estructurados: URLs, títulos,
autores, fechas, fragmentos destacados y puntuaciones de relevancia.

`POST /global/web-search/v1`

| Campo   | Tipo    | Notas                                   |
| ------- | ------- | --------------------------------------- |
| `query` | string  | **Obligatorio.** De 3 a 300 caracteres. |
| `limit` | integer | De 1 a 25 resultados. Por defecto `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>
  Web Search tiene una cuota más ajustada que otros endpoints: **10 solicitudes por hora**
  por organización. Consulta [Límites de tasa](/es/rate-limits).
</Warning>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, campos de respuesta y un playground interactivo.
</Card>