Keywords Data 支持语言列表

GET /v3/appendix/errors

GET /v3/keywords_data/wp/languages

调用本接口可获取 Keywords Data 中 wp 数据源支持的语言列表。响应为 JSON 对象 tasks 数组任务执行结果及可用语言信息。

本接口不收费；扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求

GET https://api.seermartech.cn/v3/keywords_data/wp/languages
Authorization: Bearer smt_live_YOUR_KEY

该接口无需请求参数或请求体。

curl 示例

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

Python 示例

import requests

url = "https://api.seermartech.cn/v3/keywords_data/wp/languages"

headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json"
}

# 获取 wp 数据源支持的语言列表
response = requests.get(url, headers=headers, timeout=30)
result = response.json()

if result.get("status_code") == 20000:
    print(result)
else:
    print(
        f"请求失败。错误码：{result.get('status_code')}；"
        f"错误信息：{result.get('status_message')}"
    )

TypeScript 示例

import axios from "axios";

// 获取 wp 数据源支持的语言列表
const response = await axios.get(
  "https://api.seermartech.cn/v3/keywords_data/wp/languages",
  {
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json"
    }
  }
);

const result = response.data;

if (result.status_code === 20000) {
  console.log(result);
} else {
  console.error(
    `请求失败。错误码：${result.status_code}；错误信息：${result.status_message}`
  );
}

响应字段

顶层字段

字段名	类型	说明
version	string	当前 API 版本。
status_code	integer	局响应状态码。完整错误码请参考 /v3/appendix/errors。
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 请求 URL 中传或解析得到的参数信息。
result	array	支持语言列表。

result 语言对象字段

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

响应示例

{
  "version": "3.20191128",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1773 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.1773 sec.",
      "cost": 0,
      "result_count": 0,
      "path": [
        "v3",
        "keywords_data",
        "wp",
        "languages"
      ],
      "data": {
        "api": "keywords_data",
        "function": "languages",
        "se": "wp"
      },
      "result": []
    }
  ]
}

状态码与错误处理

当顶层 status_code 和任务对象中的 status_code 均为 20000 时，表示请求已成功处理。

如请求失败，请优检查以下：

• Authorization 是否使用有效的 Bearer smt_live_YOUR_KEY。
• 请求路径是否为 /v3/keywords_data/wp/languages。
• 账户权限及接口访问状态是否正常。
• status_message 中返回的错误说明。

完整状态码定义请参考 /v3/appendix/errors。

实用场景

• 构建语言选择器：在研究或创建中动态展示当前支持的语言，用户选择不可查询的语言。
• 校验批量任务：在提交多语言任务前验证语言代码，提高任务成功率并减少无效请求。
• 同步本地语言字：定期拉取支持语言列表并写本地库，保持前端选项与接口能力一致。
• 规划化 SEO 项目：根据可用语言范围评估目标市场覆盖能力，为多语种研究和本地化提供依据。