tools / chart_movers
chart_movers
read-onlyWhat's climbing, new or falling on the charts
Movement on Apple's top-100 charts (top-free, top-paid, top-grossing) for a storefront and category, from openaso's every-four-hours archive: view=new finds apps that just appeared (use releasedWithinDays to keep only genuinely new releases), rising/falling rank the biggest position changes against the last snapshot `days` back, dropped lists apps that left, top is the chart now. Each row carries days on chart and first-seen, plus releaseDate, ratings and price from a live lookup when enrich is on. This is the new-app and traction discovery surface; follow up with app_traction, app_keywords and revenue. Chart rank is a public traction signal, not a download count. Reads the archive (plus one lookup request when enriching).
input
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")
chart
"top-free" | "top-paid" | "top-grossing"
(default "top-free")
genre
string
Category name ("Photo & Video", "Games", …) or id (6000, 6001, 6002, 6003, 6004, 6005, 6006, 6007, 6008, 6009, 6010, 6011, 6012, 6013, 6014, 6015, 6016, 6017, 6018, 6020, 6021, 6023, 6024, 6026, 6027); omit or "all" for the overall chart
view
"top" | "new" | "rising" | "falling" | "dropped"
(default "top")
days
integer
Compare against the last snapshot of the day this many days back(default 7)
lookbackDays
integer
How far back view=new looks for earlier appearances(default 60)
limit
integer
(default 25)
releasedWithinDays
integer
Keep only apps first released within this many days (needs enrich; filters before limit)
enrich
boolean
Add releaseDate, ratings, rating, price and version from a live iTunes lookup(default true)
example call
tools/call → chart_movers
{ "name": "chart_movers", "arguments": {} }
output
country *
string
chart *
"top-free" | "top-paid" | "top-grossing"
genreId *
integer | null
null = the overall chart
genre *
string
view *
"top" | "new" | "rising" | "falling" | "dropped"
days *
integer
lookbackDays *
integer
currentAt *
string | null
comparedTo *
string | null
archived *
boolean
false = no snapshot archived for this chart/storefront/category
rows *
object[]
position *
integer
appId *
integer
name *
string
developer *
string
previousPosition *
integer | null
position in the comparison snapshot; null = not on the chart then
change *
integer | null
previousPosition - position (positive = climbed)
daysOnChart *
integer
firstSeen *
string
debuted *
boolean
releaseDate
string | null
ratings
integer | null
rating
number | null
price
string | null
version
string | null
dropped *
object[]
appId
integer
name
string
developer
string
previousPosition
integer
note *
string