AI 优化：LLM Mentions 支持的地区与语言

GET /v3/ai_optimization/llm_mentions/locations_and_languages

接口说明

本接口使用 GET 方法，通过以下路径获取 LLM Mentions API 支持的完整地区、语言及平台列表：

GET https://api.seermartech.cn/v3/ai_optimization/llm_mentions/locations_and_languages

该接口无需请求体，也不会产生接口调用费用。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

> 注意： > > - chat_gpt 数据目前支持美国（United States）和英语（English）。 > - 由于服务限制，俄罗斯和白俄罗斯的所有地区目前均不受支持。

请求信息

项目
请求方法	GET
请求地址	https://api.seermartech.cn/v3/ai_optimization/llm_mentions/locations_and_languages
请求头	Authorization: Bearer smt_live_YOUR_KEY
Content-Type	application/json
请求体	无

响应字段

顶层字段

字段	类型	说明
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	请求路径信息
data	object	GET 请求中传的接口参数
result	array	地区与语言支持列表

result 地区字段

字段	类型	说明
location_code	integer	地区代码
location_name	string	地区完整名称
available_languages	array	当前地区支持的语言列表

available_languages 语言字段

字段	类型	说明
available_platforms	array	当前地区与语言组合支持的 LLM 平台。目前支持 google 和 chat_gpt
language_name	string	语言名称
language_code	string	按 ISO 639-1 标准定义的语言代码
responses_count	integer	数据库中当前地区与语言组合可用的 LLM 响应数量

请求示例

cURL

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

Python

import requests

url = "https://api.seermartech.cn/v3/ai_optimization/llm_mentions/locations_and_languages"

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

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

if response.status_code == 200:
    result = response.json()
    if result.get("status_code") == 20000:
        print(result)
    else:
        print(
            "接口错误。状态码: %s，消息: %s"
            % (result.get("status_code"), result.get("status_message"))
        )
else:
    print("HTTP 请求失败：", response.status_code)

TypeScript

import axios from "axios";

async function getLocationsAndLanguages() {
  const response = await axios.get(
    "https://api.seermartech.cn/v3/ai_optimization/llm_mentions/locations_and_languages",
    {
      headers: {
        Authorization: "Bearer smt_live_YOUR_KEY",
        "Content-Type": "application/json",
      },
    }
  );

  const result = response.data;

  if (result.status_code === 20000) {
    console.log(result);
  } else {
    console.error(
      `接口错误。状态码: ${result.status_code}，消息: ${result.status_message}`
    );
  }
}

getLocationsAndLanguages().catch((error) => {
  console.error("请求失败：", error.response?.data || error.message);
});

响应示例

{
  "version": "0.1.20251208",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.2168 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.2141 sec.",
      "cost": 0,
      "result_count": 2,
      "path": [
        "v3",
        "ai_optimization",
        "llm_mentions",
        "locations_and_languages"
      ],
      "data": {
        "api": "ai_optimization",
        "function": "locations_and_languages"
      },
      "result": [
        {
          "location_code": 2004,
          "location_name": "阿尔巴尼亚",
          "available_languages": [
            {
              "available_platforms": [
                "google"
              ],
              "language_name": "阿尔巴尼亚语",
              "language_code": "sq",
              "responses_count": 172
            }
          ]
        },
        {
          "location_code": 2012,
          "location_name": "阿尔及利亚",
          "available_languages": [
            {
              "available_platforms": [
                "google"
              ],
              "language_name": "法语",
              "language_code": "fr",
              "responses_count": 119530
            },
            {
              "available_platforms": [
                "google"
              ],
              "language_name": "阿拉伯语",
              "language_code": "ar",
              "responses_count": 196053
            }
          ]
        }
      ]
    }
  ]
}

状态码

• 顶层 status_code 和任务级 status_code 用于判断请求及任务是否成功。
• 20000 表示请求成功。
• 状态码表示请求或任务处理异常，错误信息以 status_message 为准。

实用场景

• 校验目标地区与语言是否可用：在创建 LLM Mentions 查询任务前验证参数，因地区或语言不支持导致任务失败。
• 筛选可用的 LLM 平台：根据 available_platforms 判断某个地区和语言是否支持 google 或 chat_gpt，合理规划监测范围。
• 估算数据覆盖规模：使用 responses_count 评估不同地区与语言的数据量，为、品牌或竞品监测范围提供依据。
• 构建多地区 SEO 监测：读取完整的地区与语言映射，批量生成化 SEO 和品牌可见度分析任务。
• 动态维护参数选项：定期同步接口返回的支持列表，为后台筛选器、任务创建表单和自动化提供最新选项。