Bing 通用网页 SERP，支持关键词检索、市场定向和分页控制。

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

元数据

字段	值
引擎名称	Bing 搜索
原始名称	Bing Search
内部标识（scraper）	bing_search
接口标识（engine）	bing_search
网站	Bing
网站地址	Bing.com
输出格式	json
版本	1.0.0
参数数量	6
参数分组	搜索词 (1), localization (1), 地理位置 (1), 分页 (1), 设备 (1), 高级筛选 (1)

请求示例

下面的请求体是本次文档更新时实际用于验证 bing_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":"bing_search","q":"openai"}'

响应示例

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

{
  "search_metadata": {
    "created_at": "2026-03-26 08:34:06 UTC",
    "id": "01KMMMERR4JVTEQD758DEN676H",
    "json_endpoint": "https://serp.xcrawl.com/01KMMMERR4JVTEQD758DEN676H.json",
    "processed_at": "2026-03-26 08:34:06 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMMERR4JVTEQD758DEN676H.html",
    "status": "completed",
    "total_time_taken": 8
  },
  "search_parameters": {
    "engine": "bing_search",
    "q": "openai"
  },
  "total_credits_used": 1,
  "organic_results": [
    {
      "displayed_link": "https://chatgpt.com › auth › login",
      "link": "https://www.bing.com/ck/a?!&&p=88dd8df67abdb301bd796fa47b40d25d36df7d9c1b6eec5c9221a16019388ddaJmltdHM9MTc3NDQ4MzIwMA&ptn=3&ver=2&hsh=4&fclid=23ad6fd9-c924-6bd3-0ecb-78f1c8196a87&u=a1aHR0cHM6Ly9jaGF0Z3B0LmNvbS9hdXRoL2xvZ... [truncated, 229 chars]",
      "position": 0,
      "snippet": "Chat with the most advanced AI to explore ideas, solve problems, and learn faster.",
      "thumbnail": "https://th.bing.com/th/id/OIP.1V_9gUzC-FUTplItY_xktgHaEK?w=108&h=108&c=1&bgcl=5f1c1c&r=0&o=7&pid=ImgRC&rm=3",
      "title": "ChatGPT",
      "tracking_link": "https://www.bing.com/ck/a?!&&p=88dd8df67abdb301bd796fa47b40d25d36df7d9c1b6eec5c9221a16019388ddaJmltdHM9MTc3NDQ4MzIwMA&ptn=3&ver=2&hsh=4&fclid=23ad6fd9-c924-6bd3-0ecb-78f1c8196a87&u=a1aHR0cHM6Ly9jaGF0Z3B0LmNvbS9hdXRoL2xvZ... [truncated, 229 chars]"
    },
    {
      "_note": "1 more items omitted"
    }
  ],
  "related_searches": [
    {
      "link": "https://www.bing.com/ck/a?!&&p=5abc8f11da3e9bd6f180350232108b78ab310bded509b9f4acadd8ee83251819JmltdHM9MTc3NDQ4MzIwMA&ptn=3&ver=2&hsh=4&fclid=23ad6fd9-c924-6bd3-0ecb-78f1c8196a87&u=a1L3NlYXJjaD9xPW9wZW5haS5jb20mRk9STT1RU... [truncated, 231 chars]",
      "query": "openai.com"
    },
    {
      "_note": "7 more items omitted"
    }
  ]
}

必填参数

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

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

可用参数

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

搜索词

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

localization

参数	类型	必填	说明
cc	string	否	用于本地化 Bing 系结果的国家代码。

附加约束

• cc：可选值：36 个可选值，例如：AR、AU、At、BE、BR

地理位置

参数	类型	必填	说明
mkt	string	否	Bing 的市场代码，通常由语言和国家组成，例如 en-US。

附加约束

• mkt：可选值：37 个可选值，例如：es-ar、en-au、de-at、nl-be、fr-be

分页

参数	类型	必填	说明
first	string	否	Bing 风格分页使用的起始位置。

设备

参数	类型	必填	说明
device	string	否	请求结果时使用的设备类型，例如桌面端或平板端。

附加约束

• device：可选值：1 个可选值，例如：desktop

高级筛选

参数	类型	必填	说明
safeSearch	string	否	Bing 的安全搜索级别。

附加约束

• safeSearch：可选值：3 个可选值，例如：off、moderate、strict

上一页Google Play 搜索

下一页Yahoo 搜索