# Felo Weblezen

POST /api/v1/data/web/read

Lees een specifieke webpagina in een formaat dat je toepassing kan verwerken.

Alle voorbeelden gebruiken `FELO_API_KEY` uit het [overzicht](https://openapi.felo.ai/nl/docs/data-api/guides/felo-overview.md). Aanroepen gebruiken **platformsaldo**, niet Felo Pro-credits. Reactievoorbeelden zijn illustratief; live inhoud en optionele velden kunnen variëren.

## Eindpunt

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

## Verzoek

| Veld | Type | Vereist | Betekenis |
|---|---|---|---|
| `url` | string | Ja | HTTP- of HTTPS-pagina-URL |
| `formats` | string array | Nee | Precies één van `MARKDOWN`, `TEXT`, `HTML`, `SCREENSHOT`; standaard Markdown |
| `mode` | string | Nee | `quality` (standaard), `fast` of `auto` |
| `timeout` | integer | Nee | Time-out in milliseconden, 1–60.000; standaard 30.000 |
| `totalTimeout` | integer | Nee | Totale time-out in milliseconden, 1–60.000; standaard `timeout` |

Kies één uitvoerformaat per verzoek; stuur niet alle vier in dezelfde 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}'
```

## Reactie

HTTP 200 retourneert het geselecteerde inhoudsveld op de JSON-root. Een Markdown-reactie kan er als volgt uitzien:

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

Lees `markdown`, `text`, `html` of `screenshot` volgens het formaat dat je hebt aangevraagd. Andere metadata is optioneel; vereis niet dat elk formulierveld aanwezig is. Zie het schema `WebReadResponse` in de [OpenAPI-definitie](https://openapi.felo.ai/api/v1/data/openapi.json) voor de volledige reactie.

## Facturering en fouten

`web.read` wordt per verzoek gefactureerd. Een time-out is geen lege pagina: controleer de HTTP-status voordat je de body gebruikt. Schakel na een time-out niet over op herhaalde snelle verzoeken; volg [Facturering en fouten](https://openapi.felo.ai/nl/docs/data-api/guides/felo-billing.md).