Google 应用数据 API 支持语言列表

GET /v3/app_data/google/languages

通过 GET /v3/app_data/google/languages 获取应用数据 API 支持的 Google 语言列表。本接口无需请求体，返回 JSON 格式的语言信息。

请求信息

• 请求方法：GET
• 请求路径：/v3/app_data/google/languages
• 完整 URL：https://api.seermartech.cn/v3/app_data/google/languages
• 认证方式：Bearer Token
• 请求体：无

计费说明

本接口不收取调用费用，响应中的 cost 通常为 0。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

响应结构

接口返回 tasks 数组的 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	当前请求的 API 路径
data	object	当前请求中使用的参数信息
result	array	支持的语言列表

data 字段

字段	类型	说明
api	string	API 模块名称，值为 app_data
function	string	接口名称，值为 languages
se	string	搜索引擎名称，值为 google

result 数组字段

字段	类型	说明
language_name	string	语言名称
language_code	string	根据 ISO 639-1 标准定义的语言代码

请求示例

cURL

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

Python

import requests

url = "https://api.seermartech.cn/v3/app_data/google/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:
        # 处理语言列表
        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"))
        )
else:
    print("HTTP 请求失败：", response.status_code)

TypeScript

import axios from "axios";

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

    if (result.status_code === 20000) {
      // 处理语言列表
      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.20220420",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1009 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0800 sec.",
      "cost": 0,
      "result_count": 2,
      "path": [
        "v3",
        "app_data",
        "google",
        "languages"
      ],
      "data": {
        "api": "app_data",
        "function": "languages",
        "se": "google"
      },
      "result": [
        {
          "language_name": "English",
          "language_code": "en"
        },
        {
          "language_name": "Chinese",
          "language_code": "zh"
        }
      ]
    }
  ]
}

状态码

• 20000：请求成功。
• 状态码：请求或任务处理失败，原因请结合 status_message 判断。

实用场景

• 获取可用语言代码：在提交应用数据查询任务前校验语言参数，因语言代码不受支持导致任务失败。
• 构建语言选择器：将接口返回的语言名称和代码用于后台或前端下拉选项，支持多语言应用数据分析。
• 同步语言字：定期拉取最新语言列表并更新，确保 SEO 任务参数与平台支持范围保持一致。
• 校验批量任务参数：在批量生成 Google 应用数据任务前统一检查语言字段，提高任务提交成功率。
• 分析多语言市场：基于支持的语言范围规划不同国家和地区的应用、排名及市场分析任务。