# Felo वेब खोज

POST /api/v1/data/web/search

वेब खोजें और अपनी 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) देखें।