# Google Play App List API (https://www.socialcrawl.dev/platforms/google_play/app-list)

> Returns a unified AppList for a Google Play store chart (top free, top paid, top grossing, movers & shakers, etc.), optionally scoped to a category. Each item is the same canonical `App` shape as app-search, and `app.rank` is its position in the chart (1 is the top), in the order the items arrive. Use it to track ranking movements or build a category leaderboard. A chart row carries the title, icon, developer name, store URL, price and free flag, and the star rating (`app.rating.value`) where the storefront publishes it. `app.reviews_count` and `app.rating.count` are not sent on chart rows in any storefront and are always null here; read them from /v1/google_play/app-info. Some storefronts send no star rating on chart rows at all: on 19/10/2026 the South African (`country=ZA`) top free chart had no rating on 100 of 100 apps, while Nigeria had a rating on all 100 and Kenya on 98. When no app on the page has a rating, `_warnings` carries `ratings_unavailable`, so an empty rating column is never mistaken for zero; /v1/google_play/app-info returns the rating for one app in that storefront. `app.ext.appdata` is the store's raw row, kept for reference; read the unified leaves above it first.

TL;DR: `GET /v1/google_play/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: topselling_free, topselling_paid, topgrossing, movers_shakers, topselling_new_free, topselling_new_paid. An unknown value is rejected with a free 400 that lists the accepted set. |
| `app_category` | no | Optional Google Play category to scope the chart (e.g. 'photography', 'game_puzzle'). (art_and_design \| auto_and_vehicles \| beauty \| books_and_reference \| business \| comics \| communication \| dating \| education \| entertainment \| events \| finance \| food_and_drink \| health_and_fitness \| house_and_home \| libraries_and_demo \| lifestyle \| maps_and_navigation \| medical \| music_and_audio \| news_and_magazines \| parenting \| personalization \| photography \| productivity \| shopping \| social \| sports \| tools \| travel_and_local \| video_players \| android_wear \| watch_face \| weather \| game \| game_action \| game_adventure \| game_arcade \| game_board \| game_card \| game_casino \| game_casual \| game_educational \| game_music \| game_puzzle \| game_racing \| game_role_playing \| game_simulation \| game_sports \| game_strategy \| game_trivia \| game_word \| family) |
| `country` | no | Storefront country as an ISO code ('US'), a full name, or a 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, rounded up to multiples of 100, max 500). The store decides how deep a chart actually goes: measured 06/09/2026, `topselling_free` returns 100 at the default and 200 at depth=500, and `topselling_new_paid` has only 5 apps in it. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/google_play/app-list" \
  --data-urlencode "app_collection=topselling_free" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get Google Play top charts with an API?

Send a GET request to /v1/google_play/app-list with an app_collection parameter: topselling_free, topselling_paid, topgrossing, or movers_shakers. The response is a ranked AppList where each app's position is its chart rank.

### Which Google Play charts can I pull?

You can pull top free, top paid, top grossing, and movers-and-shakers charts. Add an optional category parameter to scope a chart to one Google Play category, such as games or productivity.

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

The charts endpoint returns store rankings: the apps Google Play currently lists as top free, paid, or grossing, in rank order. App search instead returns keyword matches, and app-listings-search queries a filterable stored database.

### How much does the Google Play charts endpoint cost?

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

### Can I track chart movement over time?

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

See the full Google Play API: https://www.socialcrawl.dev/platforms/google_play

## 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 Google Play top charts with an API
- Which Google Play store charts can the SocialCrawl API return?