数据语言列表（Wp）

接口说明

GET /v3/keywords_data/wp/languages

用于获取 Keywords Data API 在 wp 数据源下支持的语言列表。

调用本接口后，服务端会返回 JSON 结构数据 tasks 数组可用语言信息。

计费说明

本接口不收费。

可参考响应中的 cost 字段确认扣费；当前该接口通常为 0。

请求地址

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

请求头

头字段	值
Authorization	Bearer smt_live_YOUR_KEY
Content-Type	application/json

路径说明

该接口路径中的 wp 表示对应的数据源类型。除 wp 外，容路径中还可使用搜索引擎或数据源标识；以对应接口文档为准。

响应字段

顶层字段

字段	类型	说明
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	返回结果数组

tasks[].data 字段

字段	类型	说明
api	string	API 模块名称
function	string	当前调用的方法名称
se	string	数据源标识，此处为 wp

tasks[].result[] 字段

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

请求示例

curl

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

Python

import requests

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

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

TypeScript

import axios from "axios";

// 获取 wp 数据源支持的语言列表
axios({
 method: "get",
 url: "https://api.seermartech.cn/v3/keywords_data/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": [
 {
 "id": "12345678-1234-1234-1234-1234567890ab",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0210 sec.",
 "cost": 0,
 "result_count": 2,
 "path": [
 "v3",
 "keywords_data",
 "wp",
 "languages"
 ],
 "data": {
 "api": "keywords_data",
 "function": "languages",
 "se": "wp"
 },
 "result": [
 {
 "language_name": "English",
 "language_code": "en"
 },
 {
 "language_name": "Spanish",
 "language_code": "es"
 }
 ]
 }
 ]
}

状态码说明

状态码	说明
20000	请求成功
10000-60000	任务级状态码范围，表示不同处理结果或错误状态

通用错误码与状态信息请参考 /v3/appendix/errors。

使用建议

• 在提交查询任务前，调用本接口获取可用语言，传不支持的 language_code
• 若需要做语言下拉选项或中心，可将返回结果缓存到本地，定期刷新
• 当同一业务同时支持多个数据源时，应分别确认不同容路径下的语言支持

实用场景

• 初始化语言：为研究、排名监控等功能自动生成可选语言列表，减少人工维护成本
• 校验查询参数：在提交量级、趋势或建议词请求前校验 language_code，降低无效请求和报错率
• 构建多语言 SEO 工：为英文、西语等多语言站点提供统一的语言选择能力，提升化 SEO 覆盖范围
• 同步主数据字：将支持语言写库，供前端表单、任务系统和报表模块复用
• 排查接口容性：在接不同数据路径时确认语言支持范围，因语言不匹导致结果为空或任务失败