Loading server...
{
"type": "object",
"properties": {
"appStoreId": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"sinceDays": {
"default": 90,
"type": "integer",
"minimum": 1,
"maximum": 365
},
"country": {
"type": "string",
"pattern": "^[a-z]{2}$"
},
"platform": {
"type": "string",
"enum": [
"iphone",
"ipad",
"mac",
"android"
]
},
"chartType": {
"type": "string",
"enum": [
"free",
"paid"
]
},
"genreId": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"default": 500,
"type": "integer",
"minimum": 1,
"maximum": 2000
}
},
"required": [
"appStoreId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
Portfolio summary for every tracked app over a date window
get_apps_overview
One row per tracked app: how many countries it charted in, how many top 5 and top 25 placements it holds, the change against the equal-length window before, and its single best chart position. Use this for 'how is my portfolio doing', then get_app_country_ranks to drill into one app.
Example question: "How did my apps do over the last 7 days?"
Schema valid · SHA-256 66668a386560…
View input schema
{
"type": "object",
"properties": {
"rangeDays": {
"default": 7,
"type": "integer",
"minimum": 1,
"maximum": 365
},
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"platforms": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"enum": [
"iphone",
"ipad",
"mac",
"android"
]
}
},
"countries": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z]{2}$"
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
The top of one store chart on one day
get_chart_top
Who ranks in a given country, platform, chart type and category on a given day, flagging the rows the user tracks. Defaults to the most recent captured day. Use list_reference_data for valid country codes, platforms and category ids.
Example question: "Who is in the French Music top chart on iPhone today?"
Schema valid · SHA-256 144f8019ec6e…
View input schema
{
"type": "object",
"properties": {
"country": {
"type": "string",
"pattern": "^[a-z]{2}$"
},
"platform": {
"type": "string",
"enum": [
"iphone",
"ipad",
"mac",
"android"
]
},
"chartType": {
"type": "string",
"enum": [
"free",
"paid"
]
},
"genreId": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"country",
"platform",
"chartType",
"genreId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
The user's daily or weekly report, as structured data
get_daily_report
The same analysis the user's email report is built from: portfolio summary, what needs attention, wins, competitor movements and new entrants. The best single call for a scheduled 'what happened overnight' digest.
Example question: "What happened with my apps overnight?"
Schema valid · SHA-256 c8c31b106cab…
View input schema
{
"type": "object",
"properties": {
"frequency": {
"default": "daily",
"type": "string",
"enum": [
"daily",
"weekly"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
Leaderboard for one chart over a window, with new entrants
get_leaders
Which apps dominated a chart over a date window: median rank, best rank, days present, days at number one, movement against the previous window, and whether the app is new to the chart. This is the tool for 'who moved into the top 10 this week'.
Example question: "Who moved into the French Music top 10 this week?"
Schema valid · SHA-256 03bda61c3cd9…
View input schema
{
"type": "object",
"properties": {
"country": {
"type": "string",
"pattern": "^[a-z]{2}$"
},
"platform": {
"type": "string",
"enum": [
"iphone",
"ipad",
"mac",
"android"
]
},
"chartType": {
"type": "string",
"enum": [
"free",
"paid"
]
},
"genreId": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"rangeDays": {
"default": 30,
"type": "integer",
"minimum": 1,
"maximum": 365
},
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"limit": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 60
}
},
"required": [
"country",
"platform",
"chartType",
"genreId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
Apps that share charts with the user's apps and outrank them
get_rivals
Competitors discovered from the data rather than declared: apps that appear in the same charts as the user's own apps and sit ahead of them, ranked by relevance, with how often and by how much they lead.
Example question: "Who is beating my app right now, and by how much?"
Schema valid · SHA-256 c3606bf5370f…
View input schema
{
"type": "object",
"properties": {
"rangeDays": {
"default": 30,
"type": "integer",
"minimum": 1,
"maximum": 365
},
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"platforms": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"enum": [
"iphone",
"ipad",
"mac",
"android"
]
}
},
"countries": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z]{2}$"
}
},
"limit": {
"default": 25,
"type": "integer",
"minimum": 1,
"maximum": 60
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}
List the apps the user tracks
list_my_apps
Returns every tracked app with its store id, store, platforms, categories and whether it is one of the user's own apps or a competitor they watch. Call this first: every other tool identifies an app by the appStoreId returned here.
Example question: "Which apps am I tracking?"
Schema valid · SHA-256 f25fc499abbb…
View input schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}