Top free, top paid and top grossing Google Play charts for apps and games by category and country. Up to 200 apps per call with rank, rating, price, installs, content rating and media. 1 credit per request.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
5 optional filters available.
string
Optional
Chart type: top_free (default), top_paid or top_grossing. The paid chart can hold fewer apps than num outside the US and India. The real count is returned in result_count.
top_free
string
Optional
Store category id. Default APPLICATION (all apps). GAME and the GAME_ ids list games. Allowed: APPLICATION, 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, WATCH_FACE, WEATHER, FAMILY, 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.
GAME
integer
Optional
Number of apps to return, 1 to 200. Default: 50. Values outside the range return 422.
10
string
Optional
Interface language code, for example en or de. Default: en.
en
string
Optional
Storefront country: US, GB, DE, FR, JP, BR or IN. Default: US. Other countries return 422.
us
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
result_count
organic_results
search_parameters
Common organic_results fields
free
link
rank
price
{
"result_count": 2,
"organic_results": [
{
"free": true,
"link": "https://play.google.com/store/apps/details?id=com.facebook.aura",
"rank": 1,
"price": {
"amount": 0,
"currency": "USD"
},
"title": "Muse from Meta",
"rating": 4.720813,
"summary": "Muse is your personal AI agent that gets things done, always working on what matters to you. It manages email, books dinners, tracks budg...",
"category": "Productivity",
"installs": "5,000,000+",
"developer": "Meta Platforms, Inc.",
"thumbnail": "https://play-lh.googleusercontent.com/qDQUfohqN-eZh_a_YuWYlTsBPwjgrayoh2-Nf9o49kzN5Yjwk4yTyNUIFRI3o3PYks5lVAgEPrEPvFRYqxLP",
"product_id": "com.facebook.aura",
"rating_text": "4.7",
"screenshots": [
"https://play-lh.googleusercontent.com/R7pQ9kQjhDBbsreE7p2M4D91O7AuoRgmy91lKrPQ24Ey6dTQUjB32a7pPndF6PR2MYQBxGOi2IOuU-1iatSRCg",
"https://play-lh.googleusercontent.com/9BJlFbPodn5h9R76V0DfLqGmN42U8-PNN5--xisQXBpwApN_RPXTTXD7IRl0e0bC0NQFslddPE97YWNhMtCIIcg"
],
"header_image": "https://play-lh.googleusercontent.com/JTZgE3Z_yJ0glT98EhPkDk3bVLn0w2ELu-9P53DLNxZ6AaaRyZ2L-aEZwB_sw-ngPJdFTw_dlm1quvwerAYPOg",
"content_rating": "Teen",
"in_app_purchases": "$0.99 - $1,049.00 per item"
},
{
"free": true,
"link": "https://play.google.com/store/apps/details?id=com.openai.chatgpt",
"rank": 2,
"price": {
"amount": 0,
"currency": "USD"
},
"title": "ChatGPT",
"rating": 4.780293,
"summary": "Introducing ChatGPT for Android: OpenAI\u2019s latest advancements at your fingertips.This official app is free, syncs your history across dev...",
"category": "Productivity",
"installs": "1,000,000,000+",
"developer": "OpenAI",
"thumbnail": "https://play-lh.googleusercontent.com/T9J8e9oxxPd600j_KPM4KK2GHfNpUpGBdTy8lHPXBXpOUfGusRuZXj0UMgFNrP8we6LVt9V-AibEgcLootE6VK4",
"product_id": "com.openai.chatgpt",
"rating_text": "4.8",
"screenshots": [
"https://play-lh.googleusercontent.com/29Ke3337zH310guLREGkQUo9x1h4pr3c8sZqRqqW8xmPlHI_TQK9EJWB_zzIICFk8LAMME6ewkPqtunHKTd9IQ",
"https://play-lh.googleusercontent.com/DBLDNl2Ma8Ag2qqh1gfyWGipGGBG5Yl3c38RCJBjfPOS2gkFsZXFgelpfk1WOLZ8h0a6GJOLYhDXAVRQ4uFFpg"
],
"header_image": "https://play-lh.googleusercontent.com/Os8SgmLAQPG8uQGICuoTowt4tAJTjBhYmcB_1_HvxcKmGAgB51XMdX7vtCNR8LKJmEG9bWX91d3b9ZvMzLia",
"content_rating": "Teen",
"in_app_purchases": "$8.00 - $500.00 per item"
}
],
"search_parameters": {
"gl": "US",
"hl": "en",
"num": 3,
"chart": "top_free",
"engine": "google_play_charts",
"category": "APPLICATION"
}
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter failed validation, for example an unknown category, a num outside 1 to 200 or an unsupported country.
Google Play Upstream Unavailable
Google Play could not be fetched. The request is not billed.
{
"error": "Google Play data is temporarily unavailable.",
"retryable": true,
"error_code": "google_play_upstream_unavailable"
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.