# Felo ویب مطالعہ

POST /api/v1/data/web/read

کسی خاص ویب page کو ایسے format میں پڑھیں جسے آپ کی application استعمال کر سکے۔

تمام examples، [overview](https://openapi.felo.ai/ur/docs/data-api/guides/felo-overview.md) سے `FELO_API_KEY` استعمال کرتے ہیں۔ Calls **platform balance** استعمال کرتی ہیں، Felo Pro credits نہیں۔ Response examples صرف وضاحتی ہیں؛ live content اور optional fields مختلف ہو سکتے ہیں۔

## نقطۂ اختتام

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

## درخواست

| فیلڈ | قسم | لازمی | معنی |
| --- | --- | --- | --- |
| `url` | string | ہاں | HTTP یا HTTPS صفحہ URL |
| `formats` | سٹرنگ ارے | نہیں | `MARKDOWN`، `TEXT`، `HTML`، `SCREENSHOT` میں سے صرف ایک؛ طے شدہ Markdown |
| `mode` | string | نہیں | `quality` (طے شدہ)، `fast` یا `auto` |
| `timeout` | integer | نہیں | ملی سیکنڈز میں وقفۂ انتظار، 1–60,000؛ طے شدہ 30,000 |
| `totalTimeout` | integer | نہیں | ملی سیکنڈز میں مجموعی وقفۂ انتظار، 1–60,000؛ طے شدہ `timeout` |

ہر request میں ایک output format منتخب کریں؛ ایک ہی 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}'
```

## جواب

HTTP 200 JSON root پر منتخب کردہ content field واپس کرتا ہے۔ ایک Markdown response اس طرح ہو سکتا ہے:

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

اپنے requested format کے مطابق `markdown`، `text`، `html` یا `screenshot` پڑھیں۔ دوسری metadata optional ہے؛ یہ ضروری نہ سمجھیں کہ ہر format field موجود ہو۔ مکمل response کے لیے [OpenAPI definition](https://openapi.felo.ai/api/v1/data/openapi.json) میں `WebReadResponse` schema دیکھیں۔

## بلنگ اور ناکامیاں

`web.read` کی بلنگ فی request ہوتی ہے۔ timeout خالی page نہیں ہوتا: body استعمال کرنے سے پہلے HTTP status چیک کریں۔ timeout کے بعد بار بار تیز requests پر نہ جائیں؛ [Billing and Errors](https://openapi.felo.ai/ur/docs/data-api/guides/felo-billing.md) کی پیروی کریں۔