获取 Bing「Keywords For Keywords」任务结果

接口说明

该接口用于根据已创建任务的 id 获取 Bing 推荐结果。 本接口会基于你在任务中提交的种子词，返回建议，数据来源于 Bing Ads。单次任务最多可设置 200 个，最多可获取 3000 条建议。

请求方式： GET接口路径： /v3/keywords_data/bing/keywords_for_keywords/task_get/$id

计费说明

该类接口在创建任务时扣费，获取结果本身在任务创建后的 30 天。 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

若按平台单次任务计费，则请以任务提交接口返回的 cost 为准；本结果获取接口通常不重复计费。

---

路径参数

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

---

响应结构

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

顶层字段

字段	类型	说明
version	string	当前 API 版本
status_code	integer	通用状态码，完整列表见 /v3/appendix/errors
status_message	string	通用提示信息，完整列表见 /v3/appendix/errors
time	string	接口执行时间，单位秒
cost	float	本次请求总成本，单位 USD
tasks_count	integer	tasks 数组中的任务数量
tasks_error	integer	返回错误的任务数量
tasks	array	任务结果数组

tasks[] 字段

字段	类型	说明
id	string	任务唯一标识符，UUID 格式
status_code	integer	任务状态码，通常范围 10000-60000，完整列表见 /v3/appendix-errors/
status_message	string	任务提示信息，完整列表见 /v3/appendix-errors/
time	string	任务执行时间，单位秒
cost	float	该任务成本，单位 USD
result_count	integer	result 数组中的数量
path	array	请求路径
data	object	与创建任务时传参数一致的数据对象
result	array	结果列表

data 字段

字段	类型	说明
api	string	API 模块名称
function	string	功能名称
se	string	搜索引擎，固定为 bing
location_code	integer	创建任务时设置的地区代码
language_code	string	创建任务时设置的语言代码
keywords	array	创建任务时传的列表

result[] 字段

字段	类型	说明
keyword	string	推荐
location_code	integer	创建任务时的地区代码
language_code	string	创建任务时的语言代码
search_partners	boolean	响应中是否合作搜索网络数据
device	string	设备类型，可选值：all、mobile、desktop、tablet
competition	float	竞争度反映付费搜索环境中的竞争，基于 Bing Ads 数据。可能值：0.1（低）、0.5（中）、0.9（高）；无数据时为 null
cpc	float	平均历史点击单价，单位 USD；无数据时为 null
search_volume	integer	月均搜索量；为近似值，可能经过取整；无数据时为 null
categories	array	产品和服务分类。历史遗留字段，返回值始终为 null
monthly_searches	array	过去 12 个月的月度搜索量数据；无数据时为 null

monthly_searches[] 字段

字段	类型	说明
year	integer	年份
month	integer	月份
search_volume	integer	当月搜索量，通常为近似值并经过取整

---

请求示例

cURL

id="10251444-0001-0107-0000-7fc657a2f62c"

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

Python

import requests

task_id = "10251444-0001-0107-0000-7fc657a2f62c"
url = f"https://api.seermartech.cn/v3/keywords_data/bing/keywords_for_keywords/task_get/{task_id}"

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

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

TypeScript

const taskId = "10251444-0001-0107-0000-7fc657a2f62c";

const response = await fetch(
 `https://api.seermartech.cn/v3/keywords_data/bing/keywords_for_keywords/task_get/${taskId}`,
 {
 method: "GET",
 headers: {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 }
 }
);

const result = await response.json;
console.log(result);

---

响应示例

{
 "version": "0.1.20200923",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "10251444-0001-0107-0000-7fc657a2f62c",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0 sec.",
 "cost": 0,
 "result_count": 2,
 "path": [
 "v3",
 "keywords_data",
 "bing",
 "keywords_for_keywords",
 "task_get",
 "10251444-0001-0107-0000-7fc657a2f62c"
 ],
 "data": {
 "api": "keywords_data",
 "function": "keywords_for_keywords",
 "se": "bing",
 "location_code": 2840,
 "language_code": "en",
 "keywords": [
 "discount"
 ]
 },
 "result": [
 {
 "keyword": "coupon",
 "location_code": 2840,
 "language_code": "en",
 "search_partners": false,
 "device": "all",
 "competition": 0.9,
 "cpc": 0.51,
 "search_volume": 14640,
 "categories": null,
 "monthly_searches": null
 },
 {
 "keyword": "advertise my business",
 "location_code": 2840,
 "language_code": "en",
 "search_partners": false,
 "device": "all",
 "competition": 0.9,
 "cpc": 1.5,
 "search_volume": 8980,
 "categories": null,
 "monthly_searches": null
 }
 ]
 }
 ]
}

---

状态码与错误处理

• 顶层 status_code 表示整个请求的执行状态。
• tasks[].status_code 表示任务的处理状态。
• 建议同时校验：
• HTTP 状态码
• 顶层 status_code
• tasks[].status_code
• tasks_error

常见处理建议：

场景	建议
status_code = 20000 且 tasks_error = 0	请求成功，可正常解析结果
顶层成功但任务状态异常	检查 tasks[].status_code 与 tasks[].status_message
result 为空	任务可能尚未完成、无可用数据或任务参数不完整
competition / cpc / search_volume 为 null	平台暂无该对应数据，属于正常

完整错误码请参考 /v3/appendix/errors。

---

使用说明

1. 通过对应的任务提交接口创建 keywords_for_keywords 任务。
2. 获取任务返回的 id。
3. 使用本接口按 id 获取结果。
4. 任务结果可在创建后的 30 天 重复获取。

---

字段解读建议

competition

用于评估在 Bing 付费投放中的竞争强度，不代表自然搜索 SEO 难度。

cpc

表示该历史平均点击成本，可用于判断商业价值和投放意图。

search_volume

表示 Bing 搜索引擎中的月均搜索量，适合用于优级排序，但应注意为近似值。

monthly_searches

适合观察季节性波动，例如节假日促销、、教育招生等场景中的趋势变化。

实用场景

• 扩展广告投放词库：基于已有核心词批量获取推荐词，快速补 Bing Ads 投放覆盖范围。
• 筛选高商业价值：结合 cpc 与 competition 字段，优识别备投放价值和转化潜力的。
• 评估热度优级：根据 search_volume 对推荐词排序，优选择搜索需求更高的词或投放计划。
• 识别季节性搜索机会：利用 monthly_searches 观察近 12 个月波动，提前布局节庆、促销或周期性需求主题。
• 补长尾选题：从推荐结果中挖掘更的搜索表达，支持落地页、专题页和博客规划。