Baidu 搜索

Baidu 通用搜索 SERP，支持关键词检索、分页和高级查询参数。

本页给出 Baidu 搜索的字段定义、参数分组、必填约束以及可用过滤参数。

元数据

字段	值
引擎名称	Baidu 搜索
原始名称	Baidu Search
内部标识（scraper）	`baidu_search`
接口标识（engine）	`baidu_search`
网站	Baidu
网站地址	Baidu.com
输出格式	`json`
版本	`1.0.0`
参数数量	`11`
参数分组	高级参数 (3), 搜索词 (1), 地区与语言 (1), 分页 (2), 高级筛选 (3), 请求控制 (1)

请求示例

下面的请求体是本次文档更新时实际用于验证 baidu_search 的请求。对于 /v1/serp，engine 字段应传当前引擎的 scraper 值。

curl -X POST "https://run.xcrawl.com/v1/serp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"engine":"baidu_search","q":"OpenAI"}'

响应示例

下面的 JSON 片段来自同一次真实响应。为了避免页面被超长字段淹没，超长字符串、data URL 和大型数组做了裁剪。

{
  "search_metadata": {
    "cached": true,
    "created_at": "2026-03-26 08:18:45 UTC",
    "id": "01KMMKJDW2M51TSH7VW5SPFC4P",
    "json_endpoint": "https://serp.xcrawl.com/01KMMKJDW2M51TSH7VW5SPFC4P.json",
    "processed_at": "2026-03-26 08:18:45 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMKJDW2M51TSH7VW5SPFC4P.html",
    "status": "completed",
    "total_time_taken": 16
  },
  "search_parameters": {
    "engine": "baidu_search",
    "q": "OpenAI"
  },
  "total_credits_used": 1,
  "organic_results": [
    {
      "link": "http://www.baidu.com/link?url=PEXVzOFRCnv_69F41bDw04tmdiWvcUoI_yKmlKAwNYNR4wTgkm8xkY1n01ye1bbN",
      "snippet": "我们的研究研究索引研究概览研究驻留openai for science经济研究最新进展gpt-5.3 instantgpt-5.3-codexgpt-5codex安全安全措施安全与隐私信任与透明度chatgpt探索chatgpt(在新窗口中打开)business 版enterprise 版education 版定价(在新窗口中打开)下载(在新窗口中打开)sorasora 概览功能定价sora 登录(在新窗口中打开)api...",
      "title": "openai’s chatgpt"
    },
    {
      "_note": "5 more items omitted"
    }
  ],
  "related_searches": [
    {
      "link": "https://www.baidu.com/s?wd=openai%E4%BB%80%E4%B9%88%E6%84%8F%E6%80%9D&rsf=101631101&rsp=0&f=1&rs_src=0&rsv_pq=b87a276000285c7a&rsv_t=f53dKr1smn8aaWf2abFPuVrXgqr63GFr6DQjmBajthkONjjGV4eng9OiXO0&rsv_dl=brs_28338_1",
      "query": "openai什么意思"
    },
    {
      "_note": "9 more items omitted"
    }
  ],
  "top_searches": [
    {
      "link": "https://www.baidu.com/s?wd=%E5%9B%9B%E8%B5%B4%E9%9B%84%E5%AE%89%20%E5%AF%B9%E2%80%9C%E6%9C%AA%E6%9D%A5%E4%B9%8B%E5%9F%8E%E2%80%9D%E5%86%8D%E9%83%A8%E7%BD%B2&usm=4&ie=utf-8&rsv_pq=b87a276000285c7a&oq=OpenAI&rsv_t=a7b9mVcV... [truncated, 397 chars]",
      "text": "四赴雄安 对“未来之城”再部署"
    },
    {
      "_note": "30 more items omitted"
    }
  ]
}

必填参数

以下表格列出当前 metadata 中标记为 must: true 的字段。字段是否必填，以 properties.<field>.must 为准，不以顶层 required 数组为准。

参数	类型	分组	说明
`q`	`string`	搜索词	你想让搜索引擎检索的关键词或短语。

可用参数

以下内容按后端返回的字段分组展示。主表只保留字段名、类型、必填标记和字段说明；默认值、可选值等附加约束会列在每个分组后。

高级参数

参数	类型	必填	说明
`f`	`string`	否	Originating Search Type 参数。
`bs`	`string`	否	Previous Search Query 参数。
`oq`	`string`	否	Original Search Query 参数。

搜索词

参数	类型	必填	说明
`q`	`string`	是	你想让搜索引擎检索的关键词或短语。

地区与语言

参数	类型	必填	说明
`ct`	`number`	否	Choose Language 参数。

附加约束

ct：默认值：1；可选值：3 个可选值，例如：1、2、3

分页

参数	类型	必填	说明
`pn`	`string`	否	Result Offset 参数。
`rn`	`string`	否	Number of Results 参数。

高级筛选

参数	类型	必填	说明
`q5`	`string`	否	Search Type 参数。
`q6`	`string`	否	Search Type 参数。
`gpc`	`string`	否	Time Period for Results 参数。

请求控制

参数	类型	必填	说明
`no_cache`	`boolean`	否	跳过缓存结果并强制重新抓取。

附加约束

no_cache：默认值：false

引擎列表

Baidu 搜索