openaso

tools / charts

charts

read-only

Top-chart positions

The app's position on the overall top-free, top-paid and top-grossing charts (top 100), per storefront. null = not on that chart. Free/paid come from Apple's public marketing-tools feed; grossing comes from the legacy iTunes RSS feed (the only public source of grossing ranks). topGrossing is the one public monetization signal — feed it into the revenue tool for a modeled revenue band.

input

appId *
integer
App Store trackId of the app
countries
string[]
2-letter storefront codes, e.g. ["US", "GB", "JP"]. Each storefront is queried separately.(default ["US"])

example call

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

output

appId *
integer
chartSize *
integer
storefronts *
object[]
country *
string
topFree *
integer | null
1-based chart position, null = not in top 100
topPaid *
integer | null
1-based chart position, null = not in top 100
topGrossing *
integer | null
1-based chart position, null = not in top 100 (unless grossingUnavailable)
grossingUnavailable
boolean
present (true) only when the legacy grossing feed could not be read — topGrossing is then unknown, not "not in top 100"
endpoint https://openaso-806591819206.us-west1.run.app/mcp · auth Authorization: Bearer <key> · get a key