# جستجوی وب Felo

POST /api/v1/data/web/search

وب را جستجو کنید و صفحات منبع را برای پردازش برنامه‌تان دریافت کنید. برای یک پاسخ تولیدشده همراه با منابع، از [Chat](https://openapi.felo.ai/fa/docs/data-api/guides/felo-chat.md) استفاده کنید.

تمام نمونه‌ها از `FELO_API_KEY` از [نمای کلی](https://openapi.felo.ai/fa/docs/data-api/guides/felo-overview.md) استفاده می‌کنند. تماس‌ها از **موجودی پلتفرم** استفاده می‌کنند، نه اعتبارات Felo Pro. نمونه‌های پاسخ صرفاً نمایشی هستند؛ محتوای زنده و فیلدهای اختیاری متفاوت‌اند.

## پایانه

`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 برمی‌گرداند:

```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` تعداد درخواستی است، نه تضمینی برای وجود نتایج کافیِ منطبق. این پایان‌نقطه پارامتر cursor ندارد. برای خواندن کامل یک منبع، `link` آن را به [خواندن وب](https://openapi.felo.ai/fa/docs/data-api/guides/felo-web-read.md) بدهید.

## صورتحساب و خطاها

واحد صورتحساب یک درخواست (`web.search`) است، نه هر صفحه بازگردانده‌شده. [قیمت‌های فعلی](https://openapi.felo.ai/api/v1/data/prices) را بخوانید. خطای موجودی یا سهمیه باید جدا از یک نتیجه موفق اما خالی مدیریت شود؛ به [صورتحساب و خطاها](https://openapi.felo.ai/fa/docs/data-api/guides/felo-billing.md) مراجعه کنید.