Skip to main content
Returns historical rank data for a specific keyword and app over a configurable time window. Use this to track how your keyword rankings change over time and measure the impact of ASO optimizations.

Path Parameters

Query Parameters


Code Examples


Response


Response Fields

History Object


Understanding Rank Changes

Rank change values are calculated as the improvement in position, not the raw difference in rank number:
  • Positive value = rank improved (e.g. moved from #12 to #5 → rankChange7d: 7)
  • Negative value = rank declined (e.g. moved from #5 to #8 → rankChange7d: -3)
  • Zero = rank stayed the same
Historical data points are only available for dates the keyword has been tracked. Add a keyword to your tracked set with POST /v1/keywords/track to start collecting history; trends become richer the longer a keyword has been tracked.
Short-term vs long-term analysis: Use days=7 for quick feedback on recent ASO changes (metadata updates, new screenshots, keyword tweaks). Use days=30 or days=90 for measuring long-term keyword strategy effectiveness and seasonal trends.

Errors