# Búsqueda web

Encuentra páginas web y devuelve títulos, enlaces y fragmentos.

Busca en la web y recibe páginas fuente para que tu aplicación las procese. Para una respuesta generada con fuentes, usa [Chat](https://openapi.felo.ai/es/docs/data-api/guides/felo-chat.md).

Todos los ejemplos usan `FELO_API_KEY` de la [vista general](https://openapi.felo.ai/es/docs/data-api/guides/felo-overview.md). Las llamadas usan **saldo de la plataforma**, no créditos Felo Pro. Los ejemplos de respuesta son ilustrativos; el contenido en vivo y los campos opcionales varían.

## Endpoint

`POST /api/v1/data/web/search`

## Solicitud

| Campo | Tipo | Requerido | Significado |
|---|---|---|---|
| `query` | string | Sí | Consulta de búsqueda, de 1 a 4.000 caracteres |
| `count` | integer | No | Cantidad de resultados solicitada, de 1 a 50; valor predeterminado 10 |

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"retrieval augmented generation","count":3}'
```

## Respuesta

HTTP 200 devuelve los resultados en la raíz JSON:

```json
{
  "resources": [
    {"title":"Example guide","link":"https://example.com/guide","snippet":"An introduction to retrieval augmented generation."}
  ],
  "total": 1
}
```

| Campo | Significado |
|---|---|
| `resources` | Páginas devueltas; cada una tiene `title`, `link` y `snippet` |
| `total` | Número de recursos devueltos, no el número total de páginas en Internet |

`count` es la cantidad solicitada, no una garantía de que existan suficientes resultados coincidentes. Este endpoint no tiene parámetro cursor. Para leer una fuente completa, pasa su `link` a [Lectura web](https://openapi.felo.ai/es/docs/data-api/guides/felo-web-read.md).

## Facturación y fallos

La unidad de facturación es una solicitud (`web.search`), no una página devuelta. Lee los [precios actuales](https://openapi.felo.ai/api/v1/data/prices). Un error de saldo o cuota debe manejarse por separado de un resultado vacío exitoso; consulta [Facturación y errores](https://openapi.felo.ai/es/docs/data-api/guides/felo-billing.md).