Bing 表现支持的地域与语言列表

接口说明

该接口用于获取 Bing 表现（Keyword Performance）端点支持的语言及可用地域组合。

通过本接口，您可以提前拉取可用的 language_code 与 location_code 映射，用于后续表现查询时做参数校验与下拉选项初始化。

请求方式

GET /v3/keywords_data/bing/keyword_performance/locations_and_languages

完整地址

https://api.seermartech.cn/v3/keywords_data/bing/keyword_performance/locations_and_languages

计费说明

调用本接口不收费。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准；该接口通常返回 0。

响应结构

接口返回 JSON 数据，顶层 tasks 数组每个任务对象可用语言及对应支持地域的信息。

顶层字段

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	通用状态码
status_message	string	通用状态信息
time	string	执行耗时，单位：秒
cost	float	所有任务总费用，单位：USD
tasks_count	integer	tasks 数组中的任务数量
tasks_error	integer	tasks 数组中返回错误的任务数量
tasks	array	任务数组

完整错误码与状态信息请参考 /v3/appendix/errors

tasks[] 字段

字段名	类型	说明
id	string	任务唯一标识，UUID 格式
status_code	integer	任务状态码，范围通常为 10000-60000
status_message	string	任务状态信息
time	string	当前任务执行耗时，单位：秒
cost	float	当前任务费用，单位：USD
result_count	integer	result 数组中的数量
path	array	URL 路径
data	object	GET 请求 URL 中传的参数信息
result	array	结果数组

result[] 字段

每个表示一种语言，以及该语言下可用的地域列表。

字段名	类型	说明
language_name	string	语言名称
language_code	string	语言代码
available_locations	array	该语言支持的地域列表

available_locations[] 字段

字段名	类型	说明
location_code	string	地域代码
location_name	string	地域名称
country_iso_code	string	地域对应国家的 ISO 国家代码
location_type	string	地域类型，可选值：Country、Region

调用示例

cURL

curl --location --request GET "https://api.seermartech.cn/v3/keywords_data/bing/keyword_performance/locations_and_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_performance/locations_and_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_performance/locations_and_languages",
 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.20240626",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1337 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "keywords_data",
 "function": "locations_and_languages",
 "se": "bing",
 "se_type": "keyword_performance"
 },
 "result": [
 {
 "language_name": "Dutch",
 "language_code": "nl",
 "available_locations": []
 },
 {
 "language_name": "English",
 "language_code": "en",
 "available_locations": []
 },
 {
 "language_name": "Finnish",
 "language_code": "fi",
 "available_locations": []
 },
 {
 "language_name": "French",
 "language_code": "fr",
 "available_locations": []
 },
 {
 "language_name": "German",
 "language_code": "de",
 "available_locations": []
 },
 {
 "language_name": "Italian",
 "language_code": "it",
 "available_locations": []
 },
 {
 "language_name": "Spanish",
 "language_code": "es",
 "available_locations": []
 },
 {
 "language_name": "Swedish",
 "language_code": "sv",
 "available_locations": []
 },
 {
 "language_name": "Chinese (Simplified)",
 "language_code": "zh-CN",
 "available_locations": []
 },
 {
 "language_name": "Chinese (Traditional)",
 "language_code": "zh-TW",
 "available_locations": []
 }
 ]
 }
 ]
}

返回结果说明

• result 中每条记录对应一个可用语言。
• available_locations 表示该语言可搭使用的地域范围。
• 地域类型可能为：
• Country：国家级
• Region：地区级

如果您要调用 Bing 表现接口，建议调用本接口，确认目标语言下是否支持指定地域，因参数组合无效导致请求失败。

常见用途

1. 初始化地域和语言下拉选项 在控制台、报表系统或中动态展示可选参数，维护静态。

2. 校验请求参数合法性 在提交 Bing 表现任务前，验证 language_code 与 location_code 的组合是否有效。

3. 同步平台支持范围变更 定时拉取支持列表，及时发现新增语言、国家或地区，减少人工维护成本。

4. 构建多市场分析流程 为不同国家/地区的 SEO 团队提供统一的可用参数字，简化跨区域分析。

错误处理

当请求成功但任务执行异常时，可重点检查以下字段：

• 顶层 status_code / status_message
• tasks[].status_code / tasks[].status_message

若 tasks_error > 0，表示部分或任务返回错误。 错误码明细请参考 /v3/appendix/errors。

实用场景

• 初始化投放市场：拉取 Bing 表现支持的语言与地域列表，为 SEO 或广告分析后台自动生成可选市场，减少人工维护。
• 校验查询参数组合：在发起表现请求前，验证语言和地域是否可组合使用，降低无效请求率并提升任务成功率。
• 同步区域支持变更：定时更新支持列表，及时发现新增国家、地区或语言，帮助团队快速扩展新的搜索市场。
• 构建多语言分析模板：按语言归类可用地域，为化站点建立标准化分析模板，提高跨区域研究效率。
• 约束前端表单：将接口返回结果直接用于前端联动选择器，实现“选语言，再筛地域”的交互，提升操作准确性。