Scholar Search
Scholarly and web search with result explanations.
البحث على الويب
ابحث في الويب المفتوح واحصل على قائمة نتائج موجزة. ⚠️ رغم أنه POST، تذهب المعاملات في سلسلة الاستعلام — query (مطلوب)، وmax_num_results (الافتراضي 10، والحد الأقصى 100)، وas_ylo/as_yhi لنطاق سنة. لا يُقبل جسم JSON. يعيد id بحث وresults[] تحمل فقط title وlink وsnippet. ميزته قلّة ما يعيده، ما يناسب وكيلًا يحتاج فقط إلى معرفة ما هو موجود. لا يمنحك نص الصفحة — إذا احتجت إلى المحتوى، يعيده searchWeb في الاستدعاء نفسه. احتفظ بـid: فهو ما يحتاجه post_scholar_search_explain.
مرجع التسعير
- القياس: أساس تكلفة ثابت لكل طلب ناجح.
- تقدير الطلب المرجعي: 0.01 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: integer | nullas
_yhi الحد الأدنى:1900الحد الأقصى:2030الحد الأعلى لسنة النشر
- النوع: integer | nullas
_ylo الحد الأدنى:1900الحد الأقصى:2030الحد الأدنى لسنة النشر
- النوع: integermax
_num _results الحد الأدنى:1الحد الأقصى:100الحد الأقصى لعدد نتائج البحث المراد إرجاعها، حتى 100
- النوع: stringqueryمطلوب
استعلام البحث عن مواد أكاديمية
- النوع: object · Response8Da310D1D213_WebSearchResponse200
استجابة بحث ناجحة
- النوع: stringidمطلوب
معرّف فريد لطلب البحث
- النوع: array object[] · Response8Da310D1D213_WebResult[]resultsمطلوب
قائمة نتائج البحث على الويب
- linkالنوع: string التنسيق: uriمطلوب
عنوان URL للوصول إلى صفحة الويب
- snippetالنوع: stringمطلوب
ملخص موجز أو معاينة لمحتوى صفحة الويب
- titleالنوع: stringمطلوب
عنوان صفحة الويب
- displayالنوع: string
_url عنوان URL مناسب للعرض
- publishedالنوع: string التنسيق: date-time
_date تاريخ نشر صفحة الويب
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد
application/json
curl 'https://openapi.felo.ai/v1/beta/scholar/search/web?query=machine%20learning' \
--request POST \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"id": "string",
"results": [
{
"title": "string",
"link": "https://example.com",
"snippet": "string",
"display_url": "string",
"published_date": "2026-10-26T08:08:16.601Z"
}
]
}