get https://public-api.apptweak.com/api/public/store/apps/keywords-rankings/history.json
Get the historical keyword metrics for selected apps (rank and installs).
Improved Keyword Installs starting July 17, 2025Starting 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.
Price
Metrics | Comment | Credits/app/keyword for 1 day | Credits/app/keyword per extra day |
---|---|---|---|
rank | Ranking of an app for a keyword. | 10 | 1 |
installs | The estimated number of daily installs driven by a keyword to an app. | 10 | 1 |
Ranked, unranked or no dataTo 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 andfetch_performed = true
➔ rankedvalue
= null andfetch_performed = true
➔ unrankedvalue
=null
andfetch_performed = false
➔ no dataIn addition to
value
, you can useeffective_value
, that corresponds to a value that is guaranteed to be non-null. The logic to computeeffective_value
is:
- If
value
is notnull
,effective_value = value
- Otherwise
- If
fetch_performed = true
, theneffective_value = 501
, corresponding to the numeric representation ofunranked
- 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
for theeffective_value
(use an average if 2 days are at the same distance to the missing day)- Otherwise, defaults to
501