> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/google-play/charts>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/google-play/charts.mdx>

---

# Google Play Charts API

Top free, paid, grossing, new and trending apps in any category, up to 200 ranks.

`GET /v1/google-play/charts` takes a `chart` (`top-free`, `top-paid`, `top-grossing`, `new-free`, `new-paid` or `trending`), a `category` (for example `GAME`, `SOCIAL` or `GAME_PUZZLE`; default `APPLICATION`, all apps), a `limit` up to 200, and an optional `country` and `language`. `data.entries` lists the ranks in order, each with `rank`, `id` and the app card.

Google Play ranks at most 200 apps in a chart, and small categories rank fewer. `GET /v1/google-play/categories` lists every category id.

## Request

- **Endpoint:** `GET /v1/google-play/charts`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by chart and category
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/google-play/charts/get)
- **Platform page:** [/platforms/google-play](https://www.socialfetch.dev/platforms/google-play)

## FAQ

### Which charts are there?

top-free, top-paid, top-grossing, new-free, new-paid and trending, the apps climbing fastest.

### How many credits does it cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

### How many ranks can I get?

Up to 200 with limit=200. Google Play does not rank more; small categories rank fewer.

### How do I chart games only?

Pass category=GAME for every game, or a game genre such as GAME_PUZZLE.
