获取 Bing 数据支持的语言列表

GET /v3/keywords_data/bing/languages

本接口使用 GET 方法，请求路径为：

/v3/keywords_data/bing/languages

调用本接口可获取 Bing Ads API 支持的语言列表。本接口不收取调用费用。

> 注意：效果接口的语言和地域列表可能与本接口不同，请以对应接口返回的数据为准。

请求

请求方法

GET

请求地址

https://api.seermartech.cn/v3/keywords_data/bing/languages

请求头

参数	类型	填	说明
Authorization	string	是	认证令牌，格式为 Bearer smt_live_YOUR_KEY
Content-Type	string	否	建议设置为 application/json

本接口无需请求体和查询参数。

响应结构

接口返回 JSON 数据 tasks 数组语言列表信息。

顶层字段

字段	类型	说明
version	string	当前 API 版本
status_code	integer	通用响应状态码
status_message	string	通用状态说明
time	string	请求执行耗时，单位为秒
cost	float	平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
tasks_count	integer	tasks 数组中的任务数量
tasks_error	integer	tasks 数组中返回错误的任务数量
tasks	array	任务结果数组

tasks 数组字段

字段	类型	说明
id	string	任务唯一标识，采用 UUID 格式
status_code	integer	任务状态码，通常位于 10000–60000 范围
status_message	string	任务状态说明
time	string	任务执行耗时，单位为秒
cost	float	平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
result_count	integer	result 数组中的数量
path	array	请求 URL 路径
data	object	GET 请求路径中使用的参数信息
result	array	语言列表

result 数组字段

字段	类型	说明
language_name	string	语言名称
language_code	string	按 ISO 639-1 标准表示的语言代码

请求示例

cURL

curl --location --request GET \
  "https://api.seermartech.cn/v3/keywords_data/bing/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/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:
    # 读取 Bing 支持的语言列表
    for task in result.get("tasks", []):
        for language in task.get("result", []):
            print(
                language.get("language_name"),
                language.get("language_code")
            )
else:
    print(
        "请求失败，状态码：%s，说明：%s"
        % (result.get("status_code"), result.get("status_message"))
    )

TypeScript

import axios from "axios";

axios.get(
  "https://api.seermartech.cn/v3/keywords_data/bing/languages",
  {
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
  }
)
.then((response) => {
  const result = response.data;

  if (result.status_code === 20000) {
    // 读取 Bing 支持的语言列表
    for (const task of result.tasks ?? []) {
      for (const language of task.result ?? []) {
        console.log(
          language.language_name,
          language.language_code
        );
      }
    }
  } else {
    console.error(
      `请求失败，状态码：${result.status_code}，说明：${result.status_message}`
    );
  }
})
.catch((error) => {
  console.error("网络请求失败：", error.message);
});

响应示例

{
  "version": "0.1.20201021",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1177 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.1000 sec.",
      "cost": 0,
      "result_count": 3,
      "path": [
        "v3",
        "keywords_data",
        "bing",
        "languages"
      ],
      "data": {
        "api": "keywords_data",
        "function": "languages",
        "se": "bing"
      },
      "result": [
        {
          "language_name": "English",
          "language_code": "en"
        },
        {
          "language_name": "Chinese",
          "language_code": "zh"
        },
        {
          "language_name": "French",
          "language_code": "fr"
        }
      ]
    }
  ]
}

状态码与错误处理

• 顶层 status_code 用于表示本次 API 请求的总体状态。
• tasks[].status_code 用于表示任务的执行状态。
• 当状态码为 20000 时，表示请求成功。
• 请求失败时，可结合 status_code 和 status_message 定位问题。
• 完整的状态码和错误说明请参考本平台错误码文档。

实用场景

• 构建语言下拉选项：在 Bing 查询后台展示可用语言，提交不受支持的语言代码。
• 校验任务参数：提交数据任务前验证语言代码，减少因参数不容导致的任务失败。
• 同步多语言 SEO置：定期获取 Bing 支持的语言列表，为多地区、多语言项目生成标准化。
• 映射语言名称与代码：将用户可读的语言名称转换为 API 所需的 ISO 639-1 代码，提升运营的易用性。
• 监控语言支持变化：定时保存接口返回结果并进行版本对比，及时发现 Bing 语言支持范围的变化。