# Recherche Web Felo

POST /api/v1/data/web/search

Recherchez le web et recevez des pages sources que votre application pourra traiter. Pour une réponse générée avec sources, utilisez [Chat](https://openapi.felo.ai/fr/docs/data-api/guides/felo-chat.md).

Tous les exemples utilisent `FELO_API_KEY` depuis l'[aperçu](https://openapi.felo.ai/fr/docs/data-api/guides/felo-overview.md). Les appels utilisent **le solde de plateforme**, et non les crédits Felo Pro. Les exemples de réponse sont illustratifs ; le contenu réel et les champs facultatifs varient.

## Point de terminaison

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

## Requête

| Champ | Type | Requis | Signification |
|---|---|---|---|
| `query` | string | Oui | Requête de recherche, 1–4 000 caractères |
| `count` | integer | Non | Nombre de résultats demandé, 1–50 ; 10 par défaut |

```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}'
```

## Réponse

HTTP 200 renvoie les résultats à la racine JSON :

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

| Champ | Signification |
|---|---|
| `resources` | Pages renvoyées ; chacune comporte `title`, `link` et `snippet` |
| `total` | Nombre de ressources renvoyées, pas le nombre total de pages sur Internet |

`count` est le nombre demandé, pas une garantie qu'il existe suffisamment de résultats correspondants. Ce point de terminaison n'a pas de paramètre de curseur. Pour lire une source en entier, passez son `link` à [Lecture Web](https://openapi.felo.ai/fr/docs/data-api/guides/felo-web-read.md).

## Facturation et échecs

L'unité de facturation est une requête (`web.search`), pas une page retournée. Lisez les [prix actuels](https://openapi.felo.ai/api/v1/data/prices). Une erreur de solde ou de quota doit être traitée séparément d'un résultat vide réussi ; consultez [Facturation et erreurs](https://openapi.felo.ai/fr/docs/data-api/guides/felo-billing.md).