SERP 语言列表

GET /v3/serp/wp/languages

接口说明

该接口用于获取指定搜索引擎的可用语言列表。

• 请求方式：GET
• 请求地址：https://api.seermartech.cn/v3/serp/wp/languages
• 计费：，不扣费
• 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准

，路径中的 wp 表示搜索引擎类型；除 wp 外，也可以替换为受支持的搜索引擎参数。

你也可以通过平台提供的语言单文件获取完整的支持语言列表。原文中提供了 Google、Bing、Yahoo、YouTube 的 CSV 下载；在本平台文档中建议以接口实时返回结果为准。

请求参数

该接口为 GET 请求，无请求体。

路径参数

参数名	类型	说明
se	string	搜索引擎标识。示例中为 wp，即请求路径 /v3/serp/wp/languages 中的动态部分。不同搜索引擎支持的语言可能不同。

返回结构

接口返回 JSON 数据，顶层 tasks 数组每个 task 对应一次请求任务的执行结果。

顶层字段

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	接口总体状态码
status_message	string	接口总体状态信息
time	string	执行耗时，单位秒
cost	float	本次请求总成本，单位 USD；本接口通常为 0
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
result_count	integer	result 数组中的数量
path	array	请求 URL 路径
data	object	GET 请求 URL 中传的参数
result	array	结果数组

result[] 字段

字段名	类型	说明
language_name	string	语言名称
language_code	string	语言代码，遵循 ISO 639-1 标准

请求示例

cURL

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

Python

import requests

url = "https://api.seermartech.cn/v3/serp/wp/languages"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

# 获取指定搜索引擎支持的语言列表
response = requests.get(url, headers=headers)

if response.ok:
 data = response.json
 print(data)
else:
 print(response.status_code, response.text)

TypeScript

import axios from "axios";

// 获取指定搜索引擎支持的语言列表
axios.get("https://api.seermartech.cn/v3/serp/wp/languages", {
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 }
}).then((response) => {
 console.log(response.data);
}).catch((error) => {
 console.error(error);
});

响应示例

{
 "version": "3.20191128",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1773 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "serp",
 "function": "languages",
 "se": "wp"
 },
 "result": []
 }
 ]
}

状态码说明

你可以结合响应中的以下字段判断请求是否成功：

• 顶层 status_code：整个请求的总体状态
• tasks[].status_code：单个任务的执行状态

常见成功状态：

状态码	说明
20000	请求成功

如需处理异常，请同时检查：

• status_message
• tasks_error
• tasks[].status_message

使用说明

1. 调用 /v3/serp/{se}/languages 获取指定搜索引擎支持的语言列表；
2. 从 result 数组中读取每个语言对象；
3. 使用 language_code 作为后续 SERP 查询中的语言参数映射依据；
4. 若你同时支持多个搜索引擎，建议分别调用不同 se 路径并建立本地语言映射表。

注意事项

• 本接口本身不返回搜索结果返回可用语言数据；
• 不同搜索引擎支持的语言集合可能不同；
• language_code 遵循 ISO 639-1 标准，适合作为标准化语言键；
• 本接口通常，但仍建议以响应中的 cost 字段为准。

实用场景

• 构建语言下拉选项：为站 SERP 查询动态生成可选语言列表，前端写死。
• 校验语言参数：在提交抓取任务前校验语言代码是否受支持，减少无效请求和参数错误。
• 维护多引擎映射表：分别拉取不同搜索引擎的语言单，建立统一的语言容字，提升跨平台查询稳定性。
• 驱动化 SEO 分析：按语言维度组织采集和排名监控任务，支持多国家/多语种市场分析。
• 自动同步平台：定期刷新支持语言列表，确保系统与平台 API 的最新能力保持一致。