Felo API PlatformFelo API Platform

データ 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