<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/app-categories",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "App Categories"
}
-->

# App Categories

Get App Store categories and subcategories for apps.

## Discussion

`appCategories` provides read-only information that includes the list of choices for an app’s App Store category, subcategory, and secondary category.

To update your app’s categories, use the [App Infos](/documentation/AppStoreConnectAPI/app-infos) resource. For more information about categories, see [Choosing a Category](https://developer.apple.com/app-store/categories/).

## Topics

### Listing Categories and Subcategories

[`List app categories`](/documentation/AppStoreConnectAPI/GET-v1-appCategories)

List all categories on the App Store, including the category and subcategory hierarchy.

[`List all subcategories for an app category`](/documentation/AppStoreConnectAPI/GET-v1-appCategories-_id_-subcategories)

List all App Store subcategories that belong to a specific category.

[`List subcategory IDs for an app category`](/documentation/AppStoreConnectAPI/GET-v1-appCategories-_id_-relationships-subcategories)

### Reading App Category Information

[`Read app category information`](/documentation/AppStoreConnectAPI/GET-v1-appCategories-_id_)

Get a specific app category.

[`Read the parent information of an app category`](/documentation/AppStoreConnectAPI/GET-v1-appCategories-_id_-parent)

Get the App Store category to which a specific subcategory belongs.

[`Get the parent category ID for an app category`](/documentation/AppStoreConnectAPI/GET-v1-appCategories-_id_-relationships-parent)

### Objects

[`AppCategoriesResponse`](/documentation/AppStoreConnectAPI/AppCategoriesResponse)

The response body for endpoints that list App Store categories.

[`AppCategory`](/documentation/AppStoreConnectAPI/AppCategory)

The data structure that represent an App Categories resource.

[`AppCategoryResponse`](/documentation/AppStoreConnectAPI/AppCategoryResponse)

The response body for endpoints that read a single App Store category.

[`AppCategoriesWithoutIncludesResponse`](/documentation/AppStoreConnectAPI/AppCategoriesWithoutIncludesResponse)

A response containing a list of App Store categories, without including subcategory resources.

[`AppCategoryWithoutIncludesResponse`](/documentation/AppStoreConnectAPI/AppCategoryWithoutIncludesResponse)

A response containing a single App Store category, without including subcategory resources.

[`AppInfoPrimaryCategoryLinkageResponse`](/documentation/AppStoreConnectAPI/AppInfoPrimaryCategoryLinkageResponse)

[`AppInfoPrimarySubcategoryOneLinkageResponse`](/documentation/AppStoreConnectAPI/AppInfoPrimarySubcategoryOneLinkageResponse)

[`AppInfoPrimarySubcategoryTwoLinkageResponse`](/documentation/AppStoreConnectAPI/AppInfoPrimarySubcategoryTwoLinkageResponse)

[`AppInfoSecondaryCategoryLinkageResponse`](/documentation/AppStoreConnectAPI/AppInfoSecondaryCategoryLinkageResponse)

[`AppInfoSecondarySubcategoryOneLinkageResponse`](/documentation/AppStoreConnectAPI/AppInfoSecondarySubcategoryOneLinkageResponse)

[`AppInfoSecondarySubcategoryTwoLinkageResponse`](/documentation/AppStoreConnectAPI/AppInfoSecondarySubcategoryTwoLinkageResponse)


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)