LLM Scraper 支持语言列表

GET /v3/ai_optimization/wp/v2/languages

该接口用于获取 LLM Scraper 支持的语言列表语言名称及 ISO 639-1 语言代码。路径中的 wp 表示目标大语言模型标识；如需查询模型支持的语言，请使用对应模型的容路径。

调用此接口不收费。

请求

GET https://api.seermartech.cn/v3/ai_optimization/wp/v2/languages
Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json

请求参数

本接口不需要请求参数。

响应字段

字段	类型	说明
version	string	当前 API 版本。
status_code	integer	局响应状态码。20000 表示请求成功。
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 格式。
tasks[].status_code	integer	任务状态码，取值范围通常为 10000–60000。
tasks[].status_message	string	任务状态说明。
tasks[].time	string	任务执行耗时，单位为秒。
tasks[].cost	float	平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
tasks[].result_count	integer	result 数组中的结果数量。
tasks[].path	array	本次请求调用的 URL 路径信息。
tasks[].data	object	GET 请求路径中使用的参数信息。
tasks[].result	array	支持语言列表。
tasks[].result[].language_name	string	语言名称。
tasks[].result[].language_code	string	ISO 639-1 标准语言代码。

curl 示例

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

Python 示例

import requests

url = "https://api.seermartech.cn/v3/ai_optimization/wp/v2/languages"

headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY",
    "Content-Type": "application/json",
}

# 获取 wp 模型对应的支持语言列表
response = requests.get(url, headers=headers, timeout=30)
response.raise_for_status()

result = response.json()

if result.get("status_code") == 20000:
    # 输出支持的语言列表
    languages = result["tasks"][0].get("result", [])
    for language in languages:
        print(f'{language["language_name"]}: {language["language_code"]}')
else:
    print(
        f'请求失败：{result.get("status_code")} - '
        f'{result.get("status_message")}'
    )

TypeScript 示例

const url =
  "https://api.seermartech.cn/v3/ai_optimization/wp/v2/languages";

async function getSupportedLanguages() {
  const response = await fetch(url, {
    method: "GET",
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
  });

  if (!response.ok) {
    throw new Error(`HTTP 请求失败：${response.status}`);
  }

  const result = await response.json();

  if (result.status_code !== 20000) {
    throw new Error(
      `接口请求失败：${result.status_code} - ${result.status_message}`
    );
  }

  // 获取 wp 模型支持的语言列表
  const languages = result.tasks?.[0]?.result ?? [];

  for (const language of languages) {
    console.log(`${language.language_name}: ${language.language_code}`);
  }
}

getSupportedLanguages().catch(console.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-123456789abc",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.1773 sec.",
      "cost": 0,
      "result_count": 2,
      "path": [
        "v3",
        "ai_optimization",
        "wp",
        "v2",
        "languages"
      ],
      "data": {
        "api": "ai_optimization",
        "function": "languages",
        "se": "wp",
        "se_type": "v2"
      },
      "result": [
        {
          "language_name": "English",
          "language_code": "en"
        },
        {
          "language_name": "Chinese",
          "language_code": "zh"
        }
      ]
    }
  ]
}

状态码与错误处理

• 20000：请求和任务执行成功。
• 状态码：表示认证失败、请求频率受限、路径参数不正确或服务端处理异常等。
• 建议同时检查局 status_code 和 tasks[].status_code，以确保任务级结果可用。
• 当 tasks_error 大于 0 时，应遍历 tasks 并读取对应任务的 status_message，定位失败原因。

实用场景

• 校验语言覆盖范围：在发起 LLM 可见性或抓取任务前，确认目标语种是否受支持，提交无效请求。
• 构建多语言 SEO置界面：将接口返回的语言名称和代码同步至后台下拉选项，降低人工维护语言列表的成本。
• 自动分化分析任务：根据站点目标市场的语言代码，筛选可执行的模型与语种组合，提高任务调度成功率。
• 监控语言能力变更：定期拉取并比对语言列表，及时发现新增或调整的支持语种，优化化分析策略。