Google Play top charts

GET https://api.api.sh/google-play/v1/charts
1 credit / call search & seo try it in the playground →

Google Play's top charts for a category and country: top free, top paid or top grossing apps and games, ranked, with title, developer, icon, rating, price, genre, installs and screenshots.

Every response includes credits_used: the credits this call cost.

Parameters

nametypedescription
collection topselling_free | topselling_paid | topgrossing topselling_free (default), topselling_paid or topgrossing. Example: topgrossing
category string APPLICATION (all apps, default), GAME (all games), or a category such as GAME_PUZZLE, GAME_ACTION, SOCIAL, FINANCE, PRODUCTIVITY, HEALTH_AND_FITNESS, SHOPPING, TOOLS, EDUCATION, ENTERTAINMENT, FAMILY. Example: GAME
country string Two-letter country code (default us). Example: us
lang string Language code (default en). Example: en
limit integer Apps to return, 1-200 (default 50). Example: 50

Every endpoint also takes fresh, raw, fields (see lean responses and caching).

Example

curl "https://api.api.sh/google-play/v1/charts?collection=topgrossing" \
  -H "x-api-key: $APISH_KEY"

Response

A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).

The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.