Apple 应用语言列表

调用本接口可获取 App Data API 支持的 Apple 应用语言列表。

该接口为只读查询接口，不产生费用。参考价约 ¥0.0000 / 次，扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

接口说明

• 请求方法：GET
• 请求地址：https://api.seermartech.cn/v3/app_data/apple/languages

调用成功后，服务端会返回 JSON 格式数据，tasks 数组中可用语言信息。

如需完整语言单，可自行基于接口返回结果导出为 CSV 使用。

响应字段说明

顶层字段

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	通用状态码，完整列表参考 /v3/appendix/errors
status_message	string	通用状态信息，完整列表参考 /v3/appendix/errors
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	任务状态说明，完整列表参考 /v3/appendix-errors/
time	string	任务执行时间，单位秒
cost	float	当前任务费用，单位 USD
result_count	integer	result 数组中的数量
path	array	URL 路径
data	object	GET 请求 URL 中传的参数
result	array	结果数组

tasks[].result[] 字段

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

认证方式

请在请求头中使用 Bearer Token 认证：

Authorization: Bearer smt_live_YOUR_KEY

请求示例

cURL

curl --location --request GET "https://api.seermartech.cn/v3/app_data/apple/languages" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json"

Python

import requests

url = "https://api.seermartech.cn/v3/app_data/apple/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";

axios({
 method: "get",
 url: "https://api.seermartech.cn/v3/app_data/apple/languages",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
})
 .then((response) => {
 const result = response.data;
 // 处理返回结果
 console.log(result);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例

{
 "version": "0.1.20220420",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1009 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "app_data",
 "function": "languages",
 "se": "apple"
 },
 "result": []
 }
 ]
}

返回结果说明

该接口主要用于获取 Apple 应用数据支持的语言维度，便于在后续应用商店数据抓取、分析或多语言市场研究中，使用合法且受支持的语言代码。

通常你可以调用本接口获取 language_code，再将用于 /v3/app_data/... 接口请求中，以确保请求参数有效。

错误码

• 顶层状态码见：/v3/appendix/errors
• 任务级状态码见：/v3/appendix-errors/

常见成功状态：

状态码	含义
20000	请求成功

如果 tasks_error 大于 0，说明部分任务返回异常，建议结合 tasks[].status_code 和 tasks[].status_message 逐项排查。

实用场景

• 初始化语言参数映射：拉取平台支持的 Apple 语言代码，建立语言字，后续接口传无效 language_code。
• 校验多语言采集：在批量抓取应用、评论或榜单前，核对目标语言是否受支持，降低任务失败率。
• 构建多地区应用分析流程：将语言列表与地区列表组合，生成可执行的市场监测任务，提升跨市场分析覆盖度。
• 规范数据仓库维度：将标准 language_code 和 language_name 写维表，统一报表、看板与算法任务中的语言口径。
• 支持应用出海研究：筛选目标市场常用语言，为应用本地化、评论分析和竞品对比提供标准化。