Bing URL 建议支持语言列表

GET /v3/keywords_data/bing/keyword_suggestions_for_url/languages

接口说明

该接口用于获取 Bing Ads API 在 URL 建议 场景下支持的语言列表。

• 请求方式：GET
• 请求地址：https://api.seermartech.cn/v3/keywords_data/bing/keyword_suggestions_for_url/languages
• 计费说明：调用本接口不收费
• 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准

调用成功后，服务端会返回 JSON 数据 tasks 数组可用语言信息。

---

请求信息

HTTP Request

GET /v3/keywords_data/bing/keyword_suggestions_for_url/languages

请求头

名称	类型	填	说明
Authorization	string	是	使用 Bearer Token 鉴权，格式：Bearer smt_live_YOUR_KEY
Content-Type	string	是	固定为 application/json

---

响应字段

顶层字段

字段名	类型	说明
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	任务状态信息，详见 /v3/appendix/errors
time	string	任务执行时间，单位：秒
cost	float	当前任务费用，单位：USD
result_count	integer	result 数组中的数量
path	array	URL 路径
data	object	GET 请求 URL 中传的参数信息
result	array	结果数组

tasks[].result[] 字段

字段名	类型	说明
language_name	string	语言名称
language_code	string	语言代码，遵循 ISO 639-1 标准

---

调用示例

cURL

curl --location --request GET "https://api.seermartech.cn/v3/keywords_data/bing/keyword_suggestions_for_url/languages" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json"

Python

import requests

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

response = requests.get(url, headers=headers)
result = response.json

if result.get("status_code") == 20000:
 print(result)
 # 在这里处理语言列表
else:
 print(f'error. Code: {result.get("status_code")} Message: {result.get("status_message")}')

TypeScript

import axios from "axios";

axios({
 method: "get",
 url: "https://api.seermartech.cn/v3/keywords_data/bing/keyword_suggestions_for_url/languages",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
})
 .then(function (response) {
 const result = response.data;
 // 在这里处理返回结果
 console.log(result);
 })
 .catch(function (error) {
 console.log(error);
 });

---

响应示例

{
 "version": "0.1.20240801",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0638 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "keywords_data",
 "function": "languages",
 "se": "bing",
 "se_type": "keyword_suggestions_for_url"
 },
 "result": []
 }
 ]
}

---

响应说明

返回结果中的 result 数组为支持语言列表。每个通常：

• language_name：语言名称
• language_code：ISO 639-1 两位语言代码

您可以调用该接口获取可用语言，再将对应的语言代码用于后续的 Bing URL 建议接口请求中。

---

常见状态码

状态码	说明
20000	请求成功
40000 及以上	请求参数、鉴权或服务处理异常，以 status_message 为准

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

实用场景

• 预校验语言参数：在提交 URL 建议任务前，拉取支持语言列表，使用无效语言代码导致请求失败。
• 构建语言下拉选项：为运营后台或 SEO 工生成可选语言菜单，减少人工维护枚举的成本。
• 按语种批量采集建议：确认 Bing 支持的目标语言，再对不同语种页面批量执行扩展，提高化 SEO 覆盖率。
• 统一多接口参数映射：将返回的 language_code 映射到系统的语种中，降低跨平台参数不一致带来的集成风险。
• 监控平台支持范围变化：定期同步语言列表，及时发现新增或下线语种，调整海外投放与布局策略。