Felo API PlatformFelo API Platform
全部 Scholar Search 端点
v0.2.0-beta
OpenAPI 3.1.0

网络搜索

Felo API Support
MIT
服务器:https://openapi.felo.ai
客户端库
Shell Curl

网络搜索

​

搜索开放网络并返回精简的结果列表。⚠️ 尽管是 POST，参数仍放在查询字符串中——query（必填）、max_num_results（默认 10，最大 100），以及用于年份范围的 as_ylo/as_yhi。不接受 JSON 请求体。返回搜索 id 和 results[]，仅包含 title、link 和 snippet。它的优点正是返回内容少，适合只需要知道有什么存在的智能体。它不提供页面正文——若需要内容，searchWeb 会在同一次调用中返回。请保留 id：post_scholar_search_explain 需要它。

计费参考

  • 计量方式：按成功请求的固定成本计费。
  • 参考请求估算：0.01 美元。
  • 参考客户倍率：1.0。不得对已结算的客户金额再次应用。

仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。

查询参数
  • as_yhi
    类型: integer | null
    最小值:  
    1900
    最大值:  
    2030

    出版年份上限

  • as_ylo
    类型: integer | null
    最小值:  
    1900
    最大值:  
    2030

    出版年份下限

  • max_num_results
    类型: integer
    最小值:  
    1
    最大值:  
    100

    要返回的最大搜索结果数，最多 100

  • query
    类型: string
    必填

    学术资料的搜索查询

响应
  • 200
    类型: object · Response8Da310D1D213_WebSearchResponse

    搜索成功响应

    • id
      类型: string
      必填

      搜索请求的唯一标识符

    • results
      类型: array object[] · Response8Da310D1D213_WebResult[]
      必填

      网络搜索结果列表

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

        访问网页的 URL

      • snippet
        类型: string
        必填

        网页内容的简要总结或预览

      • title
        类型: string
        必填

        网页标题

      • display_url
        类型: string

        便于显示的 URL

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

        网页发布日期

    application/json
  • 400

    无法处理该请求。请检查请求参数。

  • 401

    需要有效的 Felo API 密钥。

  • 402

    由于未满足计费要求，请求无法继续。

  • 403

    该账户无权执行此操作。

  • 429

    已达到请求或支出限额。

  • 502

    服务无法完成该请求。

  • 503

    API 或计费服务暂时不可用。

  • 504

    服务在处理请求时超时。

  • default

    错误响应；上游透传响应可能采用提供方格式

    application/json
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-10-26T08:08:16.601Z"
    }
  ]
}

搜索成功响应

Search the web

需要帮助？