جستجوی وب
ارائه‌دهنده: Felo · پرداخت با موجودی پلتفرم
وب را جستجو کنید و صفحات منبع را برای پردازش برنامه‌تان دریافت کنید. برای یک پاسخ تولیدشده همراه با منابع، از Chat استفاده کنید.
تمام نمونه‌ها از FELO_API_KEY از نمای کلی استفاده می‌کنند. تماس‌ها از موجودی پلتفرم استفاده می‌کنند، نه اعتبارات Felo Pro. نمونه‌های پاسخ صرفاً نمایشی هستند؛ محتوای زنده و فیلدهای اختیاری متفاوت‌اند.
پایانه
POST /api/v1/data/web/search
درخواست
| فیلد | نوع | الزامی | معنا |
|---|---|---|---|
query | string | بله | پرس‌وجوی جستجو، 1 تا 4,000 نویسه |
count | integer | خیر | تعداد نتیجه درخواستی، 1 تا 50؛ پیش‌فرض 10 |
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 برمی‌گرداند:
{
"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 آن را به خواندن وب بدهید.
صورتحساب و خطاها
واحد صورتحساب یک درخواست (web.search) است، نه هر صفحه بازگردانده‌شده. قیمت‌های فعلی را بخوانید. خطای موجودی یا سهمیه باید جدا از یک نتیجه موفق اما خالی مدیریت شود؛ به صورتحساب و خطاها مراجعه کنید.