AI 数据支持的地区与语言列表

接口说明

通过本接口可以获取 AI Keyword Data API 当前支持的地区与语言列表。

请求方式： GET请求地址： https://api.seermartech.cn/v3/ai_optimization/ai_keyword_data/locations_and_languages

注意：由于合规限制，俄罗斯和白俄罗斯的所有地区在平台 API 的服务中均不再支持。

计费说明

该接口本身不收费。 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

响应结构

接口返回 JSON 数据，顶层 tasks 数组可用地区及支持语言信息。

顶层字段

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	局状态码
status_message	string	局状态信息
time	string	接口执行时间，单位秒
cost	float	本次请求总成本，单位 USD
tasks_count	integer	tasks 数组中的任务数
tasks_error	integer	tasks 数组中返回错误的任务数
tasks	array	任务结果数组

完整错误码与状态说明可参考 /v3/appendix/errors

tasks[] 字段

字段名	类型	说明
id	string	任务唯一标识，UUID 格式
status_code	integer	任务状态码，范围通常为 10000-60000
status_message	string	任务状态说明
time	string	任务执行时间，单位秒
cost	float	当前任务成本，单位 USD
result_count	integer	result 数组中的结果数量
path	array	请求路径
data	object	GET 请求 URL 中携带的参数信息
result	array	结果数组

result[] 字段

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

available_languages[] 字段

字段名	类型	说明
language_name	string	语言名称
language_code	string	语言代码，遵循 ISO 639-1 标准

请求示例

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)
result = response.json

if result.get("status_code") == 20000:
 print(result)
else:
 print(f'error. Code: {result.get("status_code")} Message: {result.get("status_message")}')

TypeScript

import axios from "axios";

// 获取 AI 数据支持的地区与语言列表
axios({
 method: "get",
 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"
 }
})
 .then((response) => {
 // 返回结果
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例

{
 "version": "0.1.20250526",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.2636 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "ai_optimization",
 "function": "locations_and_languages"
 },
 "result": [
 {
 "location_code": 2012,
 "location_name": "Algeria",
 "available_languages": []
 },
 {
 "location_code": 2862,
 "location_name": "Venezuela",
 "available_languages": []
 }
 ]
 }
 ]
}

状态码说明

状态码	说明
20000	请求成功
10000-60000	任务级状态码范围，含义请参考 /v3/appendix/errors

使用建议

在调用 AI Keyword Data 接口前，建议通过本接口获取可用的 location_code 与对应语言列表，再据此构造后续查询请求，以因地区或语言不支持而导致请求失败。

实用场景

• 初始化地区语言映射表：同步本平台支持的国家/地区与语言，为分析、生成或投放系统提供标准参数来源。
• 校验请求参数：在提交 AI 查询前校验 location_code 和 language_code 是否有效，减少无效请求与失败重试。
• 构建多地区 SEO 工作流：根据不同市场可用语言自动生成区域化研究任务，提升化 SEO 运营效率。
• 驱动前端下拉选项：为控制台、表单或动态提供地区与语言候选列表，降低手工维护成本。
• 监控平台支持范围变化：定期拉取支持列表，识别新增或下线地区/语言，及时调整出海 SEO 或本地化策略。