Felo API PlatformFelo API Platform

Data API / Scholar Search / Search

Smart search combining web and academic results

Search the web and academic sources together, for questions that straddle both. ⚠️ Parameters go in the query string: query (required), max_num_results, as_ylo/as_yhi. Returns a search id and results[]; the entry shape varies by source — every result has title, link and snippet, and academic ones additionally carry authors and number_of_citations, so treat those two as optional rather than assuming they are there. Use it when you do not know in advance which kind of source will answer. When you do, post_scholar_search_web or post_scholar_search_scholar is more predictable. Keep the id for post_scholar_search_explain.

Параметры

запрос

  • querystringОбязательный

    Search query for scholarly materials

  • max_num_resultsintegerНеобязательный

    Maximum number of search results to return, up to 100

  • as_yloНеобязательный

    Year of publication lower bound

  • as_yhiНеобязательный

    Year of publication upper bound

Пример запроса

curl -G "https://openapi.felo.ai/v1/beta/scholar/search/mixed" \
  --data-urlencode "query=<string>" \
  -H "Authorization: Bearer $FELO_API_KEY"

Ответ

Поля ответа

  • idstringОбязательный

    Unique identifier for the search request

  • resultsobject[]Обязательный

    List of smart search results combining web and academic content

  • titlestringОбязательный

    Title of the result

  • linkstringОбязательный

    URL to access the content

  • snippetstringОбязательный

    Brief summary or abstract

  • authorsstring[]Необязательный

    List of authors (for academic content)

  • number_of_citationsintegerНеобязательный

    Number of citations (for academic content)

  • typestringНеобязательный

    Допустимые значения: web · academic

    Type of the result

  • relevance_scorenumberНеобязательный

    Relevance score of the result

  • search_typestringНеобязательный

    Допустимые значения: web · academic · hybrid

    Type of search results included