OnPage Lighthouse 语言列表

接口说明

该接口用于获取 OnPage Lighthouse 支持的语言列表。

• 请求方式：GET
• 请求地址：https://api.seermartech.cn/v3/on_page/lighthouse/languages
• 计费说明：调用不收费
• 扣费：以响应中的 cost 字段为准；本接口通常为 0

调用成功后，服务端会返回 JSON 格式数据 tasks 数组，以及每个任务对应的结果信息。

---

请求信息

HTTP Request

GET /v3/on_page/lighthouse/languages

请求头

Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json

这是一个 GET 接口，无需请求体。

---

响应结构

顶层字段

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	通用状态码
status_message	string	通用状态信息
time	string	执行耗时，单位秒
cost	float	本次请求总费用，单位 USD
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 标准

---

状态码说明

• 顶层 status_code 表示整次请求的执行状态
• tasks[].status_code 表示单个任务的执行状态
• 错误码与状态信息可参考 /v3/appendix/errors

常见成功状态：

状态码	说明
20000	请求成功

---

调用示例

cURL

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

Python

import requests

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

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

if data.get("status_code") == 20000:
 print(data)
 # 可在此处理语言列表结果
else:
 print(f'error. Code: {data.get("status_code")} Message: {data.get("status_message")}')

TypeScript

import axios from "axios";

async function getLighthouseLanguages {
 try {
 const response = await axios({
 method: "get",
 url: "https://api.seermartech.cn/v3/on_page/lighthouse/languages",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
 });

 const result = response.data;
 console.log(result); // 返回结果
 } catch (error) {
 console.error(error);
 }
}

getLighthouseLanguages;

---

响应示例

{
 "version": "0.1.20220819",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0667 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "on_page",
 "function": "lighthouse"
 },
 "result": []
 }
 ]
}

说明：原始示例中展示了部分响应结构，返回中通常还会 id、status_code、status_message、time、cost、result_count、path 等任务级字段。

---

返回结果解读

该接口主要用于获取 Lighthouse 可用语言，便于后续在页面质量分析、技术 SEO 诊断等任务中传合法的语言参数。

你可以重点：

• result[].language_name：语言名称，如 English、German 等
• result[].language_code：对应的 ISO 639-1 语言代码，如 en、de

建议在业务系统中将该接口结果缓存，用于：

• 生成语言下拉选项
• 校验用户的语言参数
• 保持与平台 API 支持范围一致

---

实用场景

• 拉取可用语言列表：在创建 Lighthouse 分析任务前同步支持语言，传无效语言代码导致请求失败。
• 生成前端语言选项：为 SEO 审计后台或运营提供标准化语言下拉菜单，减少人工错误。
• 校验任务参数：在提交页面性能或技术审计任务前，对 language_code 做本地校验，提高任务成功率。
• 同步多语言站点：针对多国家、多语种网站，统一维护可分析语言范围，提升化 SEO 流程稳定性。
• 建立语言映射表：将 ISO 639-1 代码与语言体系做映射，便于报表、任务调度和自动化分析使用。