Skip to main content
GET /v1/keywords/demand-trend
Compares the current state of a keyword’s SERP against the closest snapshot on or before today − N days:
  • 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

NameTypeRequiredDefaultDescription
keywordstringYes—The keyword to analyse
countrystringNousISO 3166-1 alpha-2 storefront
devicestringNoiphoneiphone or ipad
daysnumberNo14Comparison window in days, 3–90

​
Response

{
  "ok": true,
  "data": {
    "keyword": "ai chat",
    "country": "us",
    "device": "iphone",
    "windowDays": 14,
    "current":  { "date": "2026-04-21", "resultCount": 248, "topAppReviews": 1840221 },
    "previous": { "date": "2026-04-07", "resultCount": 211, "topAppReviews": 1610115 },
    "resultCountDelta": 37,
    "resultCountChangePct": 17.5,
    "reviewVelocity": 16436,
    "reviewVelocityPct": 14.3,
    "trend": "rising",
    "hasFullWindow": true
  }
}
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.

​
Credit Cost

2 credits per request.

​
Use Cases

  • Filter keyword tracking dashboards by trend = surging to surface emerging niches.
  • Pair with /keywords/metrics for “high opportunity + rising demand” lists.
  • Trigger alerts when a keyword you rank for moves to cooling.