API Reference
My API token šŸ”‘

Category Metrics - History

get
https://public-api.apptweak.com/api/public/store/categories/metrics

Market intelligence data that provides downloads or revenues per category and per country.

Price

DataCreditsPer
Download estimates50request
Revenue estimates50request


Any date range up to 1 year costs the same.

Requires estimates access. Existing API plans retain access; new Lite, Pro and Power plans do not include it.

Query Params
string
enum
required

Category metric for which you want to have data.

Allowed:
string
required

List of category ids for which you want to get the category downloads. Max 5 category ids are allowed. Find the ids in App Store Categories and Google Play Store Categories.

string
required

Comma-separated country codes (us,gb); accepted values: GET /api/public/apptweak/countries with store=ios or store=android. Max 5 country codes are allowed.

date

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

date

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

string
enum
Defaults to free

Chart type: free or paid. Defaults to free.

Allowed:
string
enum
Defaults to iphone

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

Allowed:
Responses

401

Unauthorized. Unknown or missing API token.

403

NotEnoughCreditsError: insufficient credits. EstimatesNotInPlanError: estimates access is missing. Either error rejects the whole request at no charge.

422

Validation error. Returned when a parameter is invalid.

Updated about 1 month ago

Language
Credentials
Header
LoadingLoadingā€¦
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 month ago