جستجوی هوشمند ترکیب‌کننده نتایج وب و دانشگاهی
Scholar Search
Scholarly and web search with result explanations.
جستجوی هوشمند ترکیب‌کننده نتایج وب و دانشگاهی
وب و منابع دانشگاهی را با هم جستجو کنید، برای پرسش‌هایی که هر دو را در بر می‌گیرند. ⚠️ پارامترها در query string قرار می‌گیرند: 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"
}