主题
App Data Google 语言列表
接口说明
通过调用本接口,可以获取 App Data API 支持的 Google 语言列表。
该接口适用于在发起应用商店数据采集、分析或榜单查询前,确认可用语言范围,提交不受支持的语言参数。
如需批量查看完整语言单,也可下载官方提供的 CSV 列表(最近更新时间为 2026-04-06)。在本平台文档中,建议优通过接口动态获取,以确保与当前能力保持一致。
计费说明
本接口,不产生调用费用。
响应中的 cost 字段通常为 0,扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
请求地址
GET https://api.seermartech.cn/v3/app_data/google/languages
返回结果
接口返回 JSON 数据,顶层 tasks 数组每个任务对象本次请求的状态信息与语言列表结果。
响应字段说明
| 字段名 | 类型 | 说明 |
|---|---|---|
version | string | API 当前版本 |
status_code | integer | 整体状态码,可参考 /v3/appendix/errors |
status_message | string | 整体状态说明 |
time | string | 执行耗时,单位:秒 |
cost | float | 本次请求总费用,单位:USD |
tasks_count | integer | tasks 数组中的任务数量 |
tasks_error | integer | tasks 数组中返回错误的任务数量 |
tasks | array | 任务数组 |
tasks 数组字段
| 字段名 | 类型 | 说明 |
|---|---|---|
id | string | 任务唯一标识,UUID 格式 |
status_code | integer | 任务状态码,范围通常为 10000-60000,可参考 /v3/appendix/errors |
status_message | string | 任务状态说明 |
time | string | 任务执行耗时,单位:秒 |
cost | float | 当前任务费用,单位:USD |
result_count | integer | result 数组中的数量 |
path | array | 请求路径 |
data | object | GET 请求 URL 中传的参数信息 |
result | array | 结果数组 |
result 数组字段
| 字段名 | 类型 | 说明 |
|---|---|---|
language_name | string | 语言名称 |
language_code | string | 语言代码,遵循 ISO 639-1 标准 |
请求示例
curl
bash
curl --location --request GET "https://api.seermartech.cn/v3/app_data/google/languages" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json"Python
python
import requests
url = "https://api.seermartech.cn/v3/app_data/google/languages"
headers = {
"Authorization": "Bearer smt_live_YOUR_KEY",
"Content-Type": "application/json"
}
response = requests.get(url, headers=headers)
print(response.json)TypeScript
typescript
import axios from "axios";
axios({
method: "get",
url: "https://api.seermartech.cn/v3/app_data/google/languages",
headers: {
Authorization: "Bearer smt_live_YOUR_KEY",
"Content-Type": "application/json",
},
})
.then((response) => {
// 返回结果
console.log(response.data);
})
.catch((error) => {
console.error(error);
});响应示例
json
{
"version": "0.1.20220420",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.1009 sec.",
"cost": 0,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "b0b1c2d3-e4f5-6789-abcd-ef0123456789",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0201 sec.",
"cost": 0,
"result_count": 1,
"path": [
"v3",
"app_data",
"google",
"languages"
],
"data": {
"api": "app_data",
"function": "languages",
"se": "google"
},
"result": [
{
"language_name": "English",
"language_code": "en"
},
{
"language_name": "German",
"language_code": "de"
},
{
"language_name": "French",
"language_code": "fr"
}
]
}
]
}状态码说明
| 状态码 | 说明 |
|---|---|
20000 | 请求成功 |
10000-60000 | 任务级状态码范围,含义参考 /v3/appendix/errors |
使用说明
- 本接口为只读查询接口,用于获取 App Data 支持的语言列表。
- 路径中的
/v3/app_data/google/languages保持固定。 google表示对应数据源;在接口中,也可能支持不同搜索引擎或平台。- 建议在业务系统中缓存语言列表,并定期刷新,以减少重复请求。
- 在提交依赖语言参数的任务前,建议校验
language_code是否存在于本接口返回结果中。
实用场景
- 校验语言参数:在提交 App Data 查询任务前验证
language_code,减少无效请求和参数错误。 - 构建语言下拉选项:为运营后台或数据平台动态生成可选语言列表,提升准确性。
- 适多地区应用分析:按支持语言过滤不同市场的应用数据采集范围,提升化分析效率。
- 统一语言编码映射:将业务系统语言名称与 ISO 639-1 代码对齐,便于后续接口自动化调用。
- 定期同步支持范围:监控平台 API 的语言支持变更,及时更新采集策略与报表维度。