Felo API PlatformFelo API Platform
همه endpointهای Scholar Search
v0.2.0-beta
OpenAPI 3.1.0

جستجوی مقالات دانشگاهی

سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت

جستجوی مقالات دانشگاهی

​

ادبیات دانشگاهی را جستجو کنید. ⚠️ پارامترها در query string قرار می‌گیرند، نه در بدنه: query (الزامی)، max_num_results و as_ylo/as_yhi برای محدود کردن سال انتشار. یک id جستجو و results[] با title، link، snippet، authors و number_of_citations برمی‌گرداند — همان فیلد آخر چیزی است که جستجوی وب عمومی نمی‌تواند بدهد. وقتی پرسش به منابع داوری‌شده نیاز دارد یا تعداد استنادها مهم است از آن استفاده کنید. برای رویدادهای جاری و صفحات محصول، موتور عمومی بهتر است: searchWeb. برای پوشش هر دو با هم، post_scholar_search_mixed. id را برای post_scholar_search_explain نگه دارید.

مرجع قیمت‌گذاری

  • اندازه‌گیری: مبنای هزینه ثابت برای درخواست موفق.
  • برآورد درخواست مرجع: 0.01 دلار آمریکا.
  • ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.

فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.

پارامترهای پرس‌وجو
  • as_yhi
    نوع: integer | null
    حداقل:  
    1900
    حداکثر:  
    2030

    کران بالای سال انتشار

  • as_ylo
    نوع: integer | null
    حداقل:  
    1900
    حداکثر:  
    2030

    کران پایین سال انتشار

  • max_num_results
    نوع: integer
    حداقل:  
    1
    حداکثر:  
    100

    حداکثر تعداد نتایج جستجو برای برگرداندن، تا 100

  • query
    نوع: string
    الزامی

    کوئری جستجو برای منابع علمی

پاسخ‌ها
  • 200
    نوع: object · Response8Da310D1D213_ScholarSearchResponse

    پاسخ جستجوی موفق

    • id
      نوع: string
      الزامی

      شناسه یکتای درخواست جست‌وجو

    • results
      نوع: array object[] · Response8Da310D1D213_ScholarResult[]
      الزامی

      فهرست نتایج مقالات دانشگاهی

      • authors
        نوع: array string[]
        الزامی

        فهرست نویسندگان

      • link
        نوع: string قالب: uri
        الزامی

        نشانی URL برای دسترسی به مقاله کامل

      • number_of_citations
        نوع: integer
        حداقل:  
        0
        الزامی

        تعداد استنادهایی که مقاله دریافت کرده است

      • snippet
        نوع: string
        الزامی

        خلاصه کوتاه یا چکیده مقاله

      • title
        نوع: string
        الزامی

        عنوان مقاله دانشگاهی

      • journal
        نوع: string

        نام نشریه یا کنفرانس

      • year
        نوع: integer
        حداقل:  
        1900
        حداکثر:  
        2030

        سال انتشار

    application/json
  • 400

    درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.

  • 401

    یک کلید API معتبر Felo لازم است.

  • 402

    درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.

  • 403

    حساب مجاز به انجام این عملیات نیست.

  • 429

    به سقف درخواست یا هزینه رسیده‌اید.

  • 502

    سرویس نتوانست درخواست را کامل کند.

  • 503

    سرویس API یا صورت‌حساب موقتاً در دسترس نیست.

  • 504

    سرویس هنگام پردازش درخواست به پایان مهلت رسید.

  • default

    پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند

    application/json
Request Example for post/v1/beta/scholar/search/scholar
curl 'https://openapi.felo.ai/v1/beta/scholar/search/scholar?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,
      "year": 1900,
      "journal": "string"
    }
  ]
}
Search academic papers