AI 数据 API：位置与语言列表

GET /v3/ai_optimization/ai_keyword_data/locations_and_languages

本接口使用 GET 方法，通过以下路径获取 AI 数据 API 支持的位置及可用语言：

GET /v3/ai_optimization/ai_keyword_data/locations_and_languages

该接口无需请求参数，返回 JSON 格式的数据，支持的国家/地区、位置代码及对应的语言列表。

> 注意： 由于服务政策调整，俄罗斯和白俄罗斯境的位置目前不再受支持。

计费说明

当前使用本接口不收取费用，响应中的 cost 通常为 0。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求示例

cURL

curl --location --request GET \
  "https://api.seermartech.cn/v3/ai_optimization/ai_keyword_data/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/ai_keyword_data/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()
    print(result)
else:
    print(f"请求失败，HTTP 状态码：{response.status_code}")
    print(response.text)

TypeScript

import axios from "axios";

axios
  .get(
    "https://api.seermartech.cn/v3/ai_optimization/ai_keyword_data/locations_and_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);
  });

响应结构

接口返回一个 tasks 数组的 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 字段

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

响应示例

{
  "version": "0.1.20250526",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.2636 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": " ಮರ00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.1234 sec.",
      "cost": 0,
      "result_count": 2,
      "path": [
        "v3",
        "ai_optimization",
        "ai_keyword_data",
        "locations_and_languages"
      ],
      "data": {
        "api": "ai_optimization",
        "function": "locations_and_languages"
      },
      "result": [
        {
          "location_code": 2012,
          "location_name": "Algeria",
          "available_languages": [
            {
              "language_name": "Arabic",
              "language_code": "ar"
            },
            {
              "language_name": "French",
              "language_code": "fr"
            }
          ]
        },
        {
          "location_code": 2862,
          "location_name": "Venezuela",
          "available_languages": [
            {
              "language_name": "Spanish",
              "language_code": "es"
            }
          ]
        }
      ]
    }
  ]
}

> 示例中的位置和语言用于展示响应结构，返回以接口当前支持范围为准。

状态码

接口请求级状态码和任务级状态码。常见成功状态码为：

状态码	说明
20000	请求成功

状态码及状态说明请参考错误码文档。

实用场景

• 构建位置选择器：获取所有可用国家、地区及位置代码，为 SEO 平台提供标准化的目标市场选择功能。
• 校验语言：根据目标位置读取支持的语言，任务提交不受支持的语言参数。
• 生成多地区任务：批量组合位置代码与语言代码，开展 SEO 研究和市场对比。
• 维护本地化：定期同步位置和语言列表，及时更新站点化及多语言策略。
• 筛选可服务市场：在项目创建前判断目标国家或地区是否受支持，降低无效任务提交和错误。