My App Store Ranking
Access to your Apple App Store and Google Play Store rankings, competitors and chart moves.
我該用這個嗎
品質與安全性
發現項目(1)
- LOW在 get_rivals 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案:
{
"mcpServers": {
"myappstoreranking": {
"url": "https://mcp.myappstoreranking.com/mcp"
}
}
}遠端端點
https://mcp.myappstoreranking.com/mcpstreamable-http它能做什麼
工具清單
工具(9)
🟢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?"
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"apps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"appStoreId": {
"type": "string"
},
"store": {
"type": "string",
"enum": [
"app_store",
"play_store"
]
},
"name": {
"type": "string"
},
"iconUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"platforms": {
"type": "array",
"items": {
"type": "string",
"enum": [
"iphone",
"ipad",
"mac",
"android"
]
}
},
"genres": {
"type": "array",
"items": {
"type": "string"
}
},
"label": {
"type": "string",
"enum": [
"mine",
"competitor"
]
},
"trackedSince": {
"type": "string"
}
},
"required": [
"appStoreId",
"store",
"name",
"iconUrl",
"platforms",
"genres",
"label",
"trackedSince"
],
"additionalProperties": false
}
}
},
"required": [
"apps"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_apps_overview(rangeDays, end, platforms, countries)
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?"
輸入結構描述
{
"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"
}輸出結構描述
{
"type": "object",
"properties": {
"end": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"rangeDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"apps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"appStoreId": {
"type": "string"
},
"name": {
"type": "string"
},
"label": {
"type": "string",
"enum": [
"mine",
"competitor"
]
},
"countriesRanked": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"previousCountriesRanked": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"top5": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"previousCount": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"delta": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"count",
"previousCount",
"delta"
],
"additionalProperties": false
},
"top25": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"previousCount": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"delta": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"count",
"previousCount",
"delta"
],
"additionalProperties": false
},
"bestChart": {
"anyOf": [
{
"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": -9007199254740991,
"maximum": 9007199254740991
},
"genre": {
"type": "string"
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"rank": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"country",
"platform",
"chartType",
"genreId",
"genre",
"date",
"rank"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"appStoreId",
"name",
"label",
"countriesRanked",
"previousCountriesRanked",
"top5",
"top25",
"bestChart"
],
"additionalProperties": false
}
}
},
"required": [
"end",
"rangeDays",
"apps"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_app_country_ranks(appStoreId, rangeDays, end, platforms, countries)
The country grid for a single app over a date window, with the previous window's rank for comparison, plus the per-platform breakdown. Works for any app in the catalog, not only tracked ones, but untracked apps return a single recent day rather than a full window. Example question: "Where does my app rank across Europe right now?"
輸入結構描述
{
"type": "object",
"properties": {
"appStoreId": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"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}$"
}
}
},
"required": [
"appStoreId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"appStoreId": {
"type": "string"
},
"end": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"rangeDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"top5": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"previousCount": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"delta": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"count",
"previousCount",
"delta"
],
"additionalProperties": false
},
"top25": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"previousCount": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"delta": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"count",
"previousCount",
"delta"
],
"additionalProperties": false
},
"countries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"country": {
"type": "string",
"pattern": "^[a-z]{2}$"
},
"countryName": {
"type": "string"
},
"best": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"previousBest": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"chart": {
"anyOf": [
{
"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": -9007199254740991,
"maximum": 9007199254740991
},
"genre": {
"type": "string"
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"country",
"platform",
"chartType",
"genreId",
"genre",
"date"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"country",
"countryName",
"best",
"previousBest",
"chart"
],
"additionalProperties": false
}
},
"ranks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"country": {
"type": "string",
"pattern": "^[a-z]{2}$"
},
"platform": {
"type": "string",
"enum": [
"iphone",
"ipad",
"mac",
"android"
]
},
"best": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"previousBest": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"country",
"platform",
"best",
"previousBest"
],
"additionalProperties": false
}
}
},
"required": [
"appStoreId",
"end",
"rangeDays",
"top5",
"top25",
"countries",
"ranks"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_app_history(appStoreId, sinceDays, country, platform, chartType, ...)
Raw rank observations, newest first, for trend questions. Filter by country, platform, chart type or category, because an unfiltered portfolio-wide history is large and will be truncated. Only apps the user tracks have history. Example question: "Show my app's daily rank in France over the last month."
輸入結構描述
{
"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"
}輸出結構描述
{
"type": "object",
"properties": {
"appStoreId": {
"type": "string"
},
"sinceDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"truncated": {
"type": "boolean"
},
"history": {
"type": "array",
"items": {
"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": -9007199254740991,
"maximum": 9007199254740991
},
"genre": {
"type": "string"
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"rank": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"country",
"platform",
"chartType",
"genreId",
"genre",
"date",
"rank"
],
"additionalProperties": false
}
}
},
"required": [
"appStoreId",
"sinceDays",
"truncated",
"history"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_chart_top(country, platform, chartType, genreId, date)
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?"
輸入結構描述
{
"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"
}輸出結構描述
{
"type": "object",
"properties": {
"chart": {
"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": -9007199254740991,
"maximum": 9007199254740991
},
"genre": {
"type": "string"
},
"date": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
}
},
"required": [
"country",
"platform",
"chartType",
"genreId",
"genre",
"date"
],
"additionalProperties": false
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"appStoreId": {
"type": "string"
},
"name": {
"type": "string"
},
"iconUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"platforms": {
"type": "array",
"items": {
"type": "string",
"enum": [
"iphone",
"ipad",
"mac",
"android"
]
}
},
"tracked": {
"type": "boolean"
},
"label": {
"anyOf": [
{
"type": "string",
"enum": [
"mine",
"competitor"
]
},
{
"type": "null"
}
]
}
},
"required": [
"rank",
"appStoreId",
"name",
"iconUrl",
"platforms",
"tracked",
"label"
],
"additionalProperties": false
}
}
},
"required": [
"chart",
"rows"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_rivals(rangeDays, end, platforms, countries, limit)
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?"
輸入結構描述
{
"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"
}輸出結構描述
{
"type": "object",
"properties": {
"end": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"rangeDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"rivals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"appStoreId": {
"type": "string"
},
"name": {
"type": "string"
},
"iconUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"genres": {
"type": "array",
"items": {
"type": "string"
}
},
"aheadCount": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"coOccurCount": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"aheadRate": {
"type": "number"
},
"medianGap": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"tracked": {
"type": "boolean"
},
"label": {
"anyOf": [
{
"type": "string",
"enum": [
"mine",
"competitor"
]
},
{
"type": "null"
}
]
},
"affectedApps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"appStoreId": {
"type": "string"
},
"name": {
"type": "string"
},
"aheadRate": {
"type": "number"
},
"medianGap": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"appStoreId",
"name",
"aheadRate",
"medianGap"
],
"additionalProperties": false
}
},
"closestChart": {
"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": -9007199254740991,
"maximum": 9007199254740991
},
"genre": {
"type": "string"
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"country",
"platform",
"chartType",
"genreId",
"genre",
"date"
],
"additionalProperties": false
}
},
"required": [
"appStoreId",
"name",
"iconUrl",
"genres",
"aheadCount",
"coOccurCount",
"aheadRate",
"medianGap",
"tracked",
"label",
"affectedApps",
"closestChart"
],
"additionalProperties": false
}
}
},
"required": [
"end",
"rangeDays",
"rivals"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_leaders(country, platform, chartType, genreId, rangeDays, ...)
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?"
輸入結構描述
{
"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"
}輸出結構描述
{
"type": "object",
"properties": {
"chart": {
"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": -9007199254740991,
"maximum": 9007199254740991
},
"genre": {
"type": "string"
}
},
"required": [
"country",
"platform",
"chartType",
"genreId",
"genre"
],
"additionalProperties": false
},
"end": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"rangeDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"baselineAvailable": {
"type": "boolean"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"appStoreId": {
"type": "string"
},
"name": {
"type": "string"
},
"iconUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"platforms": {
"type": "array",
"items": {
"type": "string",
"enum": [
"iphone",
"ipad",
"mac",
"android"
]
}
},
"medianRank": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"bestRank": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"bestDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"daysPresent": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"daysTop5": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"daysAt1": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"chartDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"previousMedianRank": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"movement": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"isNewEntrant": {
"type": "boolean"
},
"tracked": {
"type": "boolean"
},
"label": {
"anyOf": [
{
"type": "string",
"enum": [
"mine",
"competitor"
]
},
{
"type": "null"
}
]
}
},
"required": [
"appStoreId",
"name",
"iconUrl",
"platforms",
"medianRank",
"bestRank",
"bestDate",
"daysPresent",
"daysTop5",
"daysAt1",
"chartDays",
"previousMedianRank",
"movement",
"isNewEntrant",
"tracked",
"label"
],
"additionalProperties": false
}
}
},
"required": [
"chart",
"end",
"rangeDays",
"baselineAvailable",
"rows"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_daily_report(frequency)
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?"
輸入結構描述
{
"type": "object",
"properties": {
"frequency": {
"default": "daily",
"type": "string",
"enum": [
"daily",
"weekly"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"frequency": {
"type": "string",
"enum": [
"daily",
"weekly"
]
},
"rangeDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"windowStart": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"windowEnd": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"previousWindowStart": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"previousWindowEnd": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"headline": {
"type": "string"
},
"summary": {
"type": "object",
"properties": {
"appsMonitored": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"countriesRanked": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"previousCountriesRanked": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"top5": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"previousTop5": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"top25": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"previousTop25": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"required": [
"appsMonitored",
"countriesRanked",
"previousCountriesRanked",
"top5",
"previousTop5",
"top25",
"previousTop25"
],
"additionalProperties": false
},
"apps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"appStoreId": {
"type": "string"
},
"name": {
"type": "string"
},
"label": {
"type": "string"
},
"noData": {
"type": "boolean"
},
"signal": {
"type": "string",
"enum": [
"improving",
"stable",
"declining",
"no_data"
]
},
"countriesRanked": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"previousCountriesRanked": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"top5": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"top25": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"newEntries": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"droppedEntries": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"tips": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"appStoreId",
"name",
"label",
"noData",
"signal",
"countriesRanked",
"previousCountriesRanked",
"top5",
"top25",
"newEntries",
"droppedEntries",
"tips"
],
"additionalProperties": false
}
},
"needsAttention": {
"type": "array",
"items": {
"type": "object",
"properties": {
"appStoreId": {
"type": "string"
},
"appName": {
"type": "string"
},
"kind": {
"type": "string"
},
"severity": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"positive": {
"type": "boolean"
},
"text": {
"type": "string"
},
"detail": {
"type": "string"
},
"action": {
"type": "string"
},
"country": {
"type": "string",
"pattern": "^[a-z]{2}$"
},
"platform": {
"type": "string",
"enum": [
"iphone",
"ipad",
"mac",
"android"
]
},
"genre": {
"type": "string"
}
},
"required": [
"appStoreId",
"appName",
"kind",
"severity",
"positive",
"text",
"detail",
"action"
],
"additionalProperties": false
}
},
"wins": {
"type": "array",
"items": {
"type": "object",
"properties": {
"appStoreId": {
"type": "string"
},
"appName": {
"type": "string"
},
"kind": {
"type": "string"
},
"severity": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"positive": {
"type": "boolean"
},
"text": {
"type": "string"
},
"detail": {
"type": "string"
},
"action": {
"type": "string"
},
"country": {
"type": "string",
"pattern": "^[a-z]{2}$"
},
"platform": {
"type": "string",
"enum": [
"iphone",
"ipad",
"mac",
"android"
]
},
"genre": {
"type": "string"
}
},
"required": [
"appStoreId",
"appName",
"kind",
"severity",
"positive",
"text",
"detail",
"action"
],
"additionalProperties": false
}
},
"competitorWatch": {
"type": "array",
"items": {
"type": "object",
"properties": {
"appStoreId": {
"type": "string"
},
"appName": {
"type": "string"
},
"kind": {
"type": "string"
},
"severity": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"positive": {
"type": "boolean"
},
"text": {
"type": "string"
},
"detail": {
"type": "string"
},
"action": {
"type": "string"
},
"country": {
"type": "string",
"pattern": "^[a-z]{2}$"
},
"platform": {
"type": "string",
"enum": [
"iphone",
"ipad",
"mac",
"android"
]
},
"genre": {
"type": "string"
}
},
"required": [
"appStoreId",
"appName",
"kind",
"severity",
"positive",
"text",
"detail",
"action"
],
"additionalProperties": false
}
},
"closestThreats": {
"type": "array",
"items": {
"type": "object",
"properties": {
"appStoreId": {
"type": "string"
},
"name": {
"type": "string"
},
"country": {
"type": "string",
"pattern": "^[a-z]{2}$"
},
"platform": {
"type": "string",
"enum": [
"iphone",
"ipad",
"mac",
"android"
]
},
"genre": {
"type": "string"
},
"aheadCount": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"gap": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"myAppName": {
"type": "string"
}
},
"required": [
"appStoreId",
"name",
"country",
"platform",
"genre",
"aheadCount",
"gap",
"myAppName"
],
"additionalProperties": false
}
},
"newEntrants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"appStoreId": {
"type": "string"
},
"name": {
"type": "string"
},
"country": {
"type": "string",
"pattern": "^[a-z]{2}$"
},
"platform": {
"type": "string",
"enum": [
"iphone",
"ipad",
"mac",
"android"
]
},
"genre": {
"type": "string"
},
"aheadCount": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"gap": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"myAppName": {
"type": "string"
}
},
"required": [
"appStoreId",
"name",
"country",
"platform",
"genre",
"aheadCount",
"gap",
"myAppName"
],
"additionalProperties": false
}
}
},
"required": [
"frequency",
"rangeDays",
"windowStart",
"windowEnd",
"previousWindowStart",
"previousWindowEnd",
"headline",
"summary",
"apps",
"needsAttention",
"wins",
"competitorWatch",
"closestThreats",
"newEntrants"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_reference_data
The enum values every other tool accepts. Call this before guessing a country code or category id: invalid parameters fail, and failed calls still count against the daily quota.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"countries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"pattern": "^[a-z]{2}$"
},
"name": {
"type": "string"
}
},
"required": [
"code",
"name"
],
"additionalProperties": false
}
},
"platforms": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string",
"enum": [
"iphone",
"ipad",
"mac",
"android"
]
},
"label": {
"type": "string"
},
"store": {
"type": "string",
"enum": [
"app_store",
"play_store"
]
}
},
"required": [
"slug",
"label",
"store"
],
"additionalProperties": false
}
},
"chartTypes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string",
"enum": [
"free",
"paid"
]
},
"label": {
"type": "string"
}
},
"required": [
"slug",
"label"
],
"additionalProperties": false
}
},
"genres": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"name": {
"type": "string"
},
"stores": {
"type": "array",
"items": {
"type": "string",
"enum": [
"app_store",
"play_store"
]
}
}
},
"required": [
"id",
"name",
"stores"
],
"additionalProperties": false
}
}
},
"required": [
"countries",
"platforms",
"chartTypes",
"genres"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}社群
證據