toolzerhub API Docs

List top chart apps (v1)

Returns up to 200 apps from a Play Store top chart (top-free, top-paid or top-grossing) for category and country, in rank order, with price, rating and installs. A category with no chart in that country returns an empty results array.

1 credit / requestBilled only on success
GET
/v1/google-play/charts

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

chart?string

Which Play Store top chart.

Default"top-free"

Value in

  • "top-free"
  • "top-paid"
  • "top-grossing"
category?string

Play category: APPLICATION for all apps, GAME for all games, or one such as PRODUCTIVITY or GAME_PUZZLE.

Default"APPLICATION"
count?integer

Number of ranks to return, up to 200.

Range1 <= value <= 200
Default100
language?string

Locale used for Play Store text, such as en_US.

Match^[A-Za-z]{2,3}(?:[-_][A-Za-z]{2})?$
Default"en_US"
country?string

Two-letter country code used for Play Store availability.

Match^[A-Za-z]{2}$
Default"US"
curl -X GET "https://example.com/v1/google-play/charts" \  -H "x-api-key: YOUR_API_KEY"
{  "data": {    "chart": "top-free",    "category": "string",    "count": 0,    "results": [      {        "package_id": "string",        "title": "string",        "icon_url": "string",        "rating": 0,        "category": "string",        "description": "string",        "developer": "string",        "installs": "string",        "rank": 0,        "price": 0,        "currency": "string",        "url": "string"      }    ]  },  "details": {    "reason": "string",    "message": "string"  }}