# Felo वेब रीड

POST /api/v1/data/web/read

किसी विशेष 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) का पालन करें।