Bing 分类实时获取

接口概述

该接口用于根据指定的 Bing 产品或服务分类，实时返回对应的列表，并附带以下核心数据：

• 最近一个月的搜索量
• 最多 24 个月的搜索量趋势
• 当前点击单价（CPC）
• 付费搜索竞争度（competition）

需要注意：

• 返回的集合本身不因地区而变化
• 但 competition、cpc、search_volume、monthly_searches 会基于你设置的地区返回本地化数据

如果你的业务需要即时返回结果，建议使用 Live 方法。与标准任务模式不同，本接口无需拆分 POST / GET 两次请求。

• 实时模式：适合前台调用、即时推荐、在线分析
• 标准模式：适合对实时性要求不高、但更成本的批量处理场景

历史数据最长可查询 24 个月。

请求地址

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

计费说明

该接口按请求计费。

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

请求说明

• 请求方法：POST
• 请求体格式：JSON
• 编码：UTF-8
• 请求体为 JSON 数组：[{ ... }]
• 接口频率上限：每分钟最多 2000 次 API 调用
• 单次请求最多可返回 3000 条建议

请求参数

任务对象字段说明

字段名	类型	说明
category_code	integer	填。分类 ID。可通过 /v3/keywords_data/bing/categories 获取可用的 Bing 产品与服务分类列表。
location_name	string	当未提供 location_code 或 location_coordinate 时填。搜索引擎地区名。使用该字段时，无需再传 location_code 或 location_coordinate。可通过 /v3/keywords_data/bing/locations 获取可用地区。示例：London,England,United Kingdom
location_code	integer	当未提供 location_name 或 location_coordinate 时填。搜索引擎地区编码。使用该字段时，无需再传 location_name 或 location_coordinate。可通过 /v3/keywords_data/bing/locations 获取。示例：2840
location_coordinate	string	当未提供 location_name 或 location_code 时填。GPS 坐标，格式为 "latitude,longitude"。数据将按该坐标所属国家返回。示例：52.6178549,-155.352142
language_name	string	当未提供 language_code 时填。搜索引擎语言名称。使用该字段时，无需再传 language_code。当前支持：English
language_code	string	当未提供 language_name 时填。搜索引擎语言代码。使用该字段时，无需再传 language_name。当前支持：en
keywords_negative	array	可选。排除数组，结果中将忽略这些词。最多支持 200 个词项。系统会自动转为小写。
device	string	可选。设备类型，可选值：desktop、mobile、tablet、all。默认值：all
date_from	string	可选。时间范围起始日期。最早可设置为距今 24 个月。未传时默认返回最近 12 个月。格式："yyyy-mm-dd"，示例："2020-01-01"
date_to	string	可选。时间范围结束日期。未传时默认返回最近 12 个月。最小值为距今两年前，最大值为距今一个月。不建议对最近一年的数据自定义时间范围。 格式："yyyy-mm-dd"，示例："2020-03-15"
sort_by	string	可选。结果排序字段，支持按 search_volume、competition、cpc 或 relevance 降序排序。默认值：relevance
search_partners	boolean	可选。是否 Bing 搜索合作伙伴网络数据。true 表示返回 Bing、Yahoo、AOL 及合作伙伴站点网络的数据；默认 false，返回 Bing、AOL、Yahoo 搜索网络数据。
tag	string	可选。自定义任务标识，最长 255 个字符。可用于请求与结果的业务，响应中的 data 对象会原样返回该值。

响应结构

接口返回 JSON 对象， tasks 数组。

顶层字段说明

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	通用状态码，完整列表见 /v3/appendix/errors
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	付费搜索竞争度，取值范围 0 到 1，基于 Bing Ads 数据；无数据时为 null
cpc	float	历史平均点击单价，单位 USD；无数据时为 null
search_volume	integer	最近一个月的平均搜索量，基于 Bing；数值可能经过取整；无数据时为 null
categories	array	产品与服务分类列表；无数据时为 null
monthly_searches	array	月度搜索量明细，面向指定地理区域；无数据时为 null

monthly_searches 数组字段

字段名	类型	说明
year	integer	年份
month	integer	月份
search_volume	integer	该月平均搜索量，数值可能经过取整

请求示例

cURL

curl --location --request POST "https://api.seermartech.cn/v3/keywords_data/bing/keywords_for_category/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "location_name": "United States",
 "language_name": "English",
 "category_code": 13895
 }
]'

Python

import requests

url = "https://api.seermartech.cn/v3/keywords_data/bing/keywords_for_category/live"
payload = [
 {
 "location_name": "United States",
 "language_name": "English",
 "category_code": 13895
 }
]
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

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",
 category_code: 13895
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/keywords_data/bing/keywords_for_category/live",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 data: payload
})
 .then((response) => {
 // 输出接口返回结果
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例

{
 "version": "0.1.20200923",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "10.1792 sec.",
 "cost": 0.075,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "keywords_data",
 "function": "keywords_for_category",
 "se": "bing",
 "location_code": 2840,
 "language_code": "en",
 "category_code": 10003
 },
 "result": [
 {
 "keyword": "oculus rift",
 "location_code": 2840,
 "language_code": "en",
 "search_partners": false,
 "competition": 0.9,
 "cpc": 0.21,
 "search_volume": 34150,
 "categories": [],
 "monthly_searches": []
 },
 {
 "keyword": "discover personal loans",
 "location_code": 2840,
 "language_code": "en",
 "search_partners": false,
 "competition": 0.9,
 "cpc": 1.46,
 "search_volume": 21890,
 "categories": [],
 "monthly_searches": []
 },
 {
 "keyword": "home warranty companies",
 "location_code": 2840,
 "language_code": "en",
 "search_partners": false,
 "competition": 0.9,
 "cpc": 1.98,
 "search_volume": 17220,
 "categories": [],
 "monthly_searches": []
 }
 ]
 }
 ]
}

状态码与错误处理

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

常见成功状态：

状态码	说明
20000	请求成功

完整错误码与状态说明可参考 /v3/appendix/errors。 建议在生产环境中建立统一的异常处理与重试机制，要覆盖参数错误、限频、空结果和平台时等。

使用建议

1. 查询分类列表 在调用本接口前，建议通过 /v3/keywords_data/bing/categories 获取可用分类及对应 category_code。

2. 地区字段三选一location_name、location_code、location_coordinate 三任选一，不要重复传递。

3. 语言当前支持有限 当前文档中该接口列出 English / en。

4. 按业务决定是否纳合作伙伴流量 如果你更 Bing 主搜索网络，可保持 search_partners=false；如果你更广告投放覆盖面，可设为 true。

5. 自定义时间范围谨使用 若你的主要目标是观察近一年趋势，建议优使用默认时间范围，由于人为切分区间影响趋势判断。

实用场景

• 挖掘分类下的核心：按行业分类快速拉取一批 Bing ，用于搭建广告词库、SEO 选题池或新品推广池。
• 评估地区投放机会：在相同分类下切换不同地区，比较搜索量、CPC 和竞争度，帮助筛选更性价比的投放市场。
• 过滤无词提升投放质量：结合 keywords_negative 排除不词，减少噪声，提升广告分组与规划效率。
• 分析季节性波动：利用 monthly_searches 观察过去 24 个月趋势，识别需求旺季，为发布时间和投放节奏提供依据。
• 按设备拆分搜索需求：通过 device 获取不同终端的数据差异，优化移动端与桌面端的落地页策略和出价策略。