Google Play hub

Google Play Charts API

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

GET /v1/google-play/charts

1 credit Failed requests are free

About this endpoint

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.

Price

From $1.35 per 1,000 requests

1 credit per request. Failed requests are free.

Scale pack
$1.64 / 1,000
Growth pack
$2.36 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

Google Play Charts API 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.