Skip to content

Google AI Mode SERP 支持的语言列表

GET /v3/serp/google/ai_mode/languages

接口说明

GET /v3/serp/google/ai_mode/languages

本接口返回 Google AI Mode SERP 支持的语言列表语言名称及 ISO 639-1 语言代码。接口无需提交请求体。

计费说明

本接口调用,不产生接口费用。

请求

请求 URL

text
https://api.seermartech.cn/v3/serp/google/ai_mode/languages

请求头

Header类型说明
AuthorizationstringBearer 认证,格式为 Bearer smt_live_YOUR_KEY
Content-Typestring建议设置为 application/json

请求参数

本接口无 URL 参数和请求体。

响应字段

接口返回 JSON 对象 tasks 数组本次请求的任务结果。

顶层字段

字段类型说明
versionstring当前 API 版本
status_codeinteger请求级状态码
status_messagestring请求级状态信息
timestring请求执行耗时,单位为秒
costfloat平台原始 USD 成本兼容字段;人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
tasks_countintegertasks 数组中的任务数量
tasks_errorintegertasks 数组中返回错误的任务数量
tasksarray任务结果数组

tasks 对象字段

字段类型说明
idstring任务唯一标识,UUID 格式
status_codeinteger任务状态码,通常在 1000060000 范围
status_messagestring任务状态信息
timestring任务执行耗时,单位为秒
costfloat平台原始 USD 成本兼容字段;人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
result_countintegerresult 数组中的数量
patharray本次请求对应的 API 路径
dataobject请求路径中使用的接口参数
resultarray语言列表结果

result 数组字段

字段类型说明
language_namestring语言名称
language_codestring按 ISO 639-1 标准定义的语言代码

调用示例

cURL

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

Python

python
import requests

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

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

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

if result.get("status_code") == 20000:
    # 读取支持的语言列表
    tasks = result.get("tasks", [])
    for task in 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"))
    )

TypeScript

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

const result = await response.json();

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}`
  );
}

响应示例

json
{
  "version": "0.1.20251117",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0121 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": " ಒಂದು-uuid-example",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0100 sec.",
      "cost": 0,
      "result_count": 2,
      "path": [
        "v3",
        "serp",
        "google",
        "ai_mode",
        "languages"
      ],
      "data": {
        "api": "serp",
        "function": "languages",
        "se": "google",
        "se_type": "ai_mode"
      },
      "result": [
        {
          "language_name": "English",
          "language_code": "en"
        },
        {
          "language_name": "Chinese",
          "language_code": "zh"
        }
      ]
    }
  ]
}

> id 为示例任务标识,响应中会返回有效的 UUID。
> 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准;本接口为接口。

状态码

  • 20000:请求成功。
  • 状态码:表示请求级或任务级错误,原因以 status_message 为准。

实用场景

  • 获取 Google AI Mode 支持的语言代码,为多语言 SERP 查询动态生成合法参数。
  • 校验 SEO 任务中的语言,因传不支持的语言代码导致任务失败。
  • 构建 多地区监测系统,根据语言列表自动生成不同市场的查询组合。
  • 同步 平台语言,在 SERP 分析后台展示可用语言并减少人工维护成本。
  • 筛选化搜索结果,将语言代码与国家、地区及数据,用于跨市场 SEO 对比分析。

统一入口:官网 · LLM API · 控制台