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 | |
fields[appCategories] Optional | [string] | |
filter[platforms] Optional | [string] | |
include Optional | [string] | |
limit Optional | integer | |
limit[subcategories] Optional | integer |
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.