Felo API PlatformFelo API Platform
Все эндпоинты Scholar Search
v0.2.0-beta
OpenAPI 3.1.0

Поиск в вебе

Сервер:https://openapi.felo.ai
Клиентские библиотеки

Поиск в вебе

​

Ищет в открытом вебе и возвращает краткий список результатов. ⚠️ Несмотря на то что это POST, параметры передаются в строке запроса — query (обязателен), max_num_results (по умолчанию 10, максимум 100) и as_ylo/as_yhi для диапазона лет. JSON-тело не принимается. Возвращает id поиска и results[], содержащий только title, link и snippet. Его достоинство — как мало он возвращает, что подходит агенту, которому нужно лишь узнать, что существует. Текст страниц он не даёт — если нужен контент, searchWeb вернёт его в том же вызове. Сохраните id: он нужен post_scholar_search_explain.

Справочные цены

  • Тарификация: фиксированная базовая стоимость успешного запроса.
  • Справочная оценка запроса: USD 0.01.
  • Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.

Справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

Query-параметры
  • as_yhi
    Тип: integer | null
    мин.:  
    1900
    макс.:  
    2030

    Верхняя граница года публикации

  • as_ylo
    Тип: integer | null
    мин.:  
    1900
    макс.:  
    2030

    Нижняя граница года публикации

  • max_num_results
    Тип: integer
    мин.:  
    1
    макс.:  
    100

    Максимальное количество результатов поиска, до 100

  • query
    Тип: string
    обязательно

    Поисковый запрос для научных материалов

Ответы
  • 200
    Тип: object · Response8Da310D1D213_WebSearchResponse

    Успешный ответ на поиск

    • id
      Тип: string
      обязательно

      Уникальный идентификатор поискового запроса

    • results
      Тип: array object[] · Response8Da310D1D213_WebResult[]
      обязательно

      Список результатов веб-поиска

      • link
        Тип: string Формат: uri
        обязательно

        URL для доступа к веб-странице

      • snippet
        Тип: string
        обязательно

        Краткое резюме или превью содержимого веб-страницы

      • title
        Тип: string
        обязательно

        Название веб-страницы

      • display_url
        Тип: string

        URL для отображения

      • published_date
        Тип: string Формат: date-time

        Дата публикации веб-страницы

    application/json
  • 400

    Запрос не удалось обработать. Проверьте параметры запроса.

  • 401

    Требуется действительный API-ключ Felo.

  • 402

    Запрос не может быть выполнен: не выполнено требование биллинга.

  • 403

    Аккаунту не разрешено выполнять эту операцию.

  • 429

    Достигнут лимит запросов или расходов.

  • 502

    Сервис не смог выполнить запрос.

  • 503

    API или сервис биллинга временно недоступны.

  • 504

    Истекло время ожидания обработки запроса.

  • default

    Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

    application/json
Request Example for post/v1/beta/scholar/search/web
curl 'https://openapi.felo.ai/v1/beta/scholar/search/web?query=machine%20learning' \
  --request POST \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "id": "string",
  "results": [
    {
      "title": "string",
      "link": "https://example.com",
      "snippet": "string",
      "display_url": "string",
      "published_date": "2026-10-26T08:08:16.678Z"
    }
  ]
}
Search the web

Нужна помощь?