主题
域名技术分析语言列表
接口说明
通过本接口可获取 Domain Analytics Technologies API 支持的语言列表。
- 请求方式:
GET - 请求地址:
https://api.seermartech.cn/v3/domain_analytics/technologies/languages - 是否计费:调用
- 扣费:以响应中的
cost字段为准
接口返回 JSON 数据,顶层 tasks 数组,每个任务中本次请求的结果信息。
请求信息
HTTP Request
GET /v3/domain_analytics/technologies/languages
请求头
| 请求头 | 类型 | 是否填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | 使用 Bearer Token 认证:Bearer smt_live_YOUR_KEY |
| Content-Type | string | 否 | 建议传 application/json |
该接口为 GET 请求,无需提交业务参数。
响应结构
顶层字段
| 字段名 | 类型 | 说明 |
|---|---|---|
version | string | 当前 API 版本 |
status_code | integer | 接口通用状态码,完整列表见 /v3/appendix/errors |
status_message | string | 接口通用状态信息,完整列表见 /v3/appendix/errors |
time | string | 执行耗时,单位秒 |
cost | float | 本次请求总费用,单位 USD |
tasks_count | integer | tasks 数组中的任务数量 |
tasks_error | integer | tasks 数组中返回错误的任务数量 |
tasks | array | 任务结果数组 |
tasks[] 字段
| 字段名 | 类型 | 说明 |
|---|---|---|
id | string | 任务唯一标识,UUID 格式 |
status_code | integer | 任务状态码,范围通常为 10000-60000,完整列表见 /v3/appendix/errors |
status_message | string | 任务状态信息 |
time | string | 任务执行耗时,单位秒 |
cost | float | 当前任务费用,单位 USD |
result_count | integer | result 数组中的数量 |
path | array | 请求路径 |
data | object | GET 请求 URL 中传递的参数信息 |
result | array | 返回结果数组 |
tasks[].data 字段
| 字段名 | 类型 | 说明 |
|---|---|---|
api | string | API 模块名 |
function | string | 功能名 |
se | string | 数据分类,这里为 technologies |
tasks[].result[] 字段
| 字段名 | 类型 | 说明 |
|---|---|---|
language_name | string | 语言名称 |
language_code | string | 语言代码,遵循 ISO 639-1 标准 |
请求示例
cURL
bash
curl --location --request GET "https://api.seermartech.cn/v3/domain_analytics/technologies/languages" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json"Python
python
import requests
url = "https://api.seermartech.cn/v3/domain_analytics/technologies/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:
print(result)
else:
print(f"error. Code: {result.get('status_code')} Message: {result.get('status_message')}")TypeScript
typescript
import axios from "axios";
async function getLanguages {
try {
const response = await axios.get(
"https://api.seermartech.cn/v3/domain_analytics/technologies/languages",
{
headers: {
Authorization: "Bearer smt_live_YOUR_KEY",
"Content-Type": "application/json",
},
}
);
const result = response.data;
console.log(result);
} catch (error) {
console.error(error);
}
}
getLanguages;响应示例
json
{
"version": "3.20191128",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.1773 sec.",
"cost": 0,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"data": {
"api": "domain_analytics",
"function": "languages",
"se": "technologies"
},
"result": [
{
"language_name": "English",
"language_code": "en"
}
]
}
]
}状态码说明
| 状态码 | 说明 |
|---|---|
20000 | 请求成功 |
10000-60000 | 任务级状态码范围,含义见 /v3/appendix/errors |
如果接口调用失败,可优检查以下:
Authorization是否正确为Bearer smt_live_YOUR_KEY- 请求地址是否为
/v3/domain_analytics/technologies/languages - 账户权限是否已开通对应 API
- 返回体中的
status_code、status_message和tasks_error是否存在异常
使用说明
该接口适合在调用技术分析接口前,获取可用语言单,以便:
- 构建前端语言下拉选项
- 校验用户的语言代码是否合法
- 统一系统中的语言编码标准
- 为后续域名技术分析请求匹正确语言参数
实用场景
- 校验语言参数:在提交域名技术分析请求前拉取支持语言列表,传无效语言代码导致请求失败。
- 生成语言筛选器:为 SEO 平台、分析后台或报表系统动态生成语言下拉菜单,减少手动维护的成本。
- 统一语言编码:将外部业务系统中的语言名称映射为 ISO 639-1 代码,提升跨系统数据对齐效率。
- 适多语言市场分析:在分析不同国家或语种的网站技术栈时,确认支持语言范围,便于批量任务规划。
- 优化数据库流程:将返回的语言代码表作为基础字库,便于后续报表、过滤和聚合分析。