Felo API PlatformFelo API Platform
Усі endpoint 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.

Довідкові ціни

  • Тарифікація: фіксована базова вартість успішного запиту.
  • Довідкова оцінка запиту: USD 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 перелік

        Тип результату

        значення
        • web
        • academic
    • search_type
      Тип: string перелік

      Тип включених результатів пошуку

      значення
      • 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