Amazon Merchant API 支持的语言列表

GET /v3/merchant/amazon/languages

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

/v3/merchant/amazon/languages

调用本接口可获取 Amazon Merchant API 支持的语言列表。本接口当前不收取调用费用，参考价为 ¥0.00 / 次；扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求地址

GET https://api.seermartech.cn/v3/merchant/amazon/languages

本接口无需请求体。

请求示例

cURL

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

Python

import requests

url = "https://api.seermartech.cn/v3/merchant/amazon/languages"

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

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

if response.status_code == 200:
    result = response.json()
    print(result)
else:
    print(f"HTTP 错误：{response.status_code}")
    print(response.text)

TypeScript

import axios from "axios";

axios
  .get("https://api.seermartech.cn/v3/merchant/amazon/languages", {
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
  })
  .then((response) => {
    // 处理返回结果
    console.log(response.data);
  })
  .catch((error) => {
    console.error("请求失败：", error.response?.data || error.message);
  });

响应结构

接口返回 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 标准

响应示例

{
  "version": "0.1.20200416",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0784 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0123 sec.",
      "cost": 0,
      "result_count": 2,
      "path": [
        "v3",
        "merchant",
        "amazon",
        "languages"
      ],
      "data": {
        "api": "merchant",
        "function": "languages",
        "se": "amazon"
      },
      "result": [
        {
          "language_name": "English",
          "language_code": "en"
        },
        {
          "language_name": "German",
          "language_code": "de"
        }
      ]
    }
  ]
}

状态码

• 顶层 status_code 表示整个请求的处理状态。
• tasks[].status_code 表示单个任务的处理状态。
• 20000 表示请求成功。
• 状态码及错误信息请参考本平台错误码文档。

实用场景

• 获取 Amazon 支持的语言代码，为多语言商品采集、分析和站点提供合法参数。
• 校验语言，在批量创建 Merchant 任务前传不受支持的语言代码。
• 构建语言选择器，在 SEO 工或运营后台中动态展示可用语言，减少人工维护成本。
• 同步多站点市场，根据 Amazon 支持的语言列表匹不同区域的商品数据和搜索分析任务。