app_data/apple/categories

Apple 应用分类列表

该接口用于获取 App Store 中可用于 App Data API 的完整应用分类列表。

• 请求方法：GET
• 请求地址：https://api.seermartech.cn/v3/app_data/apple/categories
• 计费：****
• 计费说明：本接口不产生费用，扣费以响应头 X-SeerMarTech-Charge-CNY 为准

调用成功后，接口会返回 JSON 格式数据 tasks 数组任务信息，result 中可用分类列表。

如需离线处理完整分类单，也可使用平台提供的 CSV 分类文件（原文提及的下载链接可作为参考文档来源；建议优以接口实时返回结果为准）。

请求说明

HTTP Request

GET /v3/app_data/apple/categories

请求头

名称	类型	填	说明
Authorization	string	是	认证信息，统一使用 Bearer smt_live_YOUR_KEY
Content-Type	string	是	固定为 application/json

返回字段说明

顶层字段

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	接口总体状态码
status_message	string	接口总体状态信息
time	string	执行耗时，单位秒
cost	float	本次请求总费用，单位 USD；本接口通常为 0
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	URL 路径
data	object	GET 请求 URL 中携带的参数信息
result	array	结果数组

tasks[].data 字段

字段名	类型	说明
api	string	API 模块名称，示例值：app_data
function	string	接口功能名称，示例值：categories
se	string	数据源标识，当前为 apple

tasks[].result[] 字段

字段名	类型	说明
categories	array	支持的应用分类完整列表

调用示例

cURL

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

Python

import requests

url = "https://api.seermartech.cn/v3/app_data/apple/categories"
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/categories",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
})
 .then((response) => {
 const result = response.data;
 // 返回结果
 console.log(result);
 })
 .catch((error) => {
 console.log(error);
 });

响应示例

{
 "version": "0.1.20220422",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0782 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "8a7f5b1e-2f2e-4a8c-9d57-1234567890ab",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0123 sec.",
 "cost": 0,
 "result_count": 1,
 "path": [
 "v3",
 "app_data",
 "apple",
 "categories"
 ],
 "data": {
 "api": "app_data",
 "function": "categories",
 "se": "apple"
 },
 "result": [
 {
 "categories": [
 "Books",
 "Business",
 "Education",
 "Entertainment",
 "Finance",
 "Food & Drink",
 "Games",
 "Health & Fitness",
 "Lifestyle",
 "Medical",
 "Music",
 "Navigation",
 "News",
 "Photo & Video",
 "Productivity",
 "Shopping",
 "Social Networking",
 "Sports",
 "Travel",
 "Utilities",
 "Weather"
 ]
 }
 ]
 }
 ]
}

状态码说明

状态码	说明
20000	请求成功
10000-60000	任务级状态码范围，表示不同处理结果
错误码	请参考 /v3/appendix/errors

使用说明

• 该接口适用于在发起 App 查询前，同步平台支持的 Apple 应用分类列表。
• 返回的 categories 可直接用于分类筛选、报表归类或前端下拉选项生成。
• 由于该接口为只读数据接口，通常无需频繁调用；可定期拉取并缓存。
• 如果你的业务还需要数据源分类，请保持 /v3/... 路径规则不变，并调用对应接口。

实用场景

• 同步分类字：定期拉取 Apple 应用分类列表并写本地库，确保筛选器、标签体系和报表口径一致。
• 构建下拉选项：将 categories 直接用于运营后台或数据产品的分类选择器，减少手工维护成本。
• 校验参数：在提交 App 查询任务前校验分类名称是否合法，无效请求和参数错误。
• 统一报表维度：按接口返回的标准分类归并应用数据，提升跨项目、跨周期对比分析的一致性。
• 驱动竞品分组分析：基于官方分类将竞品应用分组，便于观察不同赛道的排名、评价与增长表现。