Bing 搜索量实时查询

接口说明

该接口用于实时获取 Bing 搜索量数据，返回：

最近一个月的搜索量
最多过去 24 个月的搜索量趋势
当前平均点击价格（CPC）
付费搜索竞争度（Competition）

如果你的业务需要同步返回结果，优使用 Live 方法。与标准任务模式不同，本接口只需一次 POST 请求即可直接拿到结果，无需拆分为任务提交和结果获取两个步骤。

如果你对实时性要求不高，也可以使用标准模式 /v3/keywords_data/bing/search_volume/task_post/。标准模式通常更经济，但需要创建任务，再单独获取结果。

历史数据最长支持 24 个月。

接口地址

POST https://api.seermartech.cn/v3/keywords_data/bing/search_volume/live

计费说明

该接口按请求次数计费，无论 keywords 数组中提交 1 个还是 1000 个，单次请求价格相同。

参考价约 ¥1.2000 / 次
实扣费以响应头 X-SeerMarTech-Charge-CNY 为准

调用限制

每分钟最多 2000 次 API 调用
单次请求中，keywords 数组最多可传 1000 个
每个最长 100 个字符
请求体为 UTF-8 编码的 JSON
POST 请求体格式为 JSON 数组：[{ ... }]

请求参数

任务参数字段

字段名	类型	说明
`keywords`	array	填。数组。最多 1000 个；每个最多 100 个字符。系统会自动转换为小写，并按逐条返回结果。
`location_name`	string	搜索引擎地域完整名称。当未提供 `location_code` 或 `location_coordinate` 时填。若使用该字段，则无需再传 `location_code` 或 `location_coordinate`。示例：`London,England,United Kingdom`
`location_code`	integer	搜索引擎地域代码。当未提供 `location_name` 或 `location_coordinate` 时填。若使用该字段，则无需再传 `location_name` 或 `location_coordinate`。示例：`2840`
`location_coordinate`	string	地理坐标，格式为 `"latitude,longitude"`。当未提供 `location_name` 或 `location_code` 时填。若使用该字段，则无需再传 `location_name` 或 `location_code`。系统将返回该坐标所属国家的数据。示例：`52.6178549,-155.352142`
`language_name`	string	搜索引擎语言名称。当未提供 `language_code` 时填。若使用该字段，则无需再传 `language_code`。支持值：`English`、`French`、`German`
`language_code`	string	搜索引擎语言代码。当未提供 `language_name` 时填。若使用该字段，则无需再传 `language_name`。支持值：`en`、`fr`、`de`
`device`	string	可选。设备类型。可选值：`all`、`mobile`、`desktop`、`tablet`。默认值：`all`
`sort_by`	string	可选。结果排序字段，按降序排序。可选值：`search_volume`、`cpc`、`competition`、`relevance`。默认值：`relevance`
`date_from`	string	可选。时间范围起始日期，格式：`yyyy-mm-dd`。最早可设为当前日期往前 24 个月。未传时默认返回最近 12 个月数据。不建议对过去一年的日期使用自定义时间范围。
`date_to`	string	可选。时间范围结束日期，格式：`yyyy-mm-dd`。最早可设为当前日期往前 24 个月，最晚可设为当前日期前 1 个月。未传时默认返回最近 12 个月数据。不建议对过去一年的日期使用自定义时间范围。
`search_partners`	boolean	可选。是否 Bing 搜索合作伙伴网络数据。传 `true` 时，结果覆盖 Bing、Yahoo、AOL 及合作站点；默认值为 `false`，返回 Bing、AOL、Yahoo 搜索网络数据。
`tag`	string	可选。自定义任务标识，最大 255 个字符。可用于请求与结果，返回时会出现在响应的 `data` 对象中。

地域与语言查询

如需查询可用的 Bing 地域列表，可调用：

/v3/keywords_data/bing/locations

响应结构

接口返回 JSON 数据，顶层 tasks 数组。

顶层响应字段

字段名	类型	说明
`version`	string	当前 API 版本
`status_code`	integer	接口通用状态码
`status_message`	string	接口通用状态说明
`time`	string	执行耗时，单位秒
`cost`	float	本次请求总费用，单位 USD
`tasks_count`	integer	`tasks` 数组中的任务数量
`tasks_error`	integer	返回错误的任务数量
`tasks`	array	任务结果数组

`tasks[]` 字段

字段名	类型	说明
`id`	string	任务唯一标识，UUID 格式
`status_code`	integer	任务状态码，通常范围 `10000-60000`
`status_message`	string	任务状态说明
`time`	string	任务执行耗时，单位秒
`cost`	float	单个任务费用，单位 USD
`result_count`	integer	`result` 数组数量
`path`	array	请求路径
`data`	object	回显请求时提交的参数
`result`	array	结果数组

`result[]` 字段

字段名	类型	说明
`keyword`	string	请求中的
`location_code`	integer	请求中的地域代码；无数据时为 `null`
`language_code`	string	请求中的语言代码；无数据时为 `null`
`search_partners`	boolean	响应是否合作伙伴网络数据
`device`	string	请求中的设备类型；无数据时为 `null`
`competition`	float	付费搜索竞争度基于 Bing Ads 数据。可选值：`0.1`（低竞争）、`0.5`（中竞争）、`0.9`（高竞争）；无数据时为 `null`
`cpc`	float	平均每次点击费用，单位 USD；无数据时为 `null`
`search_volume`	integer	月均搜索量。表示目标地域与语言下该在 Bing 上的近似搜索次数，数值会按 10 进行取整；无数据时为 `null`
`categories`	array	产品与服务分类。该接口不会返回分类数据，该字段始终为 `null`
`monthly_searches`	array	月度搜索量明细。返回指定地域下该过去一段时间的月度搜索量；无数据时为 `null`

`monthly_searches[]` 字段

字段名	类型	说明
`year`	integer	年份
`month`	integer	月份
`search_volume`	integer	该月搜索量，按 10 取整

错误处理

建议在接时同时处理以下两层状态：

顶层状态：status_code、status_message
任务级状态：tasks[].status_code、tasks[].status_message

完整错误码体系可参考 /v3/appendix/errors。生产环境中建议建立统一的异常处理与重试机制。

请求示例

cURL

bash

curl --location --request POST "https://api.seermartech.cn/v3/keywords_data/bing/search_volume/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "location_name": "United States",
 "language_name": "English",
 "device": "mobile",
 "keywords": [
 "tom and jerry",
 "silicon valley",
 "spider man"
 ]
 }
]'

Python

python

import requests

url = "https://api.seermartech.cn/v3/keywords_data/bing/search_volume/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
data = [
 {
 "location_name": "United States",
 "language_name": "English",
 "device": "mobile",
 "keywords": [
 "tom and jerry",
 "silicon valley",
 "spider man"
 ]
 }
]

response = requests.post(url, headers=headers, json=data)
print(response.json)

TypeScript

typescript

import axios from "axios";

const postData = [
 {
 location_name: "United States",
 language_name: "English",
 device: "mobile",
 keywords: [
 "tom and jerry",
 "silicon valley",
 "spider man"
 ]
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/keywords_data/bing/search_volume/live",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 data: postData
})
 .then((response) => {
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例

json

{
 "version": "0.1.20200923",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "8.2899 sec.",
 "cost": 0.075,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "keywords_data",
 "function": "search_volume",
 "se": "bing",
 "location_name": "United States",
 "language_code": "en",
 "device": "mobile",
 "keywords": [
 "tom and jerry",
 "silicon valley",
 "spider man"
 ]
 },
 "result": [
 {
 "keyword": "tom and jerry",
 "location_code": 2840,
 "language_code": "en",
 "search_partners": false,
 "device": "mobile",
 "competition": 0.9,
 "cpc": 0.05,
 "search_volume": 3220,
 "categories": null,
 "monthly_searches": []
 },
 {
 "keyword": "silicon valley",
 "location_code": 2840,
 "language_code": "en",
 "search_partners": false,
 "device": "mobile",
 "competition": 0.1,
 "cpc": 0,
 "search_volume": 0,
 "categories": null,
 "monthly_searches": []
 }
 ]
 }
 ]
}

返回结果解读

search_volume：适合用于评估当前流量规模
monthly_searches：适合分析季节性波动与趋势变化
cpc：适合评估商业价值与投放成本
competition：适合衡量付费竞争强度
device：适合区分移动端与桌面端搜索需求差异

使用建议

需要批量获取多个时，尽量将打到同一个请求中，以提升调用效率
若你的业务需要按设备拆分数据，可分别请求 mobile、desktop、tablet
若需要更稳定的批量生产型抓取，可考虑标准任务模式
若对近一年趋势分析要求较高，建议优使用默认时间范围，手动裁切时间窗口

实用场景

筛选高价值：结合 search_volume、cpc 与 competition，快速识别既有搜索需求又备商业价值的 Bing 。
评估季节性：利用 monthly_searches 查看过去 24 个月趋势，识别淡旺季变化，为排期和投放预算提供依据。
拆分设备搜索需求：按 mobile、desktop、tablet 分别查询，分析不同终端的搜索行为差异，优化落地页与策略。
监控重点词热度变化：对品牌词、产品词、活动词进行周期性查询，及时发现搜索量异常波动并调整运营动作。
** Bing 广告选词**：通过 cpc 和 competition 判断投放难度与成本，优化出价和广告结构。

Bing 搜索量实时查询 ​

接口说明 ​

接口地址 ​

计费说明 ​

调用限制 ​

请求参数 ​

任务参数字段 ​

地域与语言查询 ​

响应结构 ​

顶层响应字段 ​

tasks[] 字段 ​

result[] 字段 ​

monthly_searches[] 字段 ​

错误处理 ​

请求示例 ​

cURL ​

Python ​

TypeScript ​

响应示例 ​

返回结果解读 ​

使用建议 ​

实用场景 ​