# Читання вебсторінки

Читайте URL у форматі Markdown, тексту, HTML або знімка екрана.

Читайте конкретну вебсторінку у форматі, який може споживати ваш застосунок.

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

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

`POST /api/v1/data/web/read`

## Запит

| Поле | Тип | Обов’язкове | Значення |
|---|---|---|---|
| `url` | string | Так | URL сторінки HTTP або HTTPS |
| `formats` | масив string | Ні | Рівно один із `MARKDOWN`, `TEXT`, `HTML`, `SCREENSHOT`; за замовчуванням Markdown |
| `mode` | string | Ні | `quality` (за замовчуванням), `fast` або `auto` |
| `timeout` | integer | Ні | Тайм-аут у мілісекундах, 1–60,000; за замовчуванням 30,000 |
| `totalTimeout` | integer | Ні | Загальний тайм-аут у мілісекундах, 1–60,000; за замовчуванням `timeout` |

Оберіть один формат виводу на запит; не надсилайте всі чотири в одному масиві.

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/read" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","formats":["MARKDOWN"],"mode":"quality","timeout":30000}'
```

## Відповідь

HTTP 200 повертає вибране поле вмісту в корені JSON. Відповідь Markdown може виглядати так:

```json
{
  "title": "Example Domain",
  "markdown": "# Example Domain\n\nThis domain is for use in documentation examples.",
  "metadata": {}
}
```

Читайте `markdown`, `text`, `html` або `screenshot` відповідно до запитаного формату. Інші метадані є необов’язковими; не вимагайте, щоб були присутні всі поля форматів. Повну відповідь дивіться у схемі `WebReadResponse` в [визначенні OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json).

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

`web.read` оплачується за запит. Тайм-аут — це не порожня сторінка: перевіряйте HTTP-статус перед використанням тіла. Після тайм-ауту не переходьте до повторних швидких запитів; дотримуйтеся [Білінг і помилки](https://openapi.felo.ai/uk/docs/data-api/guides/felo-billing.md).