# Webové vyhledávání

Najděte webové stránky a vraťte názvy, odkazy a úryvky.

Vyhledávejte na webu a získejte zdrojové stránky pro zpracování vaší aplikací. Pro generovanou odpověď se zdroji použijte [Chat](https://openapi.felo.ai/cs/docs/data-api/guides/felo-chat.md).

Všechny příklady používají `FELO_API_KEY` z [přehledu](https://openapi.felo.ai/cs/docs/data-api/guides/felo-overview.md). Volání používají **zůstatek platformy**, nikoli Felo Pro credits. Příklady odpovědí jsou ilustrativní; živý obsah a volitelná pole se liší.

## Konečný bod

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

## Požadavek

| Pole | Typ | Povinné | Význam |
|---|---|---|---|
| `query` | string | Ano | Vyhledávací dotaz, 1–4 000 znaků |
| `count` | integer | Ne | Požadovaný počet výsledků, 1–50; výchozí 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}'
```

## Odpověď

HTTP 200 vrací výsledky v kořeni JSON:

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

| Pole | Význam |
|---|---|
| `resources` | Vrácené stránky; každá má `title`, `link` a `snippet` |
| `total` | Počet vrácených zdrojů, nikoli celkový počet stránek na internetu |

`count` je požadovaný počet, nikoli záruka, že existuje dostatek odpovídajících výsledků. Tento koncový bod nemá parametr cursor. Chcete-li si zdroj přečíst celý, předejte jeho `link` do [Web Read](https://openapi.felo.ai/cs/docs/data-api/guides/felo-web-read.md).

## Účtování a selhání

Účtovací jednotkou je jeden požadavek (`web.search`), nikoli jedna vrácená stránka. Přečtěte si [aktuální ceny](https://openapi.felo.ai/api/v1/data/prices). Chybu z důvodu zůstatku nebo kvóty je třeba řešit odděleně od prázdného úspěšného výsledku; viz [Účtování a chyby](https://openapi.felo.ai/cs/docs/data-api/guides/felo-billing.md).