SERP Haosou 语言列表

通过 GET /v3/serp/haosou/languages 获取 Haosou 搜索引擎支持的语言列表。

计费说明

本接口当前不收取调用费用，响应中的 cost 为 0。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求

HTTP 方法与路径

GET https://api.seermartech.cn/v3/serp/haosou/languages

本接口无需请求体。

请求示例

cURL

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

Python

import requests

url = "https://api.seermartech.cn/v3/serp/haosou/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(
        "请求失败，错误码：%s，错误信息：%s"
        % (result.get("status_code"), result.get("status_message"))
    )

TypeScript

import axios from "axios";

axios
  .get("https://api.seermartech.cn/v3/serp/haosou/languages", {
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
  })
  .then((response) => {
    // 响应数据
    console.log(response.data);
  })
  .catch((error) => {
    console.error("请求失败：", error.response?.data || error.message);
  });

响应结构

接口返回 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	请求 URL 路径
data	array	GET 请求中传递的 URL 参数信息
result	array	语言列表结果

result 语言字段

字段	类型	说明
language_name	string	语言名称
language_code	string	按 ISO 639-1 标准定义的语言代码

响应示例

{
  "version": "0.1.20210105",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0777 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "01234567-89ab-cdef-0123-456789abcdef",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0500 sec.",
      "cost": 0,
      "result_count": 2,
      "path": [
        "v3",
        "serp",
        "haosou",
        "languages"
      ],
      "data": {
        "api": "serp",
        "function": "languages",
        "se": "haosou"
      },
      "result": [
        {
          "language_name": "Chinese",
          "language_code": "zh"
        },
        {
          "language_name": "English",
          "language_code": "en"
        }
      ]
    }
  ]
}

状态码

• 顶层 status_code 表示本次 API 请求的整体处理结果。
• 任务中的 status_code 表示对应任务的处理结果。
• 当状态码为 20000 时，表示请求成功。
• 状态码表示请求或任务处理异常，错误信息请参考错误码文档。

实用场景

• 获取支持语言：在创建 Haosou SERP 查询任务前校验语言代码，因传不支持的语言导致任务失败。
• 构建语言选择器：将接口返回的语言名称和语言代码生成后台选项，支持多语言 SEO 项目管理。
• 规范任务参数：统一使用 ISO 639-1 语言代码排名监测任务，提高跨地区数据的一致性。
• 初始化区域化报表：根据可用语言列表建立搜索结果分析维度，便于比较不同语言市场的排名表现。
• 校验系统：定期获取语言列表并与本地比对，及时发现平台支持范围变化。