应用数据 API：获取 Google 应用分类列表

GET /v3/app_data/google/app_listings/categories

接口说明

该接口用于获取 Google Play 可用的应用分类完整列表，返回本接口支持的所有应用分类及每个分类下的应用数量。

• 请求方式：GET
• 请求地址：https://api.seermartech.cn/v3/app_data/google/app_listings/categories
• 计费说明：****
• 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准

接口返回 JSON 数据，顶层 tasks 数组；每个任务中会给出分类列表结果。

如需批量导出分类单，可参考文档获取对应 CSV 数据源。

请求信息

HTTP Request

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

响应结构

顶层字段

字段	类型	说明
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	URL 路径
data	object	GET 请求 URL 中传的参数信息
result	array	分类结果数组

tasks[].data 字段

字段	类型	说明
api	string	API 组，固定为 app_data
function	string	调用方法，固定为 categories
se	string	搜索引擎或数据源，当前示例为 google

tasks[].result[] 字段

字段	类型	说明
category	string	支持的应用分类名称
count	integer	该分类下的应用数量

请求示例

cURL

curl --location --request GET "https://api.seermartech.cn/v3/app_data/google/app_listings/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/app_listings/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/app_listings/categories",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 }
})
 .then(function (response) {
 // 返回结果
 console.log(response.data);
 })
 .catch(function (error) {
 console.error(error);
 });

响应示例

{
 "version": "0.1.20221214",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1589 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "2c5d7c4e-6a9d-4d59-9ec2-1234567890ab",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0213 sec.",
 "cost": 0,
 "result_count": 1,
 "path": [
 "v3",
 "app_data",
 "google",
 "app_listings",
 "categories"
 ],
 "data": {
 "api": "app_data",
 "function": "categories",
 "se": "google"
 },
 "result": [
 {
 "category": "GAME_ACTION",
 "count": 125000
 },
 {
 "category": "BUSINESS",
 "count": 98000
 }
 ]
 }
 ]
}

状态码说明

状态码	说明
20000	请求成功
10000-60000	任务级状态码范围，含义请参考 /v3/appendix/errors

使用说明

• 该接口为只读查询接口，无需提交请求体。
• 路径中的 /v3/app_data/google/app_listings/categories 为固定容路径。
• 除 google 外，平台 API 还可能支持数据源，以对应接口文档为准。
• 返回的 count 可用于评估各应用分类的数据覆盖规模。

实用场景

• 梳理应用市场分类体系：快速获取 Google Play部可用分类，为应用报、ASO 和竞品研究建立统一分类维度。
• 筛选重点监控赛道：根据各分类的 count 判断赛道体量，优选择应用数量多或竞争更激烈的类别进行跟踪。
• 构建分类维表：将分类列表同步到数据库，作为后续榜单采集、评论分析、竞品归类的基础映射表。
• 校验分类参数合法性：在调用应用数据接口前，用本接口拉取可用分类，提交无效分类值导致请求失败。
• 评估细分市场机会：结合分类规模与业务目标，识别高覆盖或低竞争的分类方向，选品、投放与产品布局。