Skip to content

Google API: List Google Play top charts

Lists ranked Android apps or games from the Google Play top free, top paid or top grossing chart for a country and category.

play.google.com (opens in a new tab)Version 1ReadNo sign-inVerified Nov 2, 2026

Unofficial. Not affiliated with or endorsed by Google.

Inputs

Values from the run on Oct 23, 2026, shown under Output.

Chart optionalchart

Which top chart to list, for example top_free.

top_free

One of top_free, top_paid, top_grossing. Default top_free.

Country optionalcountry

Country name or two-letter code, for example United States or GB.

United States

Default United States.

Category optionalcategory

App or game category in words, for example games, social, finance, or health and fitness.

games

Default all apps.

Max Results optionalmax_results

Maximum number of ranked apps to return, for example 50.

50

Whole number from 1 to 200. Default 50.

Output

From a run on Oct 23, 2026, shortened for this page.
{  "apps": [    {      "rank": 1,      "price": 0,      "app_name": "Gossip Harbor: Merge & Story",      "currency": "USD",      "developer": "Microfun Limited",      "star_rating": 4.36,      "package_name": "com.mergegames.gossipharbor",      "play_store_link": "https://play.google.com/store/apps/details?id=com.mergegames.gossipharbor&gl=US"    },    {      "rank": 2,      "price": 0,      "app_name": "Royal Smash! - Physics Puzzle",      "currency": "USD",      "developer": "Cypher Games",      "star_rating": 4.62,      "package_name": "com.cyphergames.royalsmash",      "play_store_link": "https://play.google.com/store/apps/details?id=com.cyphergames.royalsmash&gl=US"    },    {      "rank": 3,      "price": 0,      "app_name": "Meowdoku: Brain Puzzle Games",      "currency": "USD",      "developer": "Oakever Games",      "star_rating": 4.69,      "package_name": "com.oakever.meowdoku",      "play_store_link": "https://play.google.com/store/apps/details?id=com.oakever.meowdoku&gl=US"    }  ],  "chart": "top_free",  "country": "United States",  "category": "games"}
Price
1 credit per completed run (1¢ with pay as you go); failed runs are free.
Method
play.google.com/list_top_charts
Returns
rank, app name, developer, star rating, price, currency, Play Store link, package name

Use it from your agent

Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method play.google.com/list_top_charts with the inputs above.

Ask your agent

  • Show me the top 25 free games on the Google Play chart in the United States
  • What are the highest grossing finance apps on Google Play in GB right now?
  • List the top paid social apps on Google Play for Germany, with prices and developers
  • Which health and fitness apps rank highest on the free Play Store chart in Canada? Give me the top 10.
  • On Google Play, what are the top 100 grossing apps in Japan, with package names and star ratings?
  • Finds Android apps on Google Play by keywords, in Play search order, with each listing's developer, star rating, price and currency for the chosen country, download range and link. Results are limited to apps shown on the public search page.

    play.google.com/search_apps
  • Lists Google Trends 'Trending now' searches for a country, time window and category, in Google's order. Each search comes with its volume, activity, related searches and news headlines.

    trends.google.com/list_trending_searches
  • Gets a public Google Play app listing by app name or Play Store link, with developer, rating, downloads, price, what's new, descriptions and data safety highlights.

    play.google.com/get_app
  • Lists the current top Google News stories, overall or for one topic, in a chosen country and language edition.

    news.google.com/list_top_stories
  • Gets public user reviews for an Android app on Google Play. The app can be given by name, Play Store link, or app ID.

    play.google.com/get_app_reviews
  • Lists major stock market indexes on Google Finance with their current levels, changes and quote times. Quotes may be delayed, and indexes Google does not show are left out.

    google.com/list_market_indexes
  • Shows where a search term has the highest relative Google Trends interest, by country worldwide or by region within a country. Scores run from 0 to 100.

    trends.google.com/get_interest_by_region
  • Finds Chrome Web Store extensions by keywords in store order, with each listing's developer, users, rating, rating count, short description and store link. Some listings omit developer, users or ratings.

    chromewebstore.google.com/search_extensions