# Веб-поиск

Находите веб-страницы и возвращайте заголовки, ссылки и фрагменты.

Ищите в вебе и получайте исходные страницы для обработки вашим приложением. Для сгенерированного ответа с источниками используйте [Chat](https://openapi.felo.ai/ru/docs/data-api/guides/felo-chat.md).

Во всех примерах используется `FELO_API_KEY` из [обзора](https://openapi.felo.ai/ru/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` — это запрошенное количество, а не гарантия того, что существует достаточно совпадающих результатов. У этой конечной точки нет параметра курсора. Чтобы прочитать источник целиком, передайте его `link` в [Чтение веб-страниц](https://openapi.felo.ai/ru/docs/data-api/guides/felo-web-read.md).

## Биллинг и сбои

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