# Felo ওয়েব অনুসন্ধান

POST /api/v1/data/web/search

ওয়েবে অনুসন্ধান করুন এবং আপনার application-এর process করার জন্য source page গ্রহণ করুন। Source-সহ generated answer পেতে [Chat](https://openapi.felo.ai/bn/docs/data-api/guides/felo-chat.md) ব্যবহার করুন।

সব example-ই [overview](https://openapi.felo.ai/bn/docs/data-api/guides/felo-overview.md) থেকে `FELO_API_KEY` ব্যবহার করে। Call-গুলো **platform balance** ব্যবহার করে, Felo Pro credits নয়। Response example-গুলো illustrative; live content এবং optional field ভিন্ন হতে পারে।

## এন্ডপয়েন্ট

`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-এ ফলাফল ফেরত দেয়:

```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 result আছে—এমন নিশ্চয়তা নয়। এই endpoint-এ কোনো cursor parameter নেই। একটি source পুরোপুরি পড়তে, তার `link` [Web Read](https://openapi.felo.ai/bn/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-কে ফাঁকা successful result থেকে আলাদাভাবে handle করতে হবে; [Billing and Errors](https://openapi.felo.ai/bn/docs/data-api/guides/felo-billing.md) দেখুন।