VOOZH about

URL: https://docs.similarweb.com/api-v5/api-reference/app-analysis-api/app-top-charts

⇱ Similarweb API V5 Documentation

Getting Started

Sections

Theme switcher

App Top Charts

Returns a ranked list of top apps from the iOS App Store or Google Play.

This endpoint uses 1 data credits per result in the “data” array response. Example: 10 apps ranked on a top chart = 10 credits. Read the following guide to estimate the credit costs.

Header Parameters

api-keystring

Query Parameters

granularitystring

Time granularity for the returned values

Enum values:
daily
countrystring Required

Two-letter country code (e.g., 'us', 'gb', 'ww')

start_datestring

Start date in 'YYYY-MM' or 'YYYY-MM-DD' format or relative keywords: latest, X_months_ago, X_days_ago

end_datestring

End date in 'YYYY-MM' or 'YYYY-MM-DD' format or relative keywords: latest, X_months_ago, X_days_ago

storestring Required

Application store identifier

Enum values:
googleapple
category_idstring Required

category_id: The category ID for the top chart.

typestring

type: Type of the ranking list (top_free, top_paid, top_grossing)

Enum values:
top_freetop_paidtop_grossing
devicestring

device: Options for apple store: iphone, ipad. For apple it defaults to: iphone, for google it defaults to: android.

Enum values:
androidipadiphone
datestring

Date (format: YYYY-MM-DD). Default to the latest available top chart.

formatstring

Format in which the reply should be returned

Enum values:
jsonxml
limitinteger

Sets how many results to return.

offsetinteger

Defines the number of results to skip

ascboolean

Orders the results by ascending or descending

Nullable:
True
sortstring

Selects a specific metric to order results by

Response

200
Object

Success

Response Attributes

metaobject
dataarray
Nullable:
True
Was this section helpful?

GET

/

Select
1

Response

Was this section helpful?