Bing SERP API 概览

本接口用于获取 Bing 搜索结果页（SERP）数据。通过指定、搜索引擎、语言和地域参数，本平台可模拟对应的搜索环境，并尽可能还原任务创建时可见的搜索结果。

响应中会返回 check_url。你可以在无痕模式下访问该地址，核验返回结果与目标搜索环境是否一致。

本平台不会使用用户偏好、搜索历史及个性化因素，因此这些因素不会反映在返回的 SERP 数据中。

支持的设备与操作系统

使用 Bing Organic 设置任务时，可以指定以下设备和操作系统：

移动端
- iOS
- Android
桌面端
- Windows
- macOS

排名字段

Bing SERP API 使用以下字段表示搜索结果排名：

rank_group：结果在所属分组中的排名。
rank_absolute：结果在整个 SERP 页面所有中的绝对排名。

两的区别在于：rank_group 只在当前结果类型或分组计数，rank_absolute 则跨所有 SERP素统一计数。

Bing SERP 功能

Bing SERP API 提供以下标准功能：

Regular

返回指定、搜索引擎和地域对应的前 10 条自然搜索结果及付费搜索结果。

Advanced

返回指定、搜索引擎、地域和语言对应的前 10 条搜索结果，并提供 Bing SERP 中精选摘要及扩展的完整信息。

HTML

返回指定、搜索引擎和地域对应的原始 SERP HTML 页面，适用于需要自行解析页面结构的场景。

数据获取方式

Bing SERP API 支持 Standard 和 Live 两种数据获取方式。

Live 方法

Live 方法适用于需要即时获取结果的场景。请求提交后，接口会直接返回搜索结果，不需要分别调用任务创建接口和任务查询接口。

Standard 方法

Standard 方法适用于不要求实时返回结果的场景，价格通常更低。使用该方法时，需要提交任务，再通过查询接口获取任务结果。

任务完成后，可以通过以下方式接收结果：

设置 pingback_url：任务完成后，本平台向指定地址发送完成通知。
设置 postback_url：任务完成后，本平台将结果发送到指定地址。使用该字段时，还需要指定数据获取功能：
- regular
- html

如果使用 Standard 方法时未设置 pingback_url 或 postback_url，可以调用 Tasks Ready 接口获取所有已完成但尚未提取的任务 id，然后通过 Task GET 接口获取任务结果。

请求限制

平台限流以认证说明中的 30/60/120 次/分钟规则为准。

每个 POST 请求最多 100 个任务。
如需提高限制，请联系平台支持团队。

建议根据 SERP 请求量合理控制任务批次和请求频率，触发限流。

优级与计费

Live 方法会实时返回结果，因此请求成本通常最高。

Standard 方法支持以下两种执行优级：

Normal：普通优级。
High：高优级，通常更快的任务执行速度。

`depth` 对计费的影响

当 depth 高于默认值时，任务成本会相应增加。例如，默认 depth 为 10 时，通常按每 10 条结果计费。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

认证方式

请求时使用 Bearer Token 认证：

http

Authorization: Bearer smt_live_YOUR_KEY

示例：

bash

curl --request POST \
  --url https://api.seermartech.cn/v3/serp/bing/organic/live \
  --header 'Authorization: Bearer smt_live_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "keyword": "seo tools",
      "location_code": 2840,
      "language_code": "en",
      "device": "desktop",
      "os": "windows",
      "depth": 10
    }
  ]'

POST 请求体是 JSON 数组，即使只提交一个任务，也需要使用数组格式：

json

[
  {
    "keyword": "seo tools",
    "location_code": 2840,
    "language_code": "en",
    "device": "desktop",
    "os": "windows",
    "depth": 10
  }
]

接口流程

Live 流程

调用 Live 接口提交任务。
接口直接返回搜索结果。
根据响应中的排名、SERP素及字段进行处理。

Standard 流程

调用任务提交接口创建任务。
通过任务查询接口获取任务状态和结果。
或调用 Tasks Ready 接口获取已完成任务列表。
使用 Task GET 接口获取任务结果。

回调流程

创建任务时设置 pingback_url 或 postback_url。
等任务完成。
接收本平台发送的通知或任务结果。
根据回调更新业务数据。

API 路径

Bing SERP 容路径：

/v3/serp/bing/organic/
/v3/serp/bing/languages/
/v3/serp/bing/locations/
/v3/appendix/sandbox/

任务提交、任务查询、任务完成列表和 Live 接口，请以对应功能页面中的接口定义为准。

实用场景

监控排名：定期获取目标在不同地域、设备和操作系统下的 Bing 排名，评估 SEO 优化效果。
分析 SERP 竞争格局：采集自然结果、付费结果及扩展 SERP素，识别竞争对手的搜索可见性。
验证本地化搜索结果：按不同语言和地域获取 SERP，检查本地 SEO 页面是否覆盖目标市场。
研究精选摘要机会：使用 Advanced 功能分析精选摘要及扩展，为结构优化提供依据。
保存并解析原始页面：使用 HTML 功能获取 SERP 原始 HTML，用于自定义解析、页面结构研究和结果审计。

Bing SERP API 概览 ​

支持的设备与操作系统 ​

排名字段 ​

Bing SERP 功能 ​

Regular ​

Advanced ​

HTML ​

数据获取方式 ​

Live 方法 ​

Standard 方法 ​

请求限制 ​

优级与计费 ​

depth 对计费的影响 ​

认证方式 ​

接口流程 ​

Live 流程 ​

Standard 流程 ​

回调流程 ​

API 路径 ​

实用场景 ​