Top Charts - History

get

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

Returns historical top charts for the App Store or Google Play Store. The top 500 applications are provided for free and paid, or grossing apps.

You can find the most recent top apps in the Current section.

Price

Data	Credits	Per
Top charts	5	request

Any date range up to 1 year costs the same.

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.

start_date

date

Start date (YYYY-MM-DD). Send both dates or omit both. Maximum range: one full calendar year. Defaults to 30 days ago.

end_date

date

End date (YYYY-MM-DD). Defaults to yesterday.

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.

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.