# वेब रीड

किसी URL को Markdown, text, HTML या screenshot के रूप में पढ़ें।

किसी विशेष web page को ऐसे format में पढ़ें जिसे आपकी application consume कर सके।

सभी examples [overview](https://openapi.felo.ai/hi/docs/data-api/guides/felo-overview.md) से `FELO_API_KEY` का उपयोग करते हैं। Calls **platform balance** का उपयोग करती हैं, Felo Pro credits का नहीं। Response examples केवल illustrative हैं; 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": {}
}
```

आपने जो format request किया है उसके अनुसार `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 पर switch न करें; [Billing and Errors](https://openapi.felo.ai/hi/docs/data-api/guides/felo-billing.md) का पालन करें।