基于网页 URL 获取 Bing 广告建议（实时）

接口说明

该接口用于根据指定网页 URL 的，生成的 Bing 广告建议。

接口会分析目标页面，并返回一组，同时给出 confidence_score（置信分数），用于表示该与用户搜索意图匹的概率。结果按置信分数从高到低排序。

如果你的业务需要实时返回结果，建议使用当前 实时（Live）接口。与标准任务模式不同，Live 方法无需拆分为 POST 创建任务和 GET 获取结果两步调用。

如果不要求实时获取数据，也可以使用标准模式接口，成本通常更低；标准模式下需创建任务，再异步获取结果。

请求地址

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

计费说明

该接口按请求计费。

参考价请以平台 API 定价为基础估算；扣费以响应头 X-SeerMarTech-Charge-CNY 为准。 从示例响应看，单次请求成本约为：

参考价约 ¥1.2000 / 次

请求格式

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

---

请求参数

字段名	类型	填	说明
target	string	是	需要扫描的目标网页 URL，用于提取可能的。最大长度：2000 个字符。
language_name	string	条件填	搜索引擎语言名。如果未传 language_code，则传该字段。传该字段时可不传 language_code。示例：English。可通过 /v3/keywords_data/bing/keyword_suggestions_for_url/languages 获取可用语言列表。
language_code	string	条件填	搜索引擎语言代码。如果未传 language_name，则传该字段。传该字段时可不传 language_name。示例：en。可通过 /v3/keywords_data/bing/keyword_suggestions_for_url/languages 获取可用语言列表。
exclude_brands	boolean	否	是否在结果中排除品牌词。

---

响应结构

接口返回 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 数组中返回错误的任务数量。
tasks	array	任务结果数组。

tasks 数组中的字段

字段名	类型	说明
id	string	任务唯一标识，UUID 格式。
status_code	integer	任务级状态码，范围通常为 10000-60000。完整错误码见 /v3/appendix/errors。
status_message	string	任务级状态信息。
time	string	当前任务执行耗时，单位秒。
cost	float	当前任务成本，单位 USD。
result_count	integer	result 数组中的结果数量。
path	array	接口路径信息。
data	object	回显请求时提交的参数。
result	array	建议结果数组，按 confidence_score 从高到低排序。

result 数组中的字段

字段名	类型	说明
keyword	string	建议。
confidence_score	float	0.0 到 1.0 之间的分值，表示该与用户搜索查询匹的概率。

---

请求示例

cURL

curl --location --request POST "https://api.seermartech.cn/v3/keywords_data/bing/keyword_suggestions_for_url/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "target": "https://example.com/product-page",
 "language_code": "en",
 "exclude_brands": true
 }
]'

Python

import requests

url = "https://api.seermartech.cn/v3/keywords_data/bing/keyword_suggestions_for_url/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
payload = [
 {
 "target": "https://example.com/product-page",
 "language_code": "en",
 "exclude_brands": True
 }
]

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

TypeScript

const response = await fetch(
 "https://api.seermartech.cn/v3/keywords_data/bing/keyword_suggestions_for_url/live",
 {
 method: "POST",
 headers: {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 body: JSON.stringify([
 {
 target: "https://example.com/product-page",
 language_code: "en",
 exclude_brands: true
 }
 ])
 }
);

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

---

响应示例

{
 "version": "0.1.20240801",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "12.7173 sec.",
 "cost": 0.075,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "b1d2c3e4-f5a6-7890-b123-4567890abcde",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "12.7173 sec.",
 "cost": 0.075,
 "result_count": 1,
 "path": [
 "v3",
 "keywords_data",
 "bing",
 "keyword_suggestions_for_url",
 "live"
 ],
 "data": {
 "api": "keywords_data",
 "function": "keyword_suggestions_for_url",
 "se": "bing",
 "language_code": "en",
 "target": "example.com"
 },
 "result": [
 {
 "keyword": "example keyword",
 "confidence_score": 0.92
 },
 {
 "keyword": "related keyword",
 "confidence_score": 0.81
 }
 ]
 }
 ]
}

---

状态码与错误处理

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

完整错误码和说明请参考：/v3/appendix/errors

常见处理建议：

1. 参数缺失或格式错误：检查 target、language_code / language_name 是否正确传。
2. 语言参数冲突或缺失：language_code 与 language_name 二选一即可，但至少要传一个。
3. 无结果返回：说明该页面不足以生成有效，或页面可抓取较少。
4. 限流问题：当高频批量调用时，注意控制在每分钟 2000 次。

---

使用建议

• target 建议传可访问、正文完整的落地页或产品页。
• 若要做非品牌词挖掘，可将 exclude_brands 设为 true。
• 对同一站点的不同页面分别调用，通常比只分析首页更容易得到高度。
• 如果你要对多个页面进行批量分析，可在请求数组中一次提交多个任务。

实用场景

1. 分析落地页可投放词：基于产品页或服务页自动提取 Bing 广告，帮助快速搭建投放词。
2. 挖掘非品牌增量词：开启 exclude_brands 过滤品牌词，发现更适合拉新获客的泛需求。
3. 评估页面与搜索意图匹度：结合 confidence_score 判断页面主题与潜在搜索词的贴合程度，页面优化。
4. 批量扫描站页面：对多个栏目页、页分别提取建议，构建站点级覆盖地图。
5. 支持竞品页面反向选词：竞品页面 URL，识别可能匹的搜索词方向，为投放和策略提供参考。