openaso

tools / app_ranks

app_ranks

read-only

An app's chart history

Daily chart positions for any app over time, from openaso's every-four-hours chart archive: by default every top-100 chart (top-free, top-paid, top-grossing, overall and category) the app is on right now, or the chart/category you name — name one to see when an app fell off. Each series has current/best/worst, days on chart, first seen and one point per day (null = not on the chart that day). top-grossing history is a competitor's monetization trajectory, top-free its install trajectory. No network: reads the archive.

input

appId *
integer
App Store trackId of the app
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")
charts
("top-free" | "top-paid" | "top-grossing")[]
Default: all three
genre
string
Only this category (name or id), or "all" for the overall chart; omit for wherever the app is on a chart now
days
integer
(default 30)

example call

tools/call → app_ranks
{
  "name": "app_ranks",
  "arguments": {
    "appId": 6446901002
  }
}

output

appId *
integer
country *
string
days *
integer
series *
object[]
chart *
"top-free" | "top-paid" | "top-grossing"
genreId *
integer | null
null = the overall chart
genre *
string
current *
integer | null
best *
integer | null
worst *
integer | null
daysOnChart *
integer
firstSeen *
string | null
points *
object[]
date *
string
position *
integer | null
note *
string
endpoint https://mcp.openaso.ai/mcp · auth Authorization: Bearer <key> · get a key