Scholar Search
Scholarly and web search with result explanations.
بحث ذكي يجمع نتائج الويب والأكاديمية
ابحث في الويب والمصادر الأكاديمية معًا، للأسئلة التي تشمل الاثنين. ⚠️ تذهب المعاملات في سلسلة الاستعلام: query (مطلوب)، وmax_num_results، وas_ylo/as_yhi. يعيد id بحث وresults[]؛ يتغيّر شكل المدخل حسب المصدر — كل نتيجة لها title وlink وsnippet، والأكاديمية تحمل إضافةً إلى ذلك authors وnumber_of_citations، لذا عامل هذين الحقلين كاختياريين بدلًا من افتراض وجودهما. استخدمه عندما لا تعرف مسبقًا أي نوع من المصادر سيجيب. وعندما تعرف، يكون post_scholar_search_web أو post_scholar_search_scholar أكثر قابلية للتوقّع. احتفظ بـ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_SmartSearchResponse200
استجابة بحث ناجحة
- النوع: stringidمطلوب
معرّف فريد لطلب البحث
- النوع: array object[] · Response8Da310D1D213_SmartResult[]resultsمطلوب
قائمة نتائج البحث الذكي التي تجمع بين محتوى الويب والمحتوى الأكاديمي
- linkالنوع: string التنسيق: uriمطلوب
عنوان URL للوصول إلى المحتوى
- snippetالنوع: stringمطلوب
ملخص موجز أو مستخلص
- titleالنوع: stringمطلوب
عنوان النتيجة
- authorsالنوع: array string[]
قائمة المؤلفين (للمحتوى الأكاديمي)
- numberالنوع: integer
_of _citations الحد الأدنى:0عدد الاقتباسات (للمحتوى الأكاديمي)
- relevanceالنوع: number
_score الحد الأدنى:0الحد الأقصى:1درجة صلة النتيجة
- typeالنوع: string تعداد
نوع النتيجة
القيم- web
- academic
- النوع: string تعدادsearch
_type نوع نتائج البحث المضمّنة
القيم- web
- academic
- hybrid
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/mixed?query=machine%20learning' \
--request POST \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"id": "string",
"results": [
{
"title": "string",
"link": "https://example.com",
"snippet": "string",
"authors": [
"string"
],
"number_of_citations": 0,
"type": "web",
"relevance_score": 0
}
],
"search_type": "web"
}