today − days, then buckets every keyword into:
- Top gainers — rank improved (lower rank number)
- Top losers — rank dropped
- New entries — newly ranking keywords
- Dropped out — keywords the app no longer ranks for
topGainers and topLosers are sorted by |rankChange| × volumeScore so high-traffic moves bubble to the top.
Query Parameters
Response
Rank Change Interpretation
Credit Cost
3 credits per request.Use Cases
- “Monday morning ASO” digest.
- Smart Alerts trigger source (“a tracked keyword fell out of top 10”).
- Correlating metadata changes with ranking impact (pair with the upcoming ASO Timeline endpoint).

