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

Search the web

Felo API Support
MIT
伺服器:https://openapi.felo.ai
用戶端程式庫
Shell Curl

Search the web

​

Search the open web and get back a lean result list. ⚠️ Despite being a POST, parameters go in the query string — query (required), max_num_results (default 10, max 100), and as_ylo/as_yhi for a year range. A JSON body is not accepted. Returns a search id and results[] carrying only title, link and snippet. Its virtue is how little it returns, which suits an agent that only needs to know what exists. It gives you no page text — if you need the content, searchWeb returns it in the same call. Keep the id: it is what post_scholar_search_explain needs.

查詢參數
  • 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 · WebSearchResponse

    Successful search response

    • id
      類型: string
      必填

      Unique identifier for the search request

    • results
      類型: array object[] · WebResult[]
      必填

      List of web search results

      • link
        類型: string 格式: uri
        必填

        URL to access the web page

      • snippet
        類型: string
        必填

        Brief summary or preview of the web page content

      • title
        類型: string
        必填

        Title of the web page

      • display_url
        類型: string

        Display-friendly URL

      • published_date
        類型: string 格式: date-time

        Publication date of the web page

    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/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-09-30T03:09:45.799Z"
    }
  ]
}

Successful search response

Search the web