SERP WP 支持语言列表

GET /v3/appendix/errors

GET /v3/serp/wp/languages

获取 SERP WP 数据源支持的语言列表。返回结果语言名称及对应的 ISO 639-1 语言代码，可用于创建 SERP 查询任务前校验语言参数。

计费说明

本接口，不产生任务费用。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求示例

curl

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

Python

import requests

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

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

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

result = response.json()

if result.get("status_code") == 20000:
    print(result)
else:
    print(
        f"请求失败：{result.get('status_code')} "
        f"{result.get('status_message')}"
    )

TypeScript

const response = await fetch(
  "https://api.seermartech.cn/v3/serp/wp/languages",
  {
    method: "GET",
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
  }
);

const result = await response.json();

if (result.status_code === 20000) {
  // 处理支持的语言列表
  console.log(result);
} else {
  console.error(
    `请求失败：${result.status_code} ${result.status_message}`
  );
}

响应示例

{
  "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": 2,
      "path": [
        "v3",
        "serp",
        "wp",
        "languages"
      ],
      "data": {
        "api": "serp",
        "function": "languages",
        "se": "wp"
      },
      "result": [
        {
          "language_name": "English",
          "language_code": "en"
        },
        {
          "language_name": "Chinese",
          "language_code": "zh"
        }
      ]
    }
  ]
}

响应字段说明

顶层字段

字段	类型	说明
version	string	当前 API 版本。
status_code	integer	请求的局状态码。20000 表示请求成功。完整错误码请参考 /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	本次请求对应的 API 路径信息。
data	object	GET 请求路径中使用的参数信息。
result	array	支持的语言列表。

result 语言字段

字段	类型	说明
language_name	string	语言名称。
language_code	string	ISO 639-1 标准语言代码，例如 en、zh。

状态码与错误处理

当顶层 status_code 或任务级 status_code 不等于 20000 时，应视为请求未成功。建议记录 status_code、status_message 和任务 id，以便定位问题。

常见处理方式：

• 20000：请求成功，可读取 tasks[0].result。
• 非 20000：根据返回的状态码和消息处理异常，详细定义请参考 /v3/appendix/errors。
• tasks_error 大于 0：表示部分或任务执行失败，应逐项检查 tasks 中的状态信息。

实用场景

• 校验语言参数：在提交 SERP 查询前验证 language_code 是否受支持，因语言无效导致任务失败。
• 构建多语言：读取可用语言列表并生成下拉选项，帮助运营人员选择目标市场的查询语言。
• 同步区域化：定期更新本地语言字，确保站 SEO 平台与接口支持范围保持一致。
• 筛选化采集市场：结合语言代码识别可覆盖的语种市场，为跨境 SEO 监测和规划提供依据。