# 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.

Unofficial. Not affiliated with or endorsed by Google.

- Page: https://fous.com/methods/play.google.com/list-top-charts
- Method: `play.google.com/list_top_charts`, version 1
- Website: play.google.com
- Returns: rank, app name, developer, star rating, price, currency, Play Store link, package name
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `chart` | string | no | `"top_free"` | Which top chart to list, for example top_free. One of "top_free", "top_paid", "top_grossing". Default "top_free". |
| `country` | string | no | `"United States"` | Country name or two-letter code, for example United States or GB. Default "United States". |
| `category` | string | no | `"games"` | App or game category in words, for example games, social, finance, or health and fitness. Default "all apps". |
| `max_results` | integer | no | `50` | Maximum number of ranked apps to return, for example 50. Default 50. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "chart": "top_free",
  "country": "United States",
  "category": "games",
  "max_results": 50
}
```

Its output:

```json
{
  "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"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"play.google.com/list_top_charts","input":{"chart":"top_free","country":"United States","category":"games","max_results":50}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## 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?

## Input schema

```json
{
  "type": "object",
  "properties": {
    "chart": {
      "enum": [
        "top_free",
        "top_paid",
        "top_grossing"
      ],
      "type": "string",
      "default": "top_free",
      "description": "Which top chart to list, for example top_free."
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter code, for example United States or GB."
    },
    "category": {
      "type": "string",
      "default": "all apps",
      "description": "App or game category in words, for example games, social, finance, or health and fitness."
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum number of ranked apps to return, for example 50."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "chart",
    "category",
    "country",
    "apps"
  ],
  "properties": {
    "apps": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "rank": {
            "type": "integer"
          },
          "price": {
            "type": "number"
          },
          "app_name": {
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "developer": {
            "type": [
              "string",
              "null"
            ]
          },
          "star_rating": {
            "type": [
              "number",
              "null"
            ]
          },
          "package_name": {
            "type": "string"
          },
          "play_store_link": {
            "type": "string"
          }
        }
      }
    },
    "chart": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "category": {
      "type": "string"
    }
  }
}
```

## See more

- [Google API: Search Google Play apps](https://fous.com/methods/play.google.com/search-apps.md): 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.
- [Google API: List trending searches](https://fous.com/methods/trends.google.com/list-trending-searches.md): 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.
- [Google API: Get Android app listing](https://fous.com/methods/play.google.com/get-app.md): 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.
- [Google API: List top stories](https://fous.com/methods/news.google.com/list-top-stories.md): Lists the current top Google News stories, overall or for one topic, in a chosen country and language edition.
- [Google API: Get app reviews](https://fous.com/methods/play.google.com/get-app-reviews.md): Gets public user reviews for an Android app on Google Play. The app can be given by name, Play Store link, or app ID.
- [Google API: List market indexes](https://fous.com/methods/google.com/list-market-indexes.md): 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 API: Get interest by region](https://fous.com/methods/trends.google.com/get-interest-by-region.md): 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.
- [Google API: Search Chrome extensions](https://fous.com/methods/chromewebstore.google.com/search-extensions.md): 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.
- [All Google methods](https://fous.com/methods/google.com.md)