Apple App Store 应用分类列表

GET /v3/app_data/apple/app_listings/categories

本接口使用 GET 方法，通过以下路径获取 Apple App Store 中可用于应用数据分析的完整分类列表：

GET https://api.seermartech.cn/v3/app_data/apple/app_listings/categories

接口返回本平台支持的 Apple App Store 应用分类，以及每个分类下的应用条目数量。

计费说明

本接口调用，不产生接口费用。响应中的 cost 字段（平台原始 USD 成本兼容字段）固定为 0。

返回数据

接口返回 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	任务结果数组

任务字段

字段名	类型	说明
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	GET 请求中使用的接口参数
result	array	分类结果数组

result 分类字段

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

状态码和状态信息的完整说明请参考错误码文档。

请求示例

cURL

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

PHP

<?php

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.seermartech.cn/v3/app_data/apple/app_listings/categories',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer smt_live_YOUR_KEY',
        'Content-Type: application/json',
    ],
]);

$response = curl_exec($ch);

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

    if (($result['status_code'] ?? 0) === 20000) {
        // 处理分类列表
        print_r($result);
    } else {
        echo '错误码：' . ($result['status_code'] ?? '未知');
        echo '，错误信息：' . ($result['status_message'] ?? '未知');
    }
}

curl_close($ch);

TypeScript

import axios from 'axios';

axios({
  method: 'get',
  url: 'https://api.seermartech.cn/v3/app_data/apple/app_listings/categories',
  headers: {
    Authorization: 'Bearer smt_live_YOUR_KEY',
    'Content-Type': 'application/json',
  },
})
  .then((response) => {
    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.message);
  });

Python

import requests

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

C#

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;

public static class AppDataDemo
{
    public static async Task GetAppCategories()
    {
        using var httpClient = new HttpClient();

        httpClient.DefaultRequestHeaders.Authorization =
            new AuthenticationHeaderValue("Bearer", "smt_live_YOUR_KEY");

        var response = await httpClient.GetAsync(
            "https://api.seermartech.cn/v3/app_data/apple/app_listings/categories"
        );

        var content = await response.Content.ReadAsStringAsync();
        Console.WriteLine(content);
    }
}

响应示例

{
  "version": "0.1.20221214",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1562 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.1000 sec.",
      "cost": 0,
      "result_count": 2,
      "path": [
        "v3",
        "app_data",
        "apple",
        "app_listings",
        "categories"
      ],
      "data": {
        "api": "app_data",
        "function": "categories",
        "se": "apple"
      },
      "result": [
        {
          "category": "Games",
          "count": 12345
        },
        {
          "category": "Business",
          "count": 6789
        }
      ]
    }
  ]
}

实用场景

• 获取完整分类单，为应用市场分析系统建立标准化的 Apple 应用分类维度。
• 统计各分类应用数量，识别应用供给规模较大的赛道，市场容量评估。
• 校验分类参数，在调用应用数据接口前验证分类名称，减少无效请求。
• 构建分类筛选器，为竞品分析、应用检索和报表系统提供动态分类选项。
• 监控分类规模变化，定期保存分类数量快，分析不同应用赛道的增长趋势。