# 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. Use it to track ranking movements or build a category leaderboard. Sourced from DataForSEO's task-based App Data API.

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. |
| `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 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/google_play/app-list?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?