Google 应用数据分类列表

GET /v3/app_data/google/app_listings/categories

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

GET /v3/app_data/google/app_listings/categories

用于获取 Google Play 应用商店中可用于应用数据查询的完整分类列表，以及每个分类下的应用数量。

接口信息

请求方式：GET
请求地址：https://api.seermartech.cn/v3/app_data/google/app_listings/categories
请求体：无
认证方式：Bearer Token
返回格式：JSON

本接口返回应用数据接口支持的 Google Play 应用分类。分类列表可能随应用商店数据更新而变化。

计费说明

本接口调用，当前不会产生接口费用。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求示例

curl

bash

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

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(
        "请求失败，状态码：%s，消息：%s"
        % (result.get("status_code"), result.get("status_message"))
    )

TypeScript

typescript

import axios from "axios";

async function getAppCategories() {
  try {
    const response = await axios.get(
      "https://api.seermartech.cn/v3/app_data/google/app_listings/categories",
      {
        headers: {
          Authorization: "Bearer smt_live_YOUR_KEY",
          "Content-Type": "application/json",
        },
      }
    );

    const result = response.data;

    if (result.status_code === 20000) {
      console.log(result);
    } else {
      console.error(
        `请求失败，状态码：${result.status_code}，消息：${result.status_message}`
      );
    }
  } catch (error) {
    console.error("请求异常：", error);
  }
}

getAppCategories();

PHP

php

<?php

$url = 'https://api.seermartech.cn/v3/app_data/google/app_listings/categories';

$headers = [
    'Authorization: Bearer smt_live_YOUR_KEY',
    'Content-Type: application/json',
];

$ch = curl_init($url);

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_CUSTOMREQUEST => 'GET',
]);

$response = curl_exec($ch);

if ($response === false) {
    echo '请求失败：' . curl_error($ch);
} else {
    $result = json_decode($response, true);

    if (($result['status_code'] ?? null) === 20000) {
        print_r($result);
    } else {
        echo '请求失败，状态码：'
            . ($result['status_code'] ?? '未知')
            . '，消息：'
            . ($result['status_message'] ?? '未知');
    }
}

curl_close($ch);

响应结构

接口返回 JSON 对象 tasks 数组本次请求的任务结果。

字段名	类型	说明
`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	请求路径信息
`data`	object	请求中使用的接口参数
`result`	array	分类结果数组

`data` 字段

字段名	类型	说明
`api`	string	数据接口名称，固定为 `app_data`
`function`	string	接口功能名称，固定为 `categories`
`se`	string	搜索平台，固定为 `google`

`result` 数组中的字段

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

响应示例

json

{
  "version": "0.1.20221214",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1589 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.1234 sec.",
      "cost": 0,
      "result_count": 2,
      "path": [
        "v3",
        "app_data",
        "google",
        "app_listings",
        "categories"
      ],
      "data": {
        "api": "app_data",
        "function": "categories",
        "se": "google"
      },
      "result": [
        {
          "category": "游戏",
          "count": 125000
        },
        {
          "category": "教育",
          "count": 18000
        }
      ]
    }
  ]
}

状态码

20000：请求成功
状态码：请求失败或任务执行异常

请根据响应中的 status_code 和 status_message 判断请求是否成功。完整错误码可参考本平台错误码文档。

实用场景

获取应用分类：初始化应用数据分析系统的分类字，确保后续查询使用受支持的分类名称。
统计分类应用规模：比较不同 Google Play 分类下的应用数量，为市场容量评估和赛道选择提供依据。
筛选目标竞争赛道：根据分类应用数量识别竞争激烈或供给不足的细分市场， ASO 和产品定位决策。
构建分类下拉选项：将接口返回的分类名称用于后台筛选器、报表系统或运营，减少手工维护成本。
监控分类变化：定期获取分类及应用数量并进行差异对比，发现应用商店分类结构或市场规模变化。

Google 应用数据分类列表 ​

接口信息 ​

计费说明 ​

请求示例 ​

curl ​

Python ​

TypeScript ​

PHP ​

响应结构 ​

tasks 数组中的字段 ​

data 字段 ​

result 数组中的字段 ​

响应示例 ​

状态码 ​

实用场景 ​