获取 Bing 搜索量任务结果

接口说明

通过任务 ID 获取 Bing 搜索量任务结果。

该接口返回以下数据：

• 最近一个月的搜索量
• 最近 12 个月的搜索量趋势
• 当前平均点击出价（CPC）
• 付费搜索竞争度（competition）

适用于在任务提交完成后，按 ID 获取结果并分析搜索热度变化。

请求方式： GET接口地址： /v3/keywords_data/bing/search_volume/task_get/{id}

计费说明

该接口本身不会重复扣费，在创建任务时计费。 任务结果可在任务创建后的 30 天重复获取。

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

路径参数

参数名	类型	说明
id	string	任务唯一标识，UUID 格式。可在任务创建后的 30 天 用于随时获取结果。

返回结构

接口返回 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	任务 ID，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	请求中的地区代码
language_code	string	请求中的语言代码
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 上该的大致搜索次数，按接近的十位数取整；无数据时为 null
categories	array	产品/服务分类。该接口不返回分类数据，因此该字段始终为 null
monthly_searches	array	最近 12 个月的月度搜索量；无数据时为 null

monthly_searches 字段说明

字段	类型	说明
year	integer	年份
month	integer	月份
search_volume	integer	该月搜索量，按接近的十位数取整

状态码与异常处理

• status_code 表示接口或任务执行状态
• 建议在接时对通用错误、任务级错误、空结果等进行完整处理
• 完整错误码可参考：/v3/appendix/errors

请求示例

cURL

id="10081455-0001-0110-0000-c75b21dcca1c"

curl --location --request GET "https://api.seermartech.cn/v3/keywords_data/bing/search_volume/task_get/${id}" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json"

Python

import requests

task_id = "02231934-2604-0066-2000-570459f04879"
url = f"https://api.seermartech.cn/v3/keywords_data/bing/search_volume/task_get/{task_id}"

headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json)

TypeScript

import axios from "axios";

const taskId = "02231934-2604-0066-2000-570459f04879";

axios({
 method: "get",
 url: `https://api.seermartech.cn/v3/keywords_data/bing/search_volume/task_get/${taskId}`,
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
})
 .then((response) => {
 // 返回任务结果
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例

{
 "version": "0.1.20200923",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "keywords_data",
 "function": "search_volume",
 "se": "bing",
 "location_name": "United States",
 "language_name": "English",
 "keywords": []
 },
 "result": [
 {
 "keyword": "adsense blank ads how long",
 "location_code": 2840,
 "language_code": "en",
 "search_partners": false,
 "device": "all",
 "competition": 0.1,
 "cpc": 0,
 "search_volume": 0,
 "categories": null,
 "monthly_searches": []
 },
 {
 "keyword": "average page rpm adsense",
 "location_code": 2840,
 "language_code": "en",
 "search_partners": false,
 "device": "all",
 "competition": 0.1,
 "cpc": 0,
 "search_volume": 0,
 "categories": null,
 "monthly_searches": []
 }
 ]
 }
 ]
}

响应说明

• 当 cost 为 0 时，表示本次为已创建任务的结果读取，不产生额外扣费
• search_volume 为最近一个月的月均搜索量近似值
• monthly_searches 可用于观察近 12 个月的季节性波动和趋势变化
• competition 与 cpc 反映付费搜索市场，不等同于自然搜索排名难度
• 若某数据不足，device、competition、cpc、search_volume、monthly_searches 等字段可能返回 null

获取已完成任务后再按 ID 获取结果

在接中，通常流程如下：

1. 提交搜索量任务
2. 通过任务就绪接口获取已完成任务列表
3. 使用任务 ID 调用本接口获取结果

容路径示例：

• /v3/keywords_data/bing/v2/tasks_ready
• /v3/keywords_data/bing/v2/task_get/$id

如果你的系统采用轮询方式获取结果，建议调用任务列表接口，再逐个读取已完成任务，以减少无效请求。

实用场景

• 评估投放价值：结合 search_volume、cpc、competition 判断某是否值得广告预算。
• 识别季节性：利用 monthly_searches 观察过去 12 个月趋势，提前规划发布和促销节奏。
• 筛选低竞争长尾词：查找搜索量尚可但 competition 较低的，用于 SEO布局或低成本投放。
• 验证选题需求热度：在生产前检查近月搜索量，到低需求主题。
• 监控热度变化：定期拉取同一批任务结果，对比历史搜索量走势，行业趋势分析与选词策略调整。