openaso

tools / keyword_movers

keyword_movers

read-only

Who is moving on a keyword

Competitor movement on one search phrase from openaso's archived top-200 snapshots: every app's position now against the snapshot `days` back, its ratings gained over the period, which apps entered the results and which left. This is the "who is climbing on my keyword" view — the live rank/competitors tools show only the present. archived=false means openaso has never snapshotted the phrase (look it up with competitors or track it to start). Popular phrases snapshot every six hours, tracked ones daily (first in the queue), the rest as capacity allows; comparedTo says which snapshot the movement is measured against. No network.

input

keyword *
string
App Store search phrase
country
string
Storefront. The keyword archive is US-heavy; charts cover the ten pulse storefronts (US, GB, JP, DE, FR, KR, CA, AU, BR, IN)(default "US")
days
integer
(default 7)
limit
integer
How many top results to report(default 25)

example call

tools/call → keyword_movers
{
  "name": "keyword_movers",
  "arguments": {
    "keyword": "habit tracker"
  }
}

output

keyword *
string
country *
string
archived *
boolean
popularity *
integer | null
Apple's 1-100 popularity when Apple lists the phrase this week
popularityWeek *
string | null
snapshots *
integer
firstSnapshotAt *
string | null
currentAt *
string | null
comparedTo *
string | null
timestamp of the snapshot movement is measured against; null when none is old enough
days *
integer
results *
object[]
position *
integer
appId *
integer
name *
string
developer *
string
rating *
number | null
ratings *
integer
previousPosition *
integer | null
change *
integer | null
previousPosition - position (positive = climbed)
ratingsChange *
integer | null
ratings gained since the comparison snapshot
status *
"new" | "up" | "down" | "steady" | "unknown"
new = outside the top 200 in the comparison snapshot; unknown = no snapshot old enough to compare
entered *
object[]
results rows for apps that were outside the top 200 in the comparison snapshot
exited *
object[]
appId
integer
name
string
developer
string
previousPosition
integer
note *
string
endpoint https://mcp.openaso.ai/mcp · auth Authorization: Bearer <key> · get a key