Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Smart search combining web and academic results

サーバー:https://openapi.felo.ai
クライアントライブラリ

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.

クエリパラメーター
  • query
    型: string
    必須

    Search query for scholarly materials

  • max_num_results
    型: integer
    最小値:  
    1
    最大値:  
    100

    Maximum number of search results to return, up to 100

  • as_ylo
    型: integer
    最小値:  
    1900
    最大値:  
    2030
    null 許容

    Year of publication lower bound

  • as_yhi
    型: integer
    最小値:  
    1900
    最大値:  
    2030
    null 許容

    Year of publication upper bound

レスポンス
  • 200
    型: object · SmartSearchResponse

    Successful search response

    • id
      型: string
      必須

      Unique identifier for the search request

    • results
      型: array object[] · SmartResult[]
      必須

      List of smart search results combining web and academic content

      • link
        型: string 形式: uri
        必須

        URL to access the content

      • snippet
        型: string
        必須

        Brief summary or abstract

      • title
        型: string
        必須

        Title of the result

      • authors
        型: array string[]

        List of authors (for academic content)

      • number_of_citations
        型: integer
        最小値:  
        0

        Number of citations (for academic content)

      • relevance_score
        型: number
        最小値:  
        0
        最大値:  
        1

        Relevance score of the result

      • type
        型: string 列挙値

        Type of the result

        値
        • web
        • academic
    • search_type
      型: string 列挙値

      Type of search results included

      値
      • web
      • academic
      • hybrid
    application/json
  • 400
    型: object · ErrorResponse

    Bad request - invalid parameters

    • error
      型: string

      A short error message.

    • message
      型: string

      A more detailed error message.

    application/json
  • 401
    型: object · ErrorResponse

    Unauthorized - invalid or missing API key

    • error
      型: string

      A short error message.

    • message
      型: string

      A more detailed error message.

    application/json
  • 402

    The request cannot proceed because a billing requirement is not met.

  • 403

    The account is not permitted to perform this operation.

  • 429
    型: object · ErrorResponse

    Rate limit exceeded

    • error
      型: string

      A short error message.

    • message
      型: string

      A more detailed error message.

    application/json
  • 500
    型: object · ErrorResponse

    Internal server error

    • error
      型: string

      A short error message.

    • message
      型: string

      A more detailed error message.

    application/json
  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

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