/apps/keywords-rankings/history.json

👍

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.

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 useeffective_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, corresponding to 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 for the effective_value (use an average if 2 days are at the same distance to the missing day)
      • Otherwise, defaults to 501
Query Params
string
required
Defaults to us.zoom.videomeetings,com.microsoft.teams

Comma separated list of app IDs. Max 5 apps are allowed.
How to get an App ID

string
required
Defaults to meeting

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

string
required
Defaults to rank, installs

Comma separated list of metrics. Available metrics are listed in the table above.

string
Defaults to us

Two letter country code.
List of countries

string

Two letter language code.
Default: default language of the country

string
Defaults to 2025-08-01

Start date of the period in format YYYY-MM-DD.
Default: 30 days ago

string
Defaults to 2025-08-20

End date of the period in format YYYY-MM-DD.
Default: yesterday

string
enum
Defaults to android

Choose a device from iphone, ipad or android.
Default: iphone

Allowed:
Response

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