数据 / Clickstream Data / 地区与语言列表

接口说明

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

接口地址

GET https://api.seermartech.cn/v3/keywords_data/clickstream_data/locations_and_languages

注意事项

• 本接口用于查询 Clickstream 数据能力支持的地区与语言映射。
• 俄罗斯和白俄罗斯的地区目前在平台 API 的所有服务中均不再支持。
• 该接口不收费，扣费以响应头 X-SeerMarTech-Charge-CNY 为准；该接口通常返回 0。

响应结构

接口返回 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	地区名
location_code_parent	integer / null	上级地区编码。该接口通常支持国家级地区，因此该值一般为 null
country_iso_code	string	地区对应的国家 ISO 代码
location_type	string	地区类型。常见值为 Country
available_languages	array	该地区支持的语言列表

available_languages 数组字段

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

请求示例

cURL

curl --location --request GET "https://api.seermartech.cn/v3/keywords_data/clickstream_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/keywords_data/clickstream_data/locations_and_languages"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

# 获取 Clickstream Data 支持的地区与语言列表
response = requests.get(url, headers=headers)
data = response.json

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

TypeScript

const url = 'https://api.seermartech.cn/v3/keywords_data/clickstream_data/locations_and_languages';

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

 const result = await response.json;

 if (result.status_code === 20000) {
 console.log(result);
 } else {
 console.log(`error. Code: ${result.status_code} Message: ${result.status_message}`);
 }
}

getLocationsAndLanguages;

响应示例

{
 "version": "0.1.20240801",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.2685 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "keywords_data",
 "function": "locations_and_languages",
 "se": "clickstream_data"
 },
 "result": [
 {
 "location_code": 2024,
 "location_name": "Angola",
 "location_code_parent": null,
 "country_iso_code": "AO",
 "location_type": "Country",
 "available_languages": []
 },
 {
 "location_code": 2031,
 "location_name": "Azerbaijan",
 "location_code_parent": null,
 "country_iso_code": "AZ",
 "location_type": "Country",
 "available_languages": []
 },
 {
 "location_code": 2032,
 "location_name": "Argentina",
 "location_code_parent": null,
 "country_iso_code": "AR",
 "location_type": "Country",
 "available_languages": []
 },
 {
 "location_code": 2036,
 "location_name": "Australia",
 "location_code_parent": null,
 "country_iso_code": "AU",
 "location_type": "Country",
 "available_languages": []
 },
 {
 "location_code": 2124,
 "location_name": "Canada",
 "location_code_parent": null,
 "country_iso_code": "CA",
 "location_type": "Country",
 "available_languages": []
 },
 {
 "location_code": 2158,
 "location_name": "Taiwan",
 "location_code_parent": null,
 "country_iso_code": "TW",
 "location_type": "Region",
 "available_languages": []
 },
 {
 "location_code": 2250,
 "location_name": "France",
 "location_code_parent": null,
 "country_iso_code": "FR",
 "location_type": "Country",
 "available_languages": []
 },
 {
 "location_code": 2344,
 "location_name": "Hong Kong",
 "location_code_parent": null,
 "country_iso_code": "HK",
 "location_type": "Region",
 "available_languages": []
 },
 {
 "location_code": 2392,
 "location_name": "Japan",
 "location_code_parent": null,
 "country_iso_code": "JP",
 "location_type": "Country",
 "available_languages": []
 },
 {
 "location_code": 2840,
 "location_name": "United States",
 "location_code_parent": null,
 "country_iso_code": "US",
 "location_type": "Country",
 "available_languages": []
 }
 ]
 }
 ]
}

状态码说明

字段	说明
status_code = 20000	请求成功
状态码	表示请求或任务异常，请参考 /v3/appendix/errors

使用建议

在调用依赖 location_code 与 language_code 的 Clickstream 接口前，建议调用本接口缓存支持范围，以便：

• 校验前端下拉项是否合法
• 避提交平台不支持的地区或语言组合
• 在多国家站点场景中动态构建投放或分析维度

实用场景

• 初始化地区语言字：拉取 Clickstream 支持的国家与语言列表，构建后台表，减少人工维护成本。
• 校验投放参数：在用户提交分析任务前，验证 location_code 与语言是否受支持，降低无效请求和报错率。
• 生成站筛选器：为 SEO 平台生成“国家 / 语言”联动筛选器，帮助运营快速切换目标市场。
• 同步平台支持范围：定期刷新地区与语言数据，确保系统与平台能力一致，数据断层。
• 限制业务可选市场：结合企业出海国家列表，从支持国家中筛选可运营市场，提升分析与投放效率。