Top Charts - Current

get

https://public-api.apptweak.com/api/public/store/charts/top-results/current.json

Returns the most recent top chart for the App Store or Google Play Store. The top 500 applications are available for free, paid, or grossing apps.

You can find historical top apps in the History section.

Price

Datapoint	Description	Credits
-	List of app IDs of the top chart. The list is ordered in ascending order, meaning that the first element in the list is the top app.	10

Query Params

categories

string

required

The category id for which you want to get the top charts. Find the ids in App Store Categories and Google Play Store Categories.

types

string

required

Comma-separated chart types among free, paid and grossing (free,paid asks for both). Each type is one datapoint per category.

country

string

Defaults to us

Two-letter country code (us, gb, fr). Accepted values: GET /api/public/apptweak/countries with store=ios or store=android. Defaults to us.

device

string

enum

Defaults to iphone

The device you want to fetch the top chart for: iphone, ipad or android. Defaults to iphone.

Allowed:

limit

int32

Defaults to 100

The number of apps you want to fetch (max 500). Defaults to 100.

offset

int32

Defaults to 0

The index by which you would like to offset the top chart. Defaults to 0.

Responses

401

Unauthorized. Unknown or missing API token.

403

Forbidden. Not enough credits to perform the request.

422

Validation error. Returned when a parameter is invalid.

200Successful response.