获取 Bing 页面 URL 的建议结果

GET /v3/keywords_data/bing/keyword_suggestions_for_url/task_get/${id}

接口说明

该接口用于根据指定网页 URL 的获取 Bing Ads 建议结果。接口会分析页面，并返回列表，同时为每个提供 confidence_score（置信分），用于表示该与用户搜索意图匹的概率。

• 请求方式：GET
• 请求路径：/v3/keywords_data/bing/keyword_suggestions_for_url/task_get/$id

，$id 为任务提交后返回的唯一任务标识符。

计费说明

本接口在创建任务时扣费，获取结果本身在任务创建后 30 天。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。 如需参考，可理解为结果查询接口通常不额外收费，因此本接口响应中的 cost 常见为 0。

路径参数

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

返回结构

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

# 将 id 替换为任务 ID
id="10081455-0001-0110-0000-c75b21dcca1c"

curl --location --request GET "https://api.seermartech.cn/v3/keywords_data/bing/keyword_suggestions_for_url/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/keyword_suggestions_for_url/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

import axios from "axios";

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

axios({
 method: "get",
 url: `https://api.seermartech.cn/v3/keywords_data/bing/keyword_suggestions_for_url/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.20240801",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "keywords_data",
 "function": "keyword_suggestions_for_url",
 "se": "bing",
 "id": "09271534-1535-0597-0000-59b5253fe0c0",
 "language_code": "en",
 "target": "example.com"
 },
 "result": []
 }
 ]
}

状态码与错误处理

• 顶层 status_code 表示整个请求是否成功。
• tasks[].status_code 表示单个任务的执行状态。
• 建议优检查：

1. 顶层 status_code 是否为 20000
2. tasks_error 是否为 0
3. tasks[].result 是否存在且非空

完整错误码与状态说明请参考 /v3/appendix/errors。

使用说明

1. 调用对应的任务提交接口创建 URL 建议任务。
2. 获取任务 id 后，调用本接口按 ID 获取结果。
3. 返回的结果会 confidence_score 从高到低排序。
4. 任务结果可在创建后 30 天重复查询，无需重复创建任务。

实用场景

• 提取页面投放词：针对落地页自动生成 Bing Ads 候选，提升广告建词效率。
• 评估页面主题匹度：通过高置信度判断页面与目标搜索意图是否一致，落地页优化。
• 扩展长尾库：基于现有页面挖掘搜索词，为 SEO 和 SEM 提供长尾补。
• 校验页面改版效果：在页面更新前后分别创建任务，对比建议变化，评估主题调整是否有效。
• 支持批量页面分析：对站多个 URL 分别生成建议，快速建立页面级覆盖视图。