# ویب مطالعہ

کسی URL کو Markdown، متن، HTML یا screenshot کے طور پر پڑھیں۔

کسی خاص ویب 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) کی پیروی کریں۔