Google Play 应用分类列表

GET /v3/app_data/google/categories

本接口使用 GET 方法，请求路径为：

/v3/app_data/google/categories

用于获取 Google Play 支持的完整应用分类列表。接口无需提交请求参数，也无需请求体。

计费说明

调用本接口不收取费用。

响应中的 cost 通常为 0。如需确认扣费，请以响应头 X-SeerMarTech-Charge-CNY 为准。

请求

请求方法

GET

请求地址

https://api.seermartech.cn/v3/app_data/google/categories

请求头

请求头	类型	填	说明
Authorization	string	是	Bearer 认证，格式为 Bearer smt_live_YOUR_KEY
Content-Type	string	否	建议设置为 application/json

请求参数

本接口无需请求参数。

请求示例

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)

if response.ok:
    result = response.json()
    if result.get("status_code") == 20000:
        print(result)
    else:
        print(
            "接口错误：代码=%s，消息=%s"
            % (result.get("status_code"), result.get("status_message"))
        )
else:
    print("HTTP 错误：", response.status_code, response.text)

TypeScript

const response = await fetch(
  "https://api.seermartech.cn/v3/app_data/google/categories",
  {
    method: "GET",
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
  }
);

const result = await response.json();

if (result.status_code === 20000) {
  // 处理应用分类列表
  console.log(result);
} else {
  console.error(
    `接口错误：代码=${result.status_code}，消息=${result.status_message}`
  );
}

响应结构

接口返回 JSON 对象，主要以下字段：

字段名	类型	说明
version	string	当前 API 版本
status_code	integer	请求级状态码
status_message	string	请求级提示信息
time	string	请求执行耗时，单位为秒
cost	float	平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
tasks_count	integer	tasks 数组中的任务数量
tasks_error	integer	tasks 数组中返回错误的任务数量
tasks	array	任务结果数组

tasks 子字段

字段名	类型	说明
id	string	任务唯一标识，采用 UUID 格式
status_code	integer	任务级状态码，通常位于 10000–60000 范围
status_message	string	任务级提示信息
time	string	任务执行耗时，单位为秒
cost	float	平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
result_count	integer	result 数组中的数量
path	array	当前请求的 URL 路径
data	object	请求 URL 中传的参数信息
result	array	任务结果数组

result 子字段

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

响应示例

{
  "version": "0.1.20220420",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0557 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0123 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v3",
        "app_data",
        "google",
        "categories"
      ],
      "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"
          ]
        }
      ]
    }
  ]
}

> categories 数组中的分类以接口实时返回结果为准。

状态码

状态码	说明
20000	请求成功
状态码	请求或任务处理失败，原因请查看 status_message

实用场景

• 构建应用分类筛选器：在应用数据后台提供标准化分类选项，帮助运营人员按 Google Play 分类筛选和管理应用。
• 校验分类参数：在提交应用查询任务前校验分类值是否合法，减少因分类名称错误导致的请求失败。
• 生成分类维度报表：基于完整分类列表建立统一的数据字，按应用分类统计竞品数量、评分和排名表现。
• 同步分类：定期拉取最新分类列表并更新本地数据库，因平台分类调整造成业务过期。
• 规范跨平台分析维度：将 Google Play 分类作为标准维度，与应用、排名和市场规模数据进行分析。