Skip to main content
POST /v1/data/app-store/keyword-rankings/run Pricing: $0.001 per ranked app ($1.00 per 1,000).

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
required
Searches to run on the App Store, e.g. meditation or budget tracker. One or more.
string
default:"US"
App Store country to rank in, e.g. United States. Defaults to United States.105 allowed values, for example DZ (Algeria), AO (Angola), AR (Argentina), AM (Armenia), AU (Australia), AT (Austria), AZ (Azerbaijan), BH (Bahrain), BB (Barbados), BE (Belgium). Fetch the full list with GET /v1/data/app-store/keyword-rankings?expand=options.
integer
default:"10"
How many ranked apps to return per keyword, from rank 1 down. Defaults to 10; use 0 for all (up to 700).Max 700.

Example

Response fields

Each row in data is one ranked app, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
To start from an app instead of a keyword use app-store/app-keywords; for Google Play use google-play/keyword-rankings.