Skip to main content
GET
Top Charts
Top charts for a category and country.
This endpoint currently returns 422 for every request, and 422 is not billed.Google Play no longer server-renders the top-chart ranking. The category page carries the chart tabs — their ids and labels are in the payload — but the item list is empty and filled in client-side. That was confirmed across GAME/US, COMMUNICATION/US and GAME/DE, so it is Play’s rendering model and not a per-page fluke. The legacy /store/apps/collection/{id} URLs still answer 200 but serve an empty shell.Use /categories/{category_id} for that category’s apps in Play’s own order.
The route ships reading the chart cluster the correct way, so it starts returning data unchanged if Google restores server-side rendering. Returning the page’s editorial rails instead would charge you for a ranking you did not ask for and could not distinguish from the real one. Credits: 5 when it returns data. 422 is not billed.

Authorization

string
required
Your ScrapeBadger API key.

Path Parameters

string
required
topselling_free, topselling_paid or topgrossing. Anything else is a 400.

Query Parameters

string
default:"APPLICATION"
Category to rank within, e.g. GAME or SOCIAL. Defaults to all apps. See /categories.
string
default:"US"
Play storefront (gl).
string
default:"en"
Play content language (hl).

Response

string
The collection requested.
string
The Play URL the chart was read from.
integer
Apps returned.
AppCard[]
Ranked apps — same shape as search results, in chart order.

Example

Response (current behaviour)

Errors