Felo API PlatformFelo API Platform
כל ה-endpoints של Scholar Search
v0.2.0-beta
OpenAPI 3.1.0

חיפוש חכם המשלב תוצאות אינטרנט ואקדמיה

שרת:https://openapi.felo.ai
ספריות לקוח

חיפוש חכם המשלב תוצאות אינטרנט ואקדמיה

​

חיפוש באינטרנט ובמקורות אקדמיים יחד, לשאלות שחוצות את שניהם. ⚠️ הפרמטרים הולכים במחרוזת השאילתה: 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.

פרמטרי שאילתה
  • as_yhi
    סוג: integer | null
    מינימום:  
    1900
    מקסימום:  
    2030

    שנת הפרסום — גבול עליון

  • as_ylo
    סוג: integer | null
    מינימום:  
    1900
    מקסימום:  
    2030

    שנת הפרסום — גבול תחתון

  • max_num_results
    סוג: integer
    מינימום:  
    1
    מקסימום:  
    100

    המספר המרבי של תוצאות חיפוש להחזרה, עד 100

  • query
    סוג: string
    חובה

    שאילתת חיפוש לחומרים אקדמיים

תגובות
  • 200
    סוג: object · Response8Da310D1D213_SmartSearchResponse

    תגובת חיפוש מוצלחת

    • id
      סוג: string
      חובה

      מזהה ייחודי לבקשת החיפוש

    • results
      סוג: array object[] · Response8Da310D1D213_SmartResult[]
      חובה

      רשימת תוצאות חיפוש חכם המשלבות תוכן אינטרנט ותוכן אקדמי

      • link
        סוג: string פורמט: uri
        חובה

        כתובת URL לגישה לתוכן

      • snippet
        סוג: string
        חובה

        תקציר קצר או תמצית

      • title
        סוג: string
        חובה

        כותרת התוצאה

      • authors
        סוג: array string[]

        רשימת מחברים (לתוכן אקדמי)

      • number_of_citations
        סוג: integer
        מינימום:  
        0

        מספר ציטוטים (לתוכן אקדמי)

      • relevance_score
        סוג: number
        מינימום:  
        0
        מקסימום:  
        1

        ציון הרלוונטיות של התוצאה

      • type
        סוג: string enum

        סוג התוצאה

        ערכים
        • web
        • academic
    • search_type
      סוג: string enum

      סוג תוצאות החיפוש שנכללו

      ערכים
      • web
      • academic
      • hybrid
    application/json
  • 400

    לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.

  • 401

    נדרש מפתח API תקף של Felo.

  • 402

    לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.

  • 403

    החשבון אינו מורשה לבצע את הפעולה הזו.

  • 429

    הגעתם למגבלת בקשות או לתקרת הוצאה.

  • 502

    השירות לא הצליח להשלים את הבקשה.

  • 503

    שירות ה-API או החיוב אינו זמין באופן זמני.

  • 504

    השירות פג בזמן הטיפול בבקשה.

  • default

    תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק

    application/json
Request Example for post/v1/beta/scholar/search/mixed
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"
}
Smart search combining web and academic results