App Keyword Ranking - History

Price

MetricsCommentCredits/app/keyword for 1 dayCredits/app/keyword per extra day
rankRanking of an app for a keyword.101
installsThe estimated number of daily installs driven by a keyword to an app.101
📘Ranked, unranked or no data

To know whether your app is ranked on a keyword or not, you can refer to the following logic in the response data:

• value = non-null and fetch_performed = true ➔ ranked
• value = null and fetch_performed = true ➔ unranked
• value = null and fetch_performed = false ➔ no data

In addition to value, you can use effective_value, that corresponds to a value that is guaranteed to be non-null. The logic to compute effective_value is:

• If value is not null, effective_value = value
• Otherwise, if fetch_performed = true, then effective_value = 501, the numeric representation of unranked
• Otherwise, if there is at least one non-null value in the date range, take the closest day to the missing day and use that value (an average if two days are equally close)
• Otherwise, defaults to 501

👍

Improved Keyword Installs starting July 17, 2025

Starting July 17, 2025, we're updating our keyword installs estimates. This change will make keyword performance trends even more precise, especially when looking at historical data.

⚠️

effective_value can differ between requests for the same day

effective_value is estimated using the other days within the date range you queried — it never looks outside your start_date/end_date. This means that querying the same day with a wider or narrower range can return a different effective_value for that same day, if it changes which neighboring days are available to estimate from.

If you need a number for a given day that's stable regardless of the range you query, use value instead, and treat null as "no estimate available" rather than defaulting it to 0 yourself.

More info on these rule can be found here.

Query Params
string
required

Comma-separated list of app IDs (max 5). How to find App IDs?

string
required

Comma separated list of keywords. Max 5 keywords are allowed.

string
required

Comma separated list of metrics (rank, installs).

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.

string

AppTweak language code, not always ISO: US English is us, US Spanish sp. Accepted pairs: GET /api/public/apptweak/languages with store=ios or store=android. Defaults to the country's default language.

string
enum
Defaults to iphone

Choose a device from iphone, ipad or android. Defaults to iphone.

Allowed:
date

Start date (YYYY-MM-DD). Defaults to 30 days ago.

date

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

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.

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