content_analysis/languages

GET /v3/content_analysis/languages

#分析 API：支持的语言列表

接口说明

GET /v3/content_analysis/languages

本接口用于获取分析 API 支持的语言列表。接口无需请求参数，调用成功后返回 JSON 数据 tasks 数组任务处理结果。

计费说明

本接口不收取调用费用，参考价为 ¥0 / 次。

如需确认扣费，请以响应头 X-SeerMarTech-Charge-CNY 为准。

请求示例

cURL

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

Python

import requests

url = "https://api.seermartech.cn/v3/content_analysis/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()
    if result.get("status_code") == 20000:
        print(result)
        # 在此处处理语言列表
    else:
        print(
            "接口错误。错误码：%s，错误信息：%s"
            % (result.get("status_code"), result.get("status_message"))
        )
else:
    print("HTTP 错误：%s" % response.status_code)

TypeScript

import axios from "axios";

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

    if (result.status_code === 20000) {
      // 在此处处理语言列表
      console.log(result);
    } else {
      console.error(
        `接口错误。错误码：${result.status_code}，错误信息：${result.status_message}`
      );
    }
  })
  .catch((error) => {
    console.error("请求失败：", error.response?.data || error.message);
  });

响应结构

接口返回 JSON 对象，主要字段如下。

顶层字段

字段名	类型	说明
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": "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.0012 sec.",
      "cost": 0,
      "result_count": 3,
      "path": [
        "v3",
        "content_analysis",
        "languages"
      ],
      "data": {
        "api": "content_analysis",
        "function": "languages"
      },
      "result": [
        {
          "language_name": "英语",
          "language_code": "en"
        },
        {
          "language_name": "中文",
          "language_code": "zh"
        },
        {
          "language_name": "日语",
          "language_code": "ja"
        }
      ]
    }
  ]
}

状态码说明

• 顶层 status_code 用于表示整个请求的处理结果。
• tasks[].status_code 用于表示任务的处理结果。
• 20000 表示请求成功。
• 状态码表示请求或任务处理异常，错误信息请结合 status_message 查看。

实用场景

• 校验语言代码：在提交分析任务前确认目标语言是否受支持，减少因语言参数无效导致的任务失败。
• 构建多语言分析：根据返回的语言名称和 ISO 639-1 代码生成前端下拉选项，支持多地区 SEO管理。
• 筛选可分析市场：获取平台支持的语言范围，为 SEO 项目选择可覆盖的国家或语言市场。
• 同步语言字：定期拉取最新语言列表并写中心，在业务系统中维护过期的静态语言代码。
• 规范化分析结果：使用统一的 language_code 对、和页面分析结果进行归类，便于跨语言报表统计。