# Вебпошук

Знаходьте вебсторінки та повертайте заголовки, посилання й фрагменти.

Шукайте у вебі та отримуйте вихідні сторінки для обробки вашим застосунком. Для згенерованої відповіді з джерелами використовуйте [Chat](https://openapi.felo.ai/uk/docs/data-api/guides/felo-chat.md).

У всіх прикладах використовується `FELO_API_KEY` з [огляду](https://openapi.felo.ai/uk/docs/data-api/guides/felo-overview.md). Виклики використовують **баланс платформи**, а не кредити Felo Pro. Приклади відповідей є ілюстративними; живий контент і необов’язкові поля можуть відрізнятися.

## Кінцева точка

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

## Запит

| Поле | Тип | Обов’язкове | Значення |
|---|---|---|---|
| `query` | string | Так | Пошуковий запит, 1–4,000 символів |
| `count` | integer | Ні | Запитана кількість результатів, 1–50; за замовчуванням 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}'
```

## Відповідь

HTTP 200 повертає результати в корені JSON:

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

| Поле | Значення |
|---|---|
| `resources` | Повернуті сторінки; кожна має `title`, `link` і `snippet` |
| `total` | Кількість повернутих ресурсів, а не загальна кількість сторінок в інтернеті |

`count` — це запитана кількість, а не гарантія того, що існує достатньо відповідних результатів. У цієї кінцевої точки немає параметра cursor. Щоб прочитати джерело повністю, передайте його `link` у [Web Read](https://openapi.felo.ai/uk/docs/data-api/guides/felo-web-read.md).

## Білінг і збої

Одиниця білінгу — один запит (`web.search`), а не одна повернута сторінка. Дивіться [поточні ціни](https://openapi.felo.ai/api/v1/data/prices). Помилку балансу або квоти потрібно обробляти окремо від порожнього успішного результату; дивіться [Білінг і помилки](https://openapi.felo.ai/uk/docs/data-api/guides/felo-billing.md).