# वेब खोज

वेब पेज खोजें और शीर्षक, लिंक तथा स्निपेट लौटाएँ।

वेब खोजें और अपनी application द्वारा process करने के लिए source pages प्राप्त करें। Sources के साथ generated answer के लिए [Chat](https://openapi.felo.ai/hi/docs/data-api/guides/felo-chat.md) का उपयोग करें।

सभी 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/search`

## अनुरोध

| फ़ील्ड | प्रकार | आवश्यक | अर्थ |
| --- | --- | --- | --- |
| `query` | string | हाँ | खोज क्वेरी, 1–4,000 वर्ण |
| `count` | integer | नहीं | अनुरोधित परिणाम संख्या, 1–50; डिफ़ॉल्ट 10 |

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"retrieval augmented generation","count":3}'
```

## प्रतिक्रिया

HTTP 200 JSON root पर results लौटाता है:

```json
{
  "resources": [
    {"title":"Example guide","link":"https://example.com/guide","snippet":"An introduction to retrieval augmented generation."}
  ],
  "total": 1
}
```

| फ़ील्ड | अर्थ |
| --- | --- |
| `resources` | लौटे हुए पृष्ठ; प्रत्येक में `title`, `link` और `snippet` होता है |
| `total` | लौटे हुए संसाधनों की संख्या, इंटरनेट पर पृष्ठों की कुल संख्या नहीं |

`count` requested count है, यह इस बात की गारंटी नहीं कि पर्याप्त matching results मौजूद हैं। इस endpoint में cursor parameter नहीं है। किसी source को पूरा पढ़ने के लिए, उसका `link` [Web Read](https://openapi.felo.ai/hi/docs/data-api/guides/felo-web-read.md) को दें।

## बिलिंग और विफलताएँ

Billing unit एक request (`web.search`) है, एक लौटाए गए page की नहीं। [current prices](https://openapi.felo.ai/api/v1/data/prices) पढ़ें। Balance या quota error को empty successful result से अलग handle करना चाहिए; [Billing and Errors](https://openapi.felo.ai/hi/docs/data-api/guides/felo-billing.md) देखें।