主题
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 | 类型 | 填 | 说明 |
|---|---|---|---|
Authorization | string | 是 | Bearer 认证,格式为 Bearer smt_live_YOUR_KEY |
Content-Type | string | 否 | 建议设置为 application/json |
请求参数
本接口无 URL 参数和请求体。
响应字段
接口返回 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 | 本次请求对应的 API 路径 |
data | object | 请求路径中使用的接口参数 |
result | array | 语言列表结果 |
result 数组字段
| 字段 | 类型 | 说明 |
|---|---|---|
language_name | string | 语言名称 |
language_code | string | 按 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 对比分析。