Google 应用分类列表

接口说明

该接口用于获取 Google Play 支持的应用分类列表，适用于 App Data API 的分类枚举查询。

• 请求方法：GET
• 请求地址：https://api.seermartech.cn/v3/app_data/google/categories
• 计费说明：接口
• 返回格式：JSON

调用成功后，接口会返回一个 tasks 数组的响应对象当前可用的应用分类信息。

如需获取最新支持的分类列表，也可结合平台返回结果自行缓存。调用以接口响应为准。

请求信息

HTTP Request

GET /v3/app_data/google/categories
Host: api.seermartech.cn
Authorization: Bearer smt_live_YOUR_KEY
Content-Type: application/json

路径说明

该接口路径中的：

• app_data：应用数据模块
• google：数据来源为 Google Play
• categories：返回分类列表

计费

该接口不收取费用。

• 参考价约 ¥0.0000 / 次
• 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准

响应结构

顶层字段

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

result 数组字段

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

data 对象示例字段

字段名	类型	说明
api	string	API 模块名，固定为 app_data
function	string	接口功能名，固定为 categories
se	string	搜索引擎/应用商店标识，此处为 google

请求示例

cURL

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

Python

import requests

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

// 获取 Google Play 应用分类列表
axios({
 method: "get",
 url: "https://api.seermartech.cn/v3/app_data/google/categories",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json",
 },
})
 .then(function (response) {
 // 返回结果
 console.log(response.data);
 })
 .catch(function (error) {
 console.log(error);
 });

响应示例

以下示例根据参考文档结构整理。返回字段以接口实时响应为准。

{
 "version": "0.1.20220420",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0557 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "app_data",
 "function": "categories",
 "se": "google"
 },
 "result": [
 {
 "categories": [
 "ART_AND_DESIGN",
 "AUTO_AND_VEHICLES",
 "BEAUTY",
 "BOOKS_AND_REFERENCE",
 "BUSINESS",
 "COMICS",
 "COMMUNICATION",
 "DATING",
 "EDUCATION",
 "ENTERTAINMENT"
 ]
 }
 ]
 }
 ]
}

状态码说明

顶层状态码

• 20000：请求成功
• 状态码：表示请求参数、认证或服务处理出现异常

任务状态码

tasks[].status_code 为单任务状态码，通常范围在 10000-60000。 完整错误码与说明请参考：/v3/appendix/errors

使用建议

1. 该接口适合在系统初始化时拉取并缓存分类枚举。
2. 当您需要构建应用分类筛选器、分类映射表或数据洗规则时，可优调用该接口获取标准分类值。
3. 若后续业务流程依赖分类字段作为参，建议定期同步最新分类，使用过期枚举值。

实用场景

• 同步分类字：定时拉取 Google Play 应用分类列表，维护标准分类库，人工维护枚举带来的错误。
• 校验采集结果：在库前校验应用所属分类是否合法，提升应用数据洗质量与结构化一致性。
• 构建筛选器：为应用市场分析后台生成分类下拉选项，支持按分类查看榜单、评价或竞品数据。
• 映射业务标签：将平台标准分类映射到行业标签体系，便于统一报表、客户分层与专题分析。
• 竞品分析：基于标准分类聚合同类应用，快速定位同赛道产品并开展排名、评论与投放研究。