Google 数据语言列表

接口说明

GET /v3/keywords_data/google/languages

本接口用于获取数据接口支持的语言列表。该接口为容性接口，返回结果语言名称及对应的 ISO 639-1 语言代码。

> 俄罗斯和白俄罗斯境的所有地点目前均不受支持。

计费说明

调用本接口不收取费用。

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

请求方式

请求地址

GET https://api.seermartech.cn/v3/keywords_data/google/languages

请求头

Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json

本接口使用 GET 请求，无需请求体或查询参数。

响应字段

接口返回 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	任务结果数组

任务字段

字段	类型	说明
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	请求路径
data	object	请求中传递的参数信息
result	array	语言列表结果

data 字段

字段	类型	说明
api	string	API 模块名称，通常为 keywords_data
function	string	API 操作名称，通常为 languages
se	string	搜索引擎名称，当前为 google

result 字段

字段	类型	说明
language_name	string	语言名称
language_code	string	按 ISO 639-1 标准表示的语言代码

请求示例

cURL

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

Python

import requests

url = "https://api.seermartech.cn/v3/keywords_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:
        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/keywords_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) {
      console.log(result);
      // 在此处理语言列表
    } else {
      console.error(
        `接口错误。状态码：${result.status_code}，说明：${result.status_message}`
      );
    }
  })
  .catch((error) => {
    console.error("请求失败：", error.response?.data || error.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.1234 sec.",
      "cost": 0,
      "result_count": 2,
      "path": [
        "v3",
        "keywords_data",
        "google",
        "languages"
      ],
      "data": {
        "api": "keywords_data",
        "function": "languages",
        "se": "google"
      },
      "result": [
        {
          "language_name": "English",
          "language_code": "en"
        },
        {
          "language_name": "Chinese",
          "language_code": "zh"
        }
      ]
    }
  ]
}

状态码

• 顶层 status_code 用于表示本次 API 请求的整体处理结果。
• 任务中的 status_code 用于表示任务的执行结果。
• 20000 通常表示请求成功。
• 状态码表示请求或任务处理异常，错误信息以 status_message 为准。

实用场景

• 获取支持语言：在创建数据任务前校验目标语言，因使用不支持的语言代码导致任务失败。
• 构建语言选择器：使用返回的语言名称和 ISO 639-1 代码生成后台项，支持多语言研究流程。
• 标准化语言数据：将语言代码统一写、广告或 SEO 数据库，便于跨项目筛选和统计。
• 匹市场：根据目标国家或地区选择对应语言，提升多地区分析和广告投放数据的准确性。