# Lettura Web Felo

POST /api/v1/data/web/read

Leggi una pagina web specifica in un formato che la tua applicazione può consumare.

Tutti gli esempi usano `FELO_API_KEY` dalla [panoramica](https://openapi.felo.ai/it/docs/data-api/guides/felo-overview.md). Le chiamate usano **il saldo della piattaforma**, non i crediti Felo Pro. Gli esempi di risposta sono illustrativi; il contenuto live e i campi opzionali variano.

## Endpoint

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

## Richiesta

| Campo | Tipo | Obbligatorio | Significato |
|---|---|---|---|
| `url` | string | Sì | URL della pagina HTTP o HTTPS |
| `formats` | array di stringhe | No | Esattamente uno tra `MARKDOWN`, `TEXT`, `HTML`, `SCREENSHOT`; predefinito Markdown |
| `mode` | string | No | `quality` (predefinito), `fast` o `auto` |
| `timeout` | integer | No | Timeout in millisecondi, 1–60.000; predefinito 30.000 |
| `totalTimeout` | integer | No | Timeout totale in millisecondi, 1–60.000; predefinito `timeout` |

Scegli un solo formato di output per richiesta; non inviare tutti e quattro nello stesso array.

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

## Risposta

HTTP 200 restituisce il campo di contenuto selezionato alla radice JSON. Una risposta Markdown può essere simile a questa:

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

Leggi `markdown`, `text`, `html` o `screenshot` in base al formato richiesto. Altri metadati sono opzionali; non richiedere che ogni campo di formato sia presente. Consulta lo schema `WebReadResponse` nella [definizione OpenAPI](https://openapi.felo.ai/api/v1/data/openapi.json) per la risposta completa.

## Fatturazione ed errori

`web.read` è fatturato per richiesta. Un timeout non è una pagina vuota: controlla lo stato HTTP prima di usare il body. Non passare a richieste rapide ripetute dopo un timeout; segui [Fatturazione ed errori](https://openapi.felo.ai/it/docs/data-api/guides/felo-billing.md).