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

结合网络与学术结果的智能搜索

服务器:https://openapi.felo.ai
客户端库

结合网络与学术结果的智能搜索

​

同时搜索网络和学术来源,适用于横跨两者的疑问。⚠️ 参数放在查询字符串中:query(必填)、max_num_results、as_ylo/as_yhi。返回搜索 id 和 results[];条目结构因来源而异——每条结果都有 title、link 和 snippet,学术结果还额外带有 authors 和 number_of_citations,因此请将这两项视为可选,而不要假定它们一定存在。当无法预先判断哪类来源能回答时使用。若已能判断,post_scholar_search_web 或 post_scholar_search_scholar 更可预测。请保留 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_SmartSearchResponse

    搜索成功响应

    • id
      类型: string
      必填

      搜索请求的唯一标识符

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

      结合网络与学术内容的智能搜索结果列表

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

        获取内容的 URL

      • snippet
        类型: string
        必填

        简要总结或摘要

      • title
        类型: string
        必填

        结果标题

      • authors
        类型: array string[]

        作者列表(学术内容)

      • number_of_citations
        类型: integer
        最小值:  
        0

        引用次数(学术内容)

      • relevance_score
        类型: number
        最小值:  
        0
        最大值:  
        1

        结果的相关性评分

      • type
        类型: string 枚举

        结果类型

        值
        • web
        • academic
    • search_type
      类型: string 枚举

      所包含的搜索结果类型

      值
      • web
      • academic
      • hybrid
    application/json
  • 400

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

  • 401

    需要有效的 Felo API 密钥。

  • 402

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

  • 403

    该账户无权执行此操作。

  • 429

    已达到请求或支出限额。

  • 502

    服务无法完成该请求。

  • 503

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

  • 504

    服务在处理请求时超时。

  • default

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

    application/json
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

需要帮助?