API explorer
Getting Started

Sections

Theme switcher

App ASO Top Ranked Keywords

Header Parameters

api-keystring

Query Parameters

app_idstring Required

Unique application identifier. Google app IDs consist of letters, numbers, and dots (e.g., 'com.facebook.katana'), while Apple app IDs are numeric only (e.g., '447188370').

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

metricsarray

Comma-separated list of metrics to retrieve. Available metrics: 'rank', 'volume', 'difficulty'. Defaults to all. Rank is always returned; unrequested metrics are returned as null.

Style
form
Enum values:
difficultyrankvolume
languagestring

Language code for keyword analysis. Defaults to the primary language for the selected store and country.

rank_limitinteger

Maximum rank position to include per day. Default is 50, maximum is 250.

volume_mininteger

Minimum volume filter (10-100). Only keywords with volume >= this value are returned.

difficulty_maxinteger

Maximum difficulty filter (10-100). Only keywords with difficulty <= this value are returned.

storestring Required

Application store identifier

Enum values:
googleapple
formatstring

Format in which the reply should be returned

Enum values:
jsonxml
effective_rank_limitinteger
limitinteger

Page size. Default is 100. Values above 100 are capped at 100, not rejected.

ascboolean | null

Orders the results by ascending or descending

sortstring

Field to sort by. Supported values: 'rank', 'volume', 'difficulty', 'keyword'. Defaults to 'rank'.

offsetinteger

Defines the number of results to skip

Response

200
Object

OK

Response Attributes

metaobject Required

Show child attributes

dataarray | null Required

Show child attributes

200
Object

OK

Response Attributes

metaobject Required

Show child attributes

dataarray | null Required

Show child attributes

200
Object

OK

Response Attributes

metaobject Required

Show child attributes

dataarray | null Required

Show child attributes

200
Object

OK

Response Attributes

metaobject Required

Show child attributes

dataarray | null Required

Show child attributes

200
Object

OK

Response Attributes

metaobject Required

Show child attributes

dataarray | null Required

Show child attributes

Was this section helpful?

GET

/

Select
1

Response

Was this section helpful?
View as Markdown

Ask an AI

Open in ChatGPTOpen in ClaudeOpen in Perplexity

Code with AI

Open in Copilot