# App Store App List API (https://www.socialcrawl.dev/platforms/app_store/app-list)

> Returns a unified AppList for an Apple App Store chart (top free, top paid, top grossing for iPhone or iPad, new apps), optionally scoped to a category. Each item is the same canonical `App` shape as app-search. Use it to track ranking movements or build a category leaderboard. Sourced from DataForSEO's task-based App Data API.

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `app_collection` | yes | Chart to retrieve: top_free_ios, top_paid_ios, top_grossing_ios, top_free_ipad, top_paid_ipad, top_grossing_ipad, new_ios, new_free_ios, new_paid_ios. |
| `app_category` | no | Optional Apple App Store category to scope the chart (e.g. 'photo_and_video', 'games_puzzle'). (books \| business \| catalogs \| education \| entertainment \| finance \| food_and_drink \| games \| games_action \| games_adventure \| games_arcade \| games_board \| games_card \| games_casino \| games_dice \| games_educational \| games_family \| games_music \| games_puzzle \| games_racing \| games_role_playing \| games_simulation \| games_sports \| games_strategy \| games_trivia \| games_word \| health_and_fitness \| lifestyle \| magazines_and_newspapers \| magazines_arts \| magazines_automotive \| magazines_weddings \| magazines_business \| magazines_children \| magazines_computer \| magazines_food \| magazines_crafts \| magazines_electronics \| magazines_entertainment \| magazines_fashion \| magazines_health \| magazines_history \| magazines_home \| magazines_literary \| magazines_men \| magazines_movies_and_music \| magazines_politics \| magazines_outdoors \| magazines_family \| magazines_pets \| magazines_professional \| magazines_regional \| magazines_science \| magazines_sports \| magazines_teens \| magazines_travel \| magazines_women \| medical \| music \| navigation \| news \| photo_and_video \| productivity \| reference \| shopping \| social_networking \| sports \| travel \| utilities \| weather) |
| `country` | no | Storefront country as a DFS location name or numeric code. Defaults to the US. |
| `language` | no | Language code (e.g. 'en'). Defaults to 'en'. |
| `depth` | no | Number of apps to retrieve (default 100, max 500). |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/app_store/app-list?app_collection=top_free_ios" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get Apple App Store top charts with an API?

Send a GET request to /v1/app_store/app-list with an app_collection parameter — top_free_ios, top_paid_ios, top_grossing_ios, or the iPad and new-app variants. The response is a ranked AppList where each app's position is its chart rank.

### Which Apple App Store charts can I pull?

You can pull top free, top paid, and top grossing charts for both iPhone and iPad, plus new-app charts. Add an optional app_category parameter to scope a chart to one App Store category, such as photo_and_video or games_puzzle.

### How is the charts endpoint different from app search?

The charts endpoint returns store rankings — the apps the Apple App Store currently lists as top free, paid, or grossing — in rank order. App search instead returns keyword matches, and app-listings-search queries a filterable paginated database by title.

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

App-list runs on the advanced tier at 5 credits per call, since it fetches a fresh ranked chart from the Apple App Store. New accounts get 100 free credits with no card, and an empty chart is refunded automatically.

### Can I track iOS chart movement over time?

Yes. Because each app comes back with its current rank, calling the charts endpoint on a schedule lets you snapshot iPhone and iPad rankings and detect movers — useful for competitor monitoring and category trend tracking.

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 Apple App Store top charts with an API
- Which iOS store charts can the SocialCrawl App Store API return?