网页搜索 - StepFun 开放平台文档中心

网页搜索接口检索互联网公开信息，并针对重点领域优化了信源的权威性，适合深入研究等对信源质量要求较高的场景。

请求地址

POST https://api.stepfun.com/v1/search

请求参数

query string required
检索关键词。
n int optional
返回结果条数，默认为 10，取值范围 1~20。
category string optional
检索场景，默认为空，表示检索全部场景。
显示子属性
- programming
  代码编程。
- research
  学术研究。
- gov
  政务信息。
- business
  商业财经。

请求响应

query string
检索关键词，回显请求参数。
category string
检索场景，回显请求参数，未指定时为空字符串。
results object array
检索结果列表。
显示子属性
- url string
  结果网页地址。
- position int
  结果排序位置，从 1 开始。
- title string
  结果网页标题。
- time string
  结果网页的索引时间。
- snippet string
  结果网页的摘要内容。
- content string
  结果网页的完整内容。

示例

curl -X POST "https://api.stepfun.com/v1/search" \
    -H 'Content-Type: application/json; charset=utf-8' \
    -H 'Authorization: Bearer $STEPFUN_API_KEY' \
    -d '{
        "query": "Python 新手入门教程",
        "n": 1,
        "category": "programming"
    }'

返回示例（snippet、content 内容较长，此处省略）：

{
  "query": "Python 新手入门教程",
  "category": "programming",
  "results": [
    {
      "url": "https://developer.aliyun.com/article/1718189",
      "position": 1,
      "title": "Python入门教程（新手必看）（一）",
      "time": "2026-03-20T00:00:00",
      "snippet": "Python 以简洁语法和强大生态成为编程入门首选，广泛应用于 Web 开发、数据分析、AI、自动化等领域...",
      "content": "Python 以简洁语法和强大生态成为编程入门首选...本文详解 Python 安装配置、基础语法（缩进、变量、输入输出、运算符）及首个程序实践，助新手快速上手..."
    }
  ]
}

​请求地址

​请求参数

​请求响应

​示例

请求地址

请求参数

请求响应

示例