# Ricerca Web Felo

POST /api/v1/data/web/search

Cerca nel web e ricevi pagine sorgente da elaborare nella tua applicazione. Per una risposta generata con fonti, usa [Chat](https://openapi.felo.ai/it/docs/data-api/guides/felo-chat.md).

Tutti gli esempi usano `FELO_API_KEY` dalla [panoramica](https://openapi.felo.ai/it/docs/data-api/guides/felo-overview.md). Le chiamate usano **il saldo della piattaforma**, non i crediti Felo Pro. Gli esempi di risposta sono illustrativi; il contenuto live e i campi opzionali variano.

## Endpoint

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

## Richiesta

| Campo | Tipo | Obbligatorio | Significato |
|---|---|---|---|
| `query` | string | Sì | Query di ricerca, 1–4.000 caratteri |
| `count` | integer | No | Numero di risultati richiesti, 1–50; predefinito 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}'
```

## Risposta

HTTP 200 restituisce i risultati alla radice JSON:

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

| Campo | Significato |
|---|---|
| `resources` | Pagine restituite; ciascuna ha `title`, `link` e `snippet` |
| `total` | Numero di risorse restituite, non il numero totale di pagine su internet |

`count` è il numero richiesto, non una garanzia che esistano abbastanza risultati corrispondenti. Questo endpoint non ha un parametro cursor. Per leggere una fonte per intero, passa il suo `link` a [Lettura Web](https://openapi.felo.ai/it/docs/data-api/guides/felo-web-read.md).

## Fatturazione ed errori

L'unità di fatturazione è una richiesta (`web.search`), non una pagina restituita. Leggi i [prezzi attuali](https://openapi.felo.ai/api/v1/data/prices). Un errore di saldo o quota deve essere gestito separatamente da un risultato vuoto ma riuscito; vedi [Fatturazione ed errori](https://openapi.felo.ai/it/docs/data-api/guides/felo-billing.md).