resultCountDelta— change in the number of apps Apple returns for the keyword. Rising = more competition entering the niche.reviewVelocity— average daily growth in the top app’s review count over the window. A leader pulling away fast means a maturing market with a clear winner.trend— coarse bucket so you can sort dashboards by momentum without comparing raw deltas across keywords of different sizes.
Query Parameters
Response
trend values: surging · rising · steady · cooling · declining. Buckets are deliberately coarse so noise on small keywords doesn’t flip the verdict day to day.
hasFullWindow is false when one of the snapshots is missing — usually for very new keywords with less than days of history.
interpretation is a short, plain-English summary of the bucket and the underlying deltas — safe to surface directly in a UI and useful for LLM agents that don’t want to combine raw numbers.
The response-level meta envelope describes data freshness — see Keyword Metrics → meta envelope for the full schema.
Credit Cost
2 credits per request.Use Cases
- Filter keyword tracking dashboards by
trend = surgingto surface emerging niches. - Pair with
/keywords/metricsfor “high opportunity + rising demand” lists. - Trigger alerts when a keyword you rank for moves to
cooling.