List app categories
List all categories on the App Store, including the category and subcategory hierarchy.
URL
GET https://api.appstoreconnect.apple.com/v1/appCategoriesQuery Parameters
| Name | Type | Description |
|---|---|---|
exists[parent] Optional | boolean | Filter the returned app categories to include only those that have a parent category (true) or are top-level categories (false). |
fields[appCategories] Optional | [string] | Additional fields to include for each App Categories resource returned by the response. |
filter[platforms] Optional | [string] | Filter the returned app categories by platform. |
include Optional | [string] | The relationship data to include in the response. |
limit Optional | integer | The maximum number of app category resources to return. |
limit[subcategories] Optional | integer | The maximum number of related subcategory resources to return. |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | AppCategoriesResponse | |
| 400 | Bad Request Content-Type: application/json | ErrorResponse | An error occurred with your request. |
| 401 | Unauthorized Content-Type: application/json | ErrorResponse | |
| 403 | Forbidden Content-Type: application/json | ErrorResponse | Request not authorized. |
| 429 | Content-Type: application/json | ErrorResponse |
Discussion
Use this endpoint to retrieve the list of available App Store categories and subcategories. Associate an app with categories using the Modify an app info endpoint.
The first example retrieves the full category and subcategory hierarchy in one request. The second example retrieves just the top-level categories for macOS apps.