# Web zoeken

Zoek webpagina's en geef titels, links en snippets terug.

Zoek het web en ontvang bronpagina's voor je toepassing om te verwerken. Gebruik voor een gegenereerd antwoord met bronnen [Chat](https://openapi.felo.ai/nl/docs/data-api/guides/felo-chat.md).

Alle voorbeelden gebruiken `FELO_API_KEY` uit het [overzicht](https://openapi.felo.ai/nl/docs/data-api/guides/felo-overview.md). Aanroepen gebruiken **platformsaldo**, niet Felo Pro-credits. Reactievoorbeelden zijn illustratief; live inhoud en optionele velden kunnen variëren.

## Eindpunt

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

## Verzoek

| Veld | Type | Vereist | Betekenis |
|---|---|---|---|
| `query` | string | Ja | Zoekopdracht, 1–4.000 tekens |
| `count` | integer | Nee | Gevraagde resultaataantal, 1–50; standaard 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}'
```

## Reactie

HTTP 200 retourneert de resultaten op de JSON-root:

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

| Veld | Betekenis |
|---|---|
| `resources` | Teruggegeven pagina's; elke heeft `title`, `link` en `snippet` |
| `total` | Aantal teruggegeven resources, niet het totale aantal pagina's op internet |

`count` is het gevraagde aantal, geen garantie dat er genoeg overeenkomende resultaten bestaan. Dit eindpunt heeft geen cursorparameter. Om een bron volledig te lezen, geef je `link` door aan [Weblezen](https://openapi.felo.ai/nl/docs/data-api/guides/felo-web-read.md).

## Facturering en fouten

De factureringseenheid is één verzoek (`web.search`), niet één teruggegeven pagina. Lees de [huidige prijzen](https://openapi.felo.ai/api/v1/data/prices). Een saldo- of quotafout moet apart worden afgehandeld van een lege succesvolle reactie; zie [Facturering en fouten](https://openapi.felo.ai/nl/docs/data-api/guides/felo-billing.md).