# App Store Categories API (https://www.socialcrawl.dev/platforms/app_store/categories)

> Returns the list of Apple App Store app categories used by the `app_category` filter on /v1/app_store/app-list. Static reference data — heavily cached.

TL;DR: `GET /v1/app_store/categories` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/app_store/categories" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get the list of Apple App Store categories via API?

Send a GET request to /v1/app_store/categories. The response is the full reference list of Apple App Store app categories, each with its id and display name, ready to scope app-list chart queries by category.

### What is the App Store categories endpoint for?

It is a reference lookup. The category ids it returns are the values you pass as the app_category parameter on app-list, so you fetch the list once and reuse the ids to scope iOS chart queries by category like Games or Photo & Video.

### What fields does each App Store category include?

Each entry includes the category id (the value app-list accepts as app_category) and a human-readable name such as Photo & Video, Games, or Health & Fitness. Apple groups game sub-genres separately from main app categories.

### How much does the App Store categories endpoint cost?

Categories run on the standard tier at 1 credit per call, since it is a lightweight reference lookup rather than a live store fetch. New accounts get 100 free credits with no credit card required.

### How often do Apple App Store categories change?

Apple's App Store category set is stable and changes rarely, so you can cache the list and refresh it occasionally. Fetching it once gives you the ids needed to scope every category-aware chart request.

See the full App Store API: https://www.socialcrawl.dev/platforms/app_store

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get the list of Apple App Store app categories via API
- What are the App Store category ids used by the SocialCrawl API?