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