Bing 词实时接口

接口说明

该接口用于根据一组给定，获取 Bing Ads 提供的建议。

• 单次请求最多可提交 200 个
• 最多可返回 3000 条建议
• 适合需要实时返回结果的业务场景
• 历史数据可追溯 24 个月

与标准任务模式不同，Live 实时接口只需一次 POST 请求即可直接拿到结果，无需再调用单独的结果查询接口。 如果你对实时性要求不高，也可以使用标准任务模式成本通常更低；扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求地址：

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

参考价： 按请求计费。 若按参考单价 USD 0.075 / 示例请求估算，参考价约 ¥1.2000 / 次。 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求格式：

• 请求体为 UTF-8 编码的 JSON
• POST 请求体格式为 JSON 数组：[{ ... }]
• 接口调用频率上限：2000 次/分钟

---

请求参数

顶层请求体示例

[
 {
 "location_name": "United States",
 "language_name": "English",
 "keywords": [
 "average page rpm adsense",
 "adsense blank ads how long",
 "leads and prospects"
 ]
 }
]

参数说明

字段名	类型	填	说明
keywords	array	是	数组。单次最多 200 个，每个最长 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 时填。返回数据将按该坐标所属国家提供。示例：52.6178549,-155.352142
language_name	string	条件填	搜索语言名称。未提供 language_code 时填。支持：English、French、German
language_code	string	条件填	搜索语言代码。未提供 language_name 时填。支持：en、fr、de
sort_by	string	否	结果排序方式，按降序排序。可选：search_volume、cpc、competition、relevance。默认：relevance
keywords_negative	array	否	需要从结果中排除的数组。最多可传 200 个，系统会自动转为小写。
device	string	否	设备类型。可选：all、mobile、desktop、tablet。默认：all
date_from	string	否	时间范围起始日期，格式：yyyy-mm-dd。最早可设置为距今天 24 个月前。不传则默认返回最近 12 个月数据。示例：2020-01-01
date_to	string	否	时间范围结束日期，格式：yyyy-mm-dd。最早可设置为距今天 24 个月前，最晚可设置为距今天 1 个月后。不传则默认返回最近 12 个月数据。示例：2020-03-15
search_partners	boolean	否	是否 Bing 搜索合作伙伴流量。true 表示 Bing、Yahoo、AOL 及合作站点；默认 false，返回 Bing、AOL、Yahoo 搜索网络数据
tag	string	否	自定义任务标识，最大 255 字符。便于请求结果对账和任务归类，响应的 data 中会原样返回

说明：

• location_name、location_code、location_coordinate 三传一即可
• language_name、language_code 二传一即可
• 不建议对最近一年的数据使用自定义时间范围，以影响数据一致性

---

地区与语言获取

如需查询可用地区列表，可调用：

/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	数据对应的设备类型，可为 all、mobile、desktop、tablet
competition	float	竞价竞争度基于付费搜索结果数据。常见值：0.1（低）、0.5（中）、0.9（高）；无数据时为 null
cpc	float	平均点击成本，单位 USD；无数据时为 null
search_volume	integer	月均搜索量，为近似值；无数据时为 null
categories	array	旧版字段，固定为 null
monthly_searches	array	月度搜索量明细；无数据时为 null

monthly_searches[] 字段

字段名	类型	说明
year	integer	年份
month	integer	月份
search_volume	integer	当月搜索量近似值

---

状态码与异常处理

• 顶层 status_code 表示整个请求的处理状态
• tasks[].status_code 表示单个任务的处理状态
• 建议同时检查：
• 顶层 status_code
• tasks_error
• 各任务的 status_code

错误码与通用消息请参考：/v3/appendix/errors

---

请求示例

cURL

curl --location --request POST "https://api.seermartech.cn/v3/keywords_data/bing/keywords_for_keywords/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "location_name": "United States",
 "language_name": "English",
 "keywords": [
 "average page rpm adsense",
 "adsense blank ads how long",
 "leads and prospects"
 ]
 }
]'

Python

import requests

url = "https://api.seermartech.cn/v3/keywords_data/bing/keywords_for_keywords/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

payload = [
 {
 "location_name": "United States",
 "language_name": "English",
 "keywords": [
 "average page rpm adsense",
 "adsense blank ads how long",
 "leads and prospects"
 ]
 }
]

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

TypeScript

import axios from "axios";

const payload = [
 {
 location_name: "United States",
 language_name: "English",
 keywords: [
 "average page rpm adsense",
 "adsense blank ads how long",
 "leads and prospects"
 ]
 }
];

axios.post(
 "https://api.seermartech.cn/v3/keywords_data/bing/keywords_for_keywords/live",
 payload,
 {
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 }
 }
).then((response) => {
 // 处理返回结果
 console.log(response.data);
}).catch((error) => {
 console.error(error.response?.data || error.message);
});

---

响应示例

{
 "version": "0.1.20200923",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "9.5821 sec.",
 "cost": 0.075,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "keywords_data",
 "function": "keywords_for_keywords",
 "se": "bing",
 "location_code": 2840,
 "language_code": "en",
 "keywords": [
 "average page rpm adsense",
 "adsense blank ads how long",
 "leads and prospects"
 ],
 "keywords_negative": []
 },
 "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": []
 },
 {
 "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": []
 }
 ]
 }
 ]
}

---

响应解读

以上响应表示：

• 请求执行成功，顶层状态码为 20000
• 本次请求处理 1 个任务，且没有任务报错
• 本次请求成本为 0.075 USD，按换算规则参考约 ¥1.2000
• 返回了与的 Bing 建议
• 每条建议都搜索量、点击成本、竞争度以及月度趋势等可用于投放和选词分析的数据

实用场景

• 扩展投放词：根据种子词批量挖掘，快速生成 Bing Ads 投放候选词库，提升广告组搭建效率。
• 筛选高价值：结合 search_volume、cpc 和 competition，找出搜索量高且商业价值明确的词，预算分与竞价策略制定。
• 排除无流量：合 keywords_negative 剔除不词根，减少噪音建议词，提升选词结果的业务性。
• 分析季节性趋势：通过 monthly_searches 观察月度波动，识别旺季与淡季，为发布和广告排期提供依据。
• 区分地域与设备机会：按地区、语言和设备维度请求数据，定位不同市场中的搜索需求差异，支持本地化 SEO 与跨设备投放优化。