This section describes AppStore related API services.
Provides single day's keyword ranking for given keyword and track id of an app in AppStore.
GET /appstore-keyword-ranking/{trackId}/{countryCode}/keywordrankings?keywords={keywords}&date={date}
Request Parameters
Parameter | Description |
---|---|
trackId |
(required) AppStore track id of the app |
countryCode |
(required) Two letter country code |
keywords |
(required) Comma separated keyword list (max 100 keywords are allowed) |
date |
(optional) YYYY-MM-DD formatted date, yesterday is used if omitted. |
Response Fields
Field | Description |
---|---|
trackId |
AppStore track id of app |
keyword |
Keyword |
countryCode |
Two letter country code |
date |
Date in epoch time format |
appKind |
IPHONE or IPAD |
rank |
Keyword ranking for current day |
curl "https://api.mobileaction.co/appstore-keyword-ranking/366562751/US/keywordrankings?keywords=ticket&token=YOUR_API_KEY"
[
{
"trackId":366562751,
"keyword":"ticket",
"rank":3,
"countryCode":"US",
"date":1466060806000,
"appKind":"IPHONE"
},
{
"trackId":366562751,
"keyword":"ticket",
"rank":1,
"countryCode":"US",
"date":1466060806000,
"appKind":"IPAD"
}
]
Provides historic keyword ranking for given keyword and track id of an app in AppStore. Max 30 days of history is allowed for a single request.
GET /appstore-keyword-ranking/{trackId}/{countryCode}/{keyword}/keywordrankings?startDate={startDate}&endDate={endDate}
Request Parameters
Parameter | Description |
---|---|
trackId |
(required) AppStore track id of the app |
countryCode |
(required) Two letter country code |
keyword |
(required) Keyword to get ranking history |
startDate |
(required) YYYY-MM-DD formatted date, history start date, inclusive. |
endDate |
(required) YYYY-MM-DD formatted date, history end date, inclusive. |
Response Fields
Field | Description |
---|---|
trackId |
AppStore track id of app |
keyword |
Keyword |
countryCode |
Two letter country code |
date |
Date in epoch time format |
appKind |
IPHONE or IPAD |
rank |
Keyword ranking for current day |
curl "https://api.mobileaction.co/appstore-keyword-ranking/366562751/US/ticket/keywordrankings?startDate=2017-01-01&endDate=2017-01-15&token=YOUR_API_KEY"
[
{
"trackId":366562751,
"keyword":"ticket",
"rank":3,
"countryCode":"US",
"date":1466060806000,
"appKind":"IPHONE"
},
{
"trackId":366562751,
"keyword":"ticket",
"rank":1,
"countryCode":"US",
"date":1466060806000,
"appKind":"IPAD"
}
]
Provides single day's top keywords for given track id of an app in AppStore.
GET /appstore-keyword-ranking/{trackId}/{countryCode}/top-keywords?date={date}&device={device}&limit={limit}
Request Parameters
Parameter | Description |
---|---|
trackId |
(required) AppStore track id of the app |
countryCode |
(required) Two letter country code |
date |
(required) YYYY-MM-DD formatted date |
device |
(optional) Device type(IPHONE, IPAD), IPHONE is used if omitted |
limit |
(optional) Requested number of keywords in result, default value is 100 |
Response Fields
Field | Description |
---|---|
keyword |
Keyword |
searchVolume |
Search volume of keyword |
rank |
Keyword ranking of the app |
curl "https://api.mobileaction.co/appstore-keyword-ranking/284882215/US/top-keywords?date=2018-06-26&device=IPAD&limit=150&token=YOUR_API_KEY"
[
{
"keyword":"facebook",
"searchVolume":85,
"rank":1
},
{
"keyword":"face",
"searchVolume":75,
"rank":1
}
]
Provides last day's keyword meta-data for given keyword for AppStore.
GET /appstore-keyword-ranking/{countryCode}/keyword-metadata?keyword={keyword}
Request Parameters
Parameter | Description |
---|---|
countryCode |
(required) Two letter country code |
keyword |
(required) Keyword |
Response Fields
Field | Description |
---|---|
keyword |
Keyword |
countryCode |
Two letter country code |
numberOfIpadApps |
Number of IPAD apps |
numberOfIphoneApps |
Number of IPHONE apps |
searchVolume |
Search Volume |
ownIphoneChance |
IPHONE Chance |
ownIpadChance |
IPAD Chance |
popularity |
Search Ads Popularity Score |
brandApp |
Brand app track id |
curl "https://api.mobileaction.co/appstore-keyword-ranking/US/keyword-metadata?keyword=whatsapp&token=YOUR_API_KEY"
{
"keyword": "whatsapp",
"countryCode": "US",
"numberOfIpadApps": 610,
"numberOfIphoneApps": 968,
"searchVolume": 61.0,
"ownIphoneChance": 38.4,
"ownIpadChance": 37.7,
"popularity": 87,
"brandApp": 310633997
}
Provides app list for given keyword for AppStore.
GET /appstore-keyword-ranking/{countryCode}/keyword-apps?keyword={keyword}
Request Parameters
Parameter | Description |
---|---|
countryCode |
(required) Two letter country code |
keyword |
(required) Keyword |
Response Fields
Field | Description |
---|---|
keyword |
Keyword |
countryCode |
Two letter country code |
lastUpdateDate |
Last update date |
iphoneApps |
List of track id for IPHONE apps |
ipadApps |
List of track id for IPAD apps |
curl "https://api.mobileaction.co/appstore-keyword-ranking/US/keyword-apps?keyword=twitter&token=YOUR_API_KEY"
{
"keyword": "twitter",
"countryCode": "US",
"lastUpdateDate": 1535703195000,
"iphoneApps": [
333903271,
972909677,
1018355599,
580311103,
420792544,
426026150,
286756410,
396050119,
341249709,
528626975,
1003751089,
1114106691
],
"ipadApps": [
333903271,
1018355599,
580311103,
420792544,
286756410,
341249709,
528626975,
972909677,
1207818210,
1222206149,
523005640,
468155091,
1350019098,
1136209740,
1296056912
]
}
Provides organic keywords and their rankings for given app in appstore.
GET /appstore-keyword-ranking/{trackId}/{countryCode}/{device}/organic-keywords?date={date}
Request Parameters
Parameter | Description |
---|---|
trackId |
(required) Track id of the app |
countryCode |
(required) Two letter country code |
device |
(required) Device type (IPHONE, IPAD) |
date |
(required) YYYY-MM-DD formatted date |
Response Fields
Field | Description |
---|---|
trackId |
Track id of the app |
countryCode |
Two letter country code |
deviceType |
IPHONE or IPAD |
date |
Given date |
rankings |
List of keywords and their rankings |
curl "https://api.mobileaction.co/appstore-keyword-ranking/1194582243/US/IPHONE/organic-keywords?date=2019-06-13&token=YOUR_API_KEY
{
"trackId": 1194582243,
"countryCode": "US",
"deviceType": "IPHONE",
"date": 1560409200000,
"rankings": [
{
"keyword": "optimizador",
"rank": 1
},
{
"keyword": "smart phones",
"rank": 1
},
{
"keyword": "all smart",
"rank": 1
},
{
"keyword": "clean sweep",
"rank": 1
}
]
}
Provides top charts information for given category, country, ranking type and device.
GET /appstore-category-v2/topcharts/{version}/{categoryId}/{countryCode}/{rankingType}/{targetDevice}?date={date}
Request Parameters
Parameter | Description |
---|---|
version |
(required) "v1" for iOS 11 and before, "v2" for iOS 12+ (currently only overall category is available) |
categoryId |
(required) Integer category id |
countryCode |
(required) Two letter country code |
rankingType |
(required) FREE, PAID, GROSSING |
targetDevice |
(required) IPHONE, IPAD |
date |
(required) YYYY-MM-DD formatted date |
Response Fields
Field | Description |
---|---|
countryCode |
Two letter country code, category rankings are mapped by this |
categoryId |
Category code, date and rankings are mapped according to this |
targetDevice |
IPHONE or IPAD |
rankingType |
FREE, PAID, GROSSING |
date |
Date in LocalDateTime format |
trackIds |
List of AppStore track ids, sorted by ranking |
curl "https://api.mobileaction.co/appstore-category-v2/topcharts/v1/36/US/FREE/IPHONE?date=2019-03-01&token=YOUR_API_KEY"
{
"countryCode": "US",
"categoryId": 36,
"targetDevice": "IPHONE",
"rankingType": "FREE",
"date": "2019-03-01T23:05:17",
"trackIds": [
1448852425,
544007664,
310633997,
454638411,
1445450568,
389801252,
284882215,
447188370,
422689480,
711923939
]
}
Provides category rankings history of an app in AppStore. Max 30 days of history is allowed for a single request.
GET /appstore-category-v2/rankings/{version}/{trackId}/{countryCode}?hourly={hourly}&startDate={startDate}&endDate={endDate}
Request Parameters
Parameter | Description |
---|---|
version |
(required) "v1" for iOS 11 and before, "v2" for iOS 12+ (currently only overall category is available) |
trackId |
(required) AppStore track id of app |
hourly |
(required) "true" for exact values, "false" for aggregated daily average values. |
countryCode |
(required) Two letter country code |
startDate |
(required) YYYY-MM-DD formatted date, history start date, inclusive. |
endDate |
(required) YYYY-MM-DD formatted date, history end date, exclusive. |
Response Fields
Field | Description |
---|---|
trackId |
AppStore track id of app |
countryCode |
Two letter country code, category rankings are mapped by this |
categoryId |
Category code, date and rankings are mapped according to this |
targetDevice |
IPHONE or IPAD |
rankingType |
FREE, PAID, GROSSING |
date |
Date in LocalDateTime format |
rank |
Category ranking value |
curl "https://api.mobileaction.co/appstore-category-v2/rankings/v1/529479190/US?hourly=false&startDate=2019-02-01&endDate=2019-02-02&token=YOUR_API_KEY"
{
"trackId": 529479190,
"ranksByCategory": {
"US": {
"36": [
{
"targetDevice": "IPHONE",
"rankingType": "FREE",
"rankingsByDate": [
{
"date": "2019-02-01T00:00:00",
"ranking": 214
},
{
"date": "2019-02-02T00:00:00",
"ranking": 223
}
]
},
{
"targetDevice": "IPHONE",
"rankingType": "GROSSING",
"rankingsByDate": [
{
"date": "2019-02-01T00:00:00",
"ranking": 11
},
{
"date": "2019-02-02T00:00:00",
"ranking": 11
}
]
},
{
"targetDevice": "IPAD",
"rankingType": "FREE",
"rankingsByDate": [
{
"date": "2019-02-01T00:00:00",
"ranking": 236
},
{
"date": "2019-02-02T00:00:00",
"ranking": 253
}
]
},
{
"targetDevice": "IPAD",
"rankingType": "GROSSING",
"rankingsByDate": [
{
"date": "2019-02-01T00:00:00",
"ranking": 15
},
{
"date": "2019-02-02T00:00:00",
"ranking": 14
}
]
}
],
"6014": [
{
"targetDevice": "IPHONE",
"rankingType": "FREE",
"rankingsByDate": [
{
"date": "2019-02-01T00:00:00",
"ranking": 71
},
{
"date": "2019-02-02T00:00:00",
"ranking": 81
}
]
},
{
"targetDevice": "IPHONE",
"rankingType": "GROSSING",
"rankingsByDate": [
{
"date": "2019-02-01T00:00:00",
"ranking": 6
},
{
"date": "2019-02-02T00:00:00",
"ranking": 5
}
]
},
{
"targetDevice": "IPAD",
"rankingType": "FREE",
"rankingsByDate": [
{
"date": "2019-02-01T00:00:00",
"ranking": 144
},
{
"date": "2019-02-02T00:00:00",
"ranking": 162
}
]
},
{
"targetDevice": "IPAD",
"rankingType": "GROSSING",
"rankingsByDate": [
{
"date": "2019-02-01T00:00:00",
"ranking": 13
},
{
"date": "2019-02-02T00:00:00",
"ranking": 13
}
]
}
]
}
}
}
Provides global category rankings of an app in AppStore for last day.
GET /appstore-category-v2/global-rankings-last-day/{trackId}/{device}
Request Parameters
Parameter | Description |
---|---|
trackId |
(required) Appstore track id of the app. |
device |
(required) IPHONE or IPAD. |
Response Fields
Field | Description |
---|---|
trackId |
AppStore track id of app |
countryCode |
Two letter country code, category rankings are mapped by this |
categoryId |
Category code, date and rankings are mapped according to this |
targetDevice |
IPHONE or IPAD |
rankingType |
FREE, PAID, GROSSING |
date |
Date in LocalDateTime format |
rank |
Category ranking value |
curl "https://api.mobileaction.co/appstore-category-v2/global-rankings-last-day/529479190/IPHONE?token=YOUR_API_KEY"
{
"trackId": 529479190,
"ranksByCategory": {
"LI": {
"36": [
{
"targetDevice": "IPHONE",
"rankingType": "FREE",
"rankingsByDate": [
{
"date": "2019-06-18T05:30:05",
"ranking": 217
}
]
},
{
"targetDevice": "IPHONE",
"rankingType": "GROSSING",
"rankingsByDate": [
{
"date": "2019-06-18T05:30:06",
"ranking": 5
}
]
}
],
"6014": [
{
"targetDevice": "IPHONE",
"rankingType": "FREE",
"rankingsByDate": [
{
"date": "2019-06-18T05:28:15",
"ranking": 89
}
]
},
{
"targetDevice": "IPHONE",
"rankingType": "GROSSING",
"rankingsByDate": [
{
"date": "2019-06-18T05:28:17",
"ranking": 1
}
]
}
],
"7001": [
{
"targetDevice": "IPHONE",
"rankingType": "FREE",
"rankingsByDate": [
{
"date": "2019-06-18T05:28:54",
"ranking": 27
}
]
},
{
"targetDevice": "IPHONE",
"rankingType": "GROSSING",
"rankingsByDate": [
{
"date": "2019-06-18T05:28:56",
"ranking": 1
}
]
}
],
"7017": [
{
"targetDevice": "IPHONE",
"rankingType": "FREE",
"rankingsByDate": [
{
"date": "2019-06-18T05:29:51",
"ranking": 6
}
]
},
{
"targetDevice": "IPHONE",
"rankingType": "GROSSING",
"rankingsByDate": [
{
"date": "2019-06-18T05:29:53",
"ranking": 1
}
]
}
]
}
}
}
Provides app infos for newly released app for given country and category.
GET /appstore-category-v2/new-apps/{categoryId}/{countryCode}/{rankingType}?date={date}
Request Parameters
Parameter | Description |
---|---|
category |
(required) Category id |
countryCode |
(required) Two letter country code |
rankingType |
(required) FREE, PAID or GROSSING |
date |
(optional) YYYY-MM-DD formatted date, default value is yesterday's date |
Response Fields
Field | Description |
---|---|
trackId |
Appstore track id of app |
name |
App name |
url |
App URL |
price |
App price |
iconUrl |
URL containing app's icon |
releaseDate |
Release date of the app in date-time format |
developerName |
Name of the developer |
curl "https://api.mobileaction.co/appstore-category-v2/new-apps/6000/US/FREE?token=YOUR_API_KEY"
[
{
"trackId": "1567876275",
"name": "Ahsen Demir Çelik",
"url": "Ahsen Demir Çelik",
"price": "0.00",
"iconUrl": "https://is3-ssl.mzstatic.com/image/thumb/Purple125/v4/61/e5/54/61e55409-7134-724a-92be-7d5dce0f10d2/AppIcon-0-0-1x_U007emarketing-0-0-0-5-0-0-sRGB-0-0-0-GLES2_U002c0-512MB-85-220-0-0.png/100x100bb.png",
"category": "6000",
"releaseDate": "2021-05-18T00:00:00",
"developerName": "Ramazan Oksuz"
},
{
"trackId": "1567902120",
"name": "Alan Tierney and Partners",
"url": "Alan Tierney and Partners",
"price": "0.00",
"iconUrl": "https://is3-ssl.mzstatic.com/image/thumb/Purple125/v4/04/6d/b9/046db94b-ea74-0a33-bff3-d53affbbc3ac/AppIcons-1x_U007emarketing-0-7-0-0-85-220.png/100x100bb.png",
"category": "6000",
"releaseDate": "2021-05-18T00:00:00",
"developerName": "Alan Tierney and Partners Ltd"
},
{
"trackId": "1567951917",
"name": "Alpine Insurance",
"url": "Alpine Insurance",
"price": "0.00",
"iconUrl": "https://is4-ssl.mzstatic.com/image/thumb/Purple115/v4/05/1d/c0/051dc01c-e4d7-dc18-faa5-fa53e88e43c4/AppIcons-1x_U007emarketing-0-7-0-0-85-220.png/100x100bb.png",
"category": "6000",
"releaseDate": "2021-05-18T00:00:00",
"developerName": "Alpine Insurance & Financial Inc."
}
]
Provides detailed information for an app in AppStore.
GET /appstore-appinfo-v2/app/detailed/{trackId}
GET /appstore-appinfo-v2/app/detailed/{trackId}/{countryCode}
Request Parameters
Parameter | Description |
---|---|
trackId |
(required) AppStore track id of app |
countryCode |
(optional) Two letter country code of the app. Defaults to primary country of the app if not provided |
Response Fields
Field | Description |
---|---|
trackId |
AppStore track id of app |
name |
Name of the app |
developerId |
Id of the app owner |
developerName |
Name of the app owner, publisher |
price |
App price information |
iconUrl |
Url for up to date app icon |
categoryId |
A code for the category of the app |
categoryName |
Name of the category of the app |
releaseDate |
Release date of the app |
countryCode |
Country code of the current app info |
description |
Description of the app |
screenshotList |
Url list of the screenshots |
offersInAppPurchase |
Whether the app offers in app purchase or not |
userRatingCount |
Counts of the user ratings for the app |
userRatingAverage |
Average user rating value for the app |
availableCountries |
Two Letter country code list in which app exists |
curl "https://api.mobileaction.co/appstore-appinfo-v2/app/detailed/284882215?token=YOUR_API_KEY"
{
"trackId": 284882215,
"name": "Facebook",
"developerId": 1453,
"developerName": "Facebook Corp.",
"categoryId": 6005,
"categoryName": "Social",
"iconUrl": "https://is3-ssl.mzstatic.com/image/thumb/Purple7/v4/ff/61/source/60x60bb.jpg",
"price": "Free",
"releaseDate": 1215759600000,
"countryCode": "US",
"description": "Facebook is your social platform.",
"screenshotList":
[
"https://is3-ssl.mzstatic.com/image/thumb/Blue3/v4/ff/61/source/Samplex60.jpg",
"https://is1-ssl.mzstatic.com/image/pf/us/r30/Yellow9/v4/39/Icon-Production.png"
],
"offersInAppPurchase": true,
"userRatingCount": 2844,
"userRatingAverage": 3.5,
"removed": false,
"lastModified": 1450717805283,
"availableCountries": [ "US","JP","CN","GB","AU","TR","CA","FR","VN"]
}
Provides simplified information for given apps in AppStore.
GET /appstore-appinfo-v2/app/simple/{countryCode}?trackIds={trackIds}
Request Parameters
Parameter | Description |
---|---|
trackIds |
(required) Comma separated list of AppStore track ids of apps. Max. 10 apps are allowed. |
countryCode |
(required) Two letter country code of the app. |
Response Fields
Field | Description |
---|---|
trackId |
AppStore track id of app |
name |
Name of the app |
developerId |
Id of the app owner |
price |
App price information |
iconUrl |
Url for up to date app icon |
categoryId |
A code for the category of the app |
categoryName |
Name of the category of the app |
ratingCount |
Counts of the user ratings for the app |
rating |
Average user rating value for the app |
lastUpdate |
Last update date of the app |
curl "https://api.mobileaction.co/appstore-appinfo-v2/app/simple/US?trackIds=284882215,389801252&token=YOUR_API_KEY"
[
{
"trackId": 284882215,
"name": "Facebook",
"categoryId": 6005,
"iconUrl": "https://is3-ssl.mzstatic.com/image/thumb/Purple113/v4/71/0b/7a/710b7ac4-8c67-2978-64b2-f812e1a9d4d8/source/60x60bb.jpg",
"price": "0.00",
"developerId": "284882218",
"developerName": "Facebook, Inc.",
"rating": 3.5,
"ratingCount": 3272871,
"lastUpdate": 1560440471000,
"categoryName": "Social Networking"
},
{
"trackId": 389801252,
"name": "Instagram",
"categoryId": 6008,
"iconUrl": "https://is2-ssl.mzstatic.com/image/thumb/Purple113/v4/a8/99/29/a899296e-d589-2297-7765-e92a00b0decf/source/60x60bb.jpg",
"price": "0.00",
"developerId": "389801255",
"developerName": "Instagram, Inc.",
"rating": 5,
"ratingCount": 17847912,
"lastUpdate": 1560182268000,
"categoryName": "Photo & Video"
}
]
This endpoint provides version list (app update timeline) of the apps in AppStore.
GET /appstore-appinfo-v2/versions/{trackId}/{countryCode}?startDate={startDate}&endDate={endDate}
Request Parameters
Parameter | Description |
---|---|
trackId |
(required) AppStore track id of app |
countryCode |
(required) Two letter country code |
startDate |
(required) YYYY-MM-DD formatted date, history start date, inclusive |
endDate |
(required) YYYY-MM-DD formatted date, history end date, exclusive |
Response Fields
Field | Description |
---|---|
versionString |
Version identifier |
versionDate |
Release date of version |
releaseNotes |
Release notes |
differences |
List contains the information about which properties of apps are changed in the last version |
Possible values of differences field |
---|
AVERAGE_USER_RATING |
USER_RATING_COUNT |
AVERAGE_USER_RATING_FOR_CURRENT_VERSION |
USER_RATING_COUNT_FOR_CURRENT_VERSION |
CURRENT_VERSION_RELEASE_DATE |
NAME |
DEVELOPER_ID |
DEVELOPER_NAME |
PRICE |
ICON |
SUPPORT_URL |
VERSION |
DESCRIPTION |
PRIMARY_CATEGORY_ID |
CATEGORY_IDS |
SCREENSHOTS |
IPAD_SCREENSHOTS |
SELLER_URL |
FILE_SIZE |
RELEASE_NOTES |
HAS_INAPP_PURCHASES |
VIDEO_PREVIEWS |
SIMILAR_APPS |
SUB_TITLE |
PROMOTIONAL_TEXT |
ITUNES_NOTES |
ADDONS |
EDITORIAL_ARTWORKS |
PRE_ORDER |
curl "https://api.mobileaction.co/appstore-appinfo-v2/versions/324684580/US?startDate=2020-07-15&endDate=2020-08-01&token=YOUR_API_KEY"
[
{
"versionString": "8.5.68",
"versionDate": "2020-07-27T11:52:26",
"releaseNotes": "We’re always making changes and improvements to Spotify. To make sure you don’t miss a thing, just keep your Updates turned on.\n\nBug fixes and improvements in this version include:\n- Fixed stability and performance issues",
"differences": [
"CURRENT_VERSION_RELEASE_DATE",
"VERSION",
"RELEASE_NOTES",
"FILE_SIZE",
"AVERAGE_USER_RATING",
"USER_RATING_COUNT",
"USER_RATING_COUNT_FOR_CURRENT_VERSION",
"ADDONS",
"SIMILAR_APPS"
]
},
{
"versionString": "8.5.67",
"versionDate": "2020-07-21T06:57:07",
"releaseNotes": "We’re always making changes and improvements to Spotify. To make sure you don’t miss a thing, just keep your Updates turned on.\n\nBug fixes and improvements in this version include:\n- Fixed stability issues",
"differences": [
"CURRENT_VERSION_RELEASE_DATE",
"VERSION",
"RELEASE_NOTES",
"FILE_SIZE",
"USER_RATING_COUNT",
"USER_RATING_COUNT_FOR_CURRENT_VERSION",
"SIMILAR_APPS",
"SCREENSHOTS",
"IPAD_SCREENSHOTS"
]
}
]
This endpoint provides version list (app update timeline) with changed values of the apps in AppStore. Max. 30 days of data allowed for a single request.
GET /appstore-appinfo-v2/versions/detailed/{trackId}/{countryCode}?startDate={startDate}&endDate={endDate}
Request Parameters
Parameter | Description |
---|---|
trackId |
(required) AppStore track id of app |
countryCode |
(required) Two letter country code |
startDate |
(required) YYYY-MM-DD formatted date, history start date, inclusive |
endDate |
(required) YYYY-MM-DD formatted date, history end date, exclusive |
Response Fields
Field | Description |
---|---|
versionDate |
Release date of version |
differences |
List contains the information about which properties of apps are changed in the last version |
newData |
JSON object contains new values of changed properties |
oldData |
JSON object contains old values of changed properties |
curl "https://api.mobileaction.co/appstore-appinfo-v2/versions/detailed/324684580/US?startDate=2020-07-15&endDate=2020-07-22&token=YOUR_API_KEY"
[
{
"versionDate": "2020-07-21T06:57:07",
"differences": [
"CURRENT_VERSION_RELEASE_DATE",
"VERSION",
"RELEASE_NOTES",
"FILE_SIZE",
"USER_RATING_COUNT",
"USER_RATING_COUNT_FOR_CURRENT_VERSION",
"SIMILAR_APPS",
"SCREENSHOTS",
"IPAD_SCREENSHOTS"
],
"newData": {
"versionDate": "2020-07-21T06:57:07",
"versionString": "8.5.67",
"fileSize": 134547456,
"releaseNotes": "We’re always making changes and improvements to Spotify. To make sure you don’t miss a thing, just keep your Updates turned on.\n\nBug fixes and improvements in this version include:\n- Fixed stability issues",
"similarApps": [
1079766374,
1005093433,
938004590,
1438229046,
897461073,
497345210,
1444370634,
1450015409,
1224933860,
1207004680,
1476399789,
912390687,
1398652658,
921625944,
1125826534,
1259949354,
368205908,
1450585366,
1293175325,
1436154382,
1442118788,
904615010,
292738169,
1509147272,
1270749951,
1455067621,
1344581981,
591560124,
1060954956,
1445173813,
480625281,
1184035619,
709482991,
1098584596,
924635678
],
"userRatingCountForCurrentVersion": 13030187,
"userRatingCount": 13030187
},
"oldData": {
"versionDate": "2020-07-10T08:40:23",
"versionString": "8.5.66",
"fileSize": 133408768,
"releaseNotes": "We’re always making changes and improvements to Spotify. To make sure you don’t miss a thing, just keep your Updates turned on.\n\nBug fixes and improvements in this version include:\n- Fixed stability and performance issues",
"similarApps": [
897461073,
1079766374,
1005093433,
921625944,
938004590,
1450015409,
480625281,
497345210,
1224933860,
1207004680,
912390687,
1184035619,
1438229046,
1398652658,
1444370634,
1060954956,
368205908,
924635678,
1259949354,
1125826534,
904615010,
1293175325,
968585775,
1442118788,
1270749951,
1344581981,
1476399789,
927920917,
1042302690,
1370353702,
1455067621,
1073948898,
284035177,
1436154382,
591560124
],
"screenshots": [
"https://is4-ssl.mzstatic.com/image/thumb/Purple114/v4/f7/4b/f8/f74bf872-c2ff-86e9-1428-a5da93f806cd/pr_source.png/576x1024bb.png",
"https://is1-ssl.mzstatic.com/image/thumb/Purple114/v4/d2/96/9f/d2969f8f-0f04-e688-4b07-32e5847cda15/pr_source.png/576x1024bb.png",
"https://is2-ssl.mzstatic.com/image/thumb/Purple114/v4/9e/b8/8e/9eb88e8e-a98d-cdc8-479b-8fb89fd9f5cb/pr_source.png/576x1024bb.png",
"https://is1-ssl.mzstatic.com/image/thumb/Purple124/v4/42/81/6c/42816c95-e5a9-79fc-f181-48bd28e96f59/pr_source.png/576x1024bb.png",
"https://is3-ssl.mzstatic.com/image/thumb/Purple114/v4/03/05/9b/03059b76-c0bc-c826-02bd-8615a15ffd7c/pr_source.png/576x1024bb.png",
"https://is2-ssl.mzstatic.com/image/thumb/Purple114/v4/e5/49/e4/e549e456-af0c-ff61-2c09-0ee07187c574/pr_source.png/576x1024bb.png",
"https://is1-ssl.mzstatic.com/image/thumb/Purple124/v4/8e/70/5a/8e705aa9-aeb4-ddd0-048c-09b2736b172e/pr_source.png/576x1024bb.png",
"https://is5-ssl.mzstatic.com/image/thumb/Purple114/v4/06/d6/df/06d6dfa7-be29-9842-b9ba-e6f420888169/pr_source.png/576x1024bb.png",
"https://is3-ssl.mzstatic.com/image/thumb/Purple114/v4/79/7d/11/797d1160-e6fe-7516-2a32-1c2024501177/pr_source.png/576x1024bb.png"
],
"ipadScreenshots": [
"https://is5-ssl.mzstatic.com/image/thumb/Purple114/v4/15/75/cf/1575cf6a-ec29-8bd0-613f-c17037935bec/pr_source.png/767x1024bb.png",
"https://is2-ssl.mzstatic.com/image/thumb/Purple114/v4/94/8b/f7/948bf7be-5abc-5203-7c32-ea35031c83f9/pr_source.png/767x1024bb.png",
"https://is4-ssl.mzstatic.com/image/thumb/Purple124/v4/e6/87/2d/e6872da5-629b-6cc0-d90b-4e4f3ce6c50c/pr_source.png/767x1024bb.png",
"https://is4-ssl.mzstatic.com/image/thumb/Purple124/v4/a6/aa/b4/a6aab464-81e8-83a1-6873-1eb6eeb10a97/pr_source.png/767x1024bb.png",
"https://is4-ssl.mzstatic.com/image/thumb/Purple124/v4/ae/0e/db/ae0edbec-6a4e-101b-2ec7-b2c88a19e549/pr_source.png/767x1024bb.png",
"https://is1-ssl.mzstatic.com/image/thumb/Purple124/v4/4c/95/12/4c9512f2-1e45-026c-945a-0161c78aa8e8/pr_source.png/767x1024bb.png"
],
"userRatingCountForCurrentVersion": 13017684,
"userRatingCount": 13017684
}
}
]
This endpoint provides a list of apps owned by the given developer in the given country.
GET /appstore-appinfo-v2/app/developer/{developerId}/{countryCode}
Request Parameters
Parameter | Description |
---|---|
developerId |
(required) Id of the developer |
countryCode |
(required) Two letter country code |
Response Fields
Field | Description |
---|---|
trackId |
Track id of the app |
name |
Name of the app |
iconUpl |
URL for app display image |
price |
Price of the app |
category |
Category id of the app |
developerName |
Name of the developer |
lastUpdateTime |
Timestamp of the last update |
curl "https://api.mobileaction.co/appstore-appinfo-v2/app/developer/447553567/US?token=YOUR_API_KEY"
[
{
"trackId": 447553564,
"name": "Slotomania™ Vegas Casino Slots",
"iconUrl": "https://is2-ssl.mzstatic.com/image/thumb/Purple123/v4/70/48/b4/7048b42d-19a4-8488-61df-f5c915ac66db/source/60x60bb.jpg",
"price": "0.00",
"category": 6014,
"developerId": "447553567",
"developerName": "Playtika LTD",
"lastUpdateTime": 1554883043000
},
{
"trackId": 480523695,
"name": "Poker Heat: Texas Holdem Poker",
"iconUrl": "https://is3-ssl.mzstatic.com/image/thumb/Purple124/v4/f8/11/c9/f811c9ae-9296-60e6-e4f5-96f420de0d1e/source/60x60bb.jpg",
"price": "0.00",
"category": 6014,
"developerId": "447553567",
"developerName": "Playtika LTD",
"lastUpdateTime": 1547716402000
},
{
"trackId": 603097018,
"name": "Caesars Casino Official Slots",
"iconUrl": "https://is1-ssl.mzstatic.com/image/thumb/Purple113/v4/ed/0a/52/ed0a522d-72ba-cdd7-ba34-3146dced4867/source/60x60bb.jpg",
"price": "0.00",
"category": 6014,
"developerId": "447553567",
"developerName": "Playtika LTD",
"lastUpdateTime": 1554900268000
},
{
"trackId": 718985796,
"name": "Caesars Slots – Casino Games",
"iconUrl": "https://is2-ssl.mzstatic.com/image/thumb/Purple123/v4/31/9e/ea/319eea6a-fa7d-f6d2-5e46-cae727f7c86e/source/60x60bb.jpg",
"price": "0.00",
"category": 6014,
"developerId": "447553567",
"developerName": "Playtika LTD",
"lastUpdateTime": 1551509294000
},
{
"trackId": 719525810,
"name": "World Series of Poker - WSOP",
"iconUrl": "https://is4-ssl.mzstatic.com/image/thumb/Purple113/v4/91/9e/02/919e02bf-b31d-f748-b6b7-d1c86a743845/source/60x60bb.jpg",
"price": "0.00",
"category": 6014,
"developerId": "447553567",
"developerName": "Playtika LTD",
"lastUpdateTime": 1554738804000
},
{
"trackId": 975035622,
"name": "Vegas Downtown Slots & Words",
"iconUrl": "https://is3-ssl.mzstatic.com/image/thumb/Purple118/v4/b0/e5/fa/b0e5fa5f-ce61-25ed-c516-cea3acfc8288/source/60x60bb.jpg",
"price": "0.00",
"category": 6014,
"developerId": "447553567",
"developerName": "Playtika LTD",
"lastUpdateTime": 1545310752000
},
{
"trackId": 976071352,
"name": "スロットマニア・フィーバー~本場ラスベガススロット",
"iconUrl": "https://is4-ssl.mzstatic.com/image/thumb/Purple114/v4/fc/6f/6a/fc6f6a93-cc11-f4f7-70e5-1dad894594be/source/60x60bb.jpg",
"price": "0.00",
"category": 6014,
"developerId": "447553567",
"developerName": "Playtika LTD",
"lastUpdateTime": 1550048895000
}
]
Queues the given App Store app for discovery.
POST /appstore-appinfo-v2/app/discover/{trackId}
Request Parameters
Parameter | Description |
---|---|
trackId |
(required) App Store track id of app |
Response Parameters
A boolean value for confirmation.
curl "https://api.mobileaction.co/appstore-appinfo-v2/app/discover/447553567?token=YOUR_API_KEY"
true
This endpoint provides review list of the apps in AppStore. If the app is not crawled it flags the app for crawling and returns empty list.
GET /appstore-app-reviews/{trackId}/{startDate}/{endDate}
Request Parameters
Parameter | Description |
---|---|
trackId |
(required) AppStore track id of app |
startDate |
(required) Start date for the reviews to be listed, format: "yyyy-MM-dd" |
endDate |
(required) End date for the reviews to be listed, format: "yyyy-MM-dd" |
rating |
(optional) Rating star count(s) for the reviews to be listed. Value must be between 1-5, i.e "3" or "1,5" |
countries |
(optional) Two letter country code(s) of the reviews posted from. Must be comma separated if provided more than one. |
textQuery |
(optional) Any word to be searched in the reviews. |
page |
(optional) Returns a maximum of 100 reviews per request, use this parameter to iterate, defaults to 0. |
Response Fields
Field | Description |
---|---|
id |
Id of the review |
reviewer |
Name of the reviewer |
date |
Post date of the review |
countryCode |
Two letter country code of the review posted from |
rating |
Rating star count for the review |
content |
Review content |
title |
Review title |
curl "https://api.mobileaction.co/appstore-app-reviews/284882215/2017-10-01/2017-11-01?rating=1,2&countries=US&token=YOUR_API_KEY"
[
{
"id": 1024,
"reviewer": "Josh H.",
"date": "2017-10-24'T'11:35:55",
"countryCode": "US",
"rating": "1",
"content": "I like how I can watch videos but now it’s the recent updates there are so many ads.",
"title": "Too many ads"
},
{
"id": 1017,
"reviewer": "KiseKagami",
"date": "2017-10-16'T'10:19:05",
"countryCode": "US",
"rating": "1",
"content": "Snap chat is simple and entertaining. No need to post countless pics on Facebook just snap and share.",
"title": "Snap is better"
},
{
"id": 1016,
"reviewer": "Ryanlaws51",
"date": "2017-10-02'T'18:40:32",
"countryCode": "US",
"rating": "2",
"content": "App crashes anytime I try to go to a group I am apart of. Please fix it.",
"title": "Groups cause crash"
}
]
This endpoint provides word based analysis for the reviews of a given app. Max. 30 days of data allowed for a single request.
Request Parameters
Parameter | Description |
---|---|
trackId |
(required) Appstore track id of app |
startDate |
(required) Start date for the reviews to be listed, format: "yyyy-MM-dd" |
endDate |
(required) End date for the reviews to be listed, format: "yyyy-MM-dd" |
rating |
(optional) Rating star count(s) for the reviews to be listed. Value must be between 1-5, i.e "3" or "1,5" |
countries |
(optional) Two letter country code(s) of the reviews posted from. Must be comma separated if provided more than one. |
textQuery |
(optional) Any word to be searched in the reviews. |
Response Fields
Field | Description |
---|---|
word |
Keyword occurred in the reviews |
averageRating |
Average rating of the reviews |
frequency |
Number of occurrences of the word |
numReviews |
Number of reviews the word occurred in |
sentiment |
Distribution of the word in review ratings |
trend |
Keyword trend |
curl "https://api.mobileaction.co/appstore-app-reviews/word-analysis/284882215/2020-04-01/2020-04-02?rating=1,2&countries=US&token=YOUR_API_KEY"
[
{
"word": "notifications",
"averageRating": 1.166666666666667,
"frequency": 79,
"numReviews": 30,
"sentiment": {
"1": 25,
"2": 5
},
"trend": {
"2020-04-02": 40,
"2020-04-01": 39
}
},
{
"word": "facebook",
"averageRating": 1.142857142857143,
"frequency": 61,
"numReviews": 42,
"sentiment": {
"1": 36,
"2": 6
},
"trend": {
"2020-04-02": 28,
"2020-04-01": 33
}
}
]
Provides download-revenue estimations of an app in AppStore. Max 30 days of history is allowed for a single request.
GET /market-estimations/appstore/estimation/download-revenue?trackId={trackId}&country={countryCode}&startDate={startDate}&endDate={endDate}&device={deviceType}
Request Parameters
Parameter | Description |
---|---|
trackId |
(required) AppStore track id of app |
country |
(required) Two letter country code |
startDate |
(required) YYYY-MM-DD formatted date, history start date, inclusive. |
endDate |
(required) YYYY-MM-DD formatted date, history end date, inclusive. |
device |
IPHONE or IPAD |
Response Fields
Field | Description |
---|---|
date |
Date in YYYY-MM-DD format |
download |
Download estimation |
revenue |
Revenue estimation |
curl "https://api.mobileaction.co/market-estimations/appstore/estimation/download-revenue?trackId=284882215&country=US&startDate=2019-01-01&endDate=2019-01-02&device=IPHONE&token=YOUR_API_KEY"
[
{
"date": "2019-01-01",
"download": 14344,
"revenue": 143
},
{
"date": "2019-01-02",
"download": 3051,
"revenue": 30
}
]
Provides global download-revenue estimations of an app in AppStore for the last month.
GET /market-estimations/appstore/estimation/download-revenue-last-month/{trackId}
Request Parameters
Parameter | Description |
---|---|
trackId |
(required) AppStore track id of app |
Response Fields
Field | Description |
---|---|
countryBreakDown |
Map of download and revenue per country |
download |
Total download estimation |
revenue |
Total revenue estimation |
curl "https://api.mobileaction.co/market-estimations/appstore/estimation/download-revenue-last-month/284882215?token=YOUR_API_KEY"
{
"countryBreakDown": {
"PT": {
"download": 27938,
"revenue": 3018
},
"US": {
"download": 4878634,
"revenue": 1796888
},
"CA": {
"download": 537225,
"revenue": 100390
},
"FR": {
"download": 308413,
"revenue": 12918
},
"BR": {
"download": 251478,
"revenue": 28012
}
},
"download": 10001913,
"revenue": 2667913
}
Provides Daily Active User (DAU) estimations for the given app and country between the dates. Max 30 days of data allowed for a single request.
GET /market-estimations/appstore/estimation/dau/{trackId}?country={country}&startDate={startDate}&endDate={endDate}&token={YOUR_API_KEY}
Request Parameters
Parameter | Description |
---|---|
trackId |
(required) AppStore track id of app |
country |
(required) 2 letter uppercase country code |
startDate |
(required) Start date in YYYY-MM-DD format |
endDate |
(required) End date in YYYY-MM-DD format |
Response Fields
Field | Description |
---|---|
date |
Date for estimation |
value |
Estimated DAU |
curl "https://api.mobileaction.co/market-estimations/appstore/estimation/dau/571800810?country=US&startDate=2020-09-01&endDate=2020-09-07&token=YOUR_API_KEY"
[
{
"date": "2020-09-01",
"value": 544477
},
{
"date": "2020-09-02",
"value": 690457
},
{
"date": "2020-09-03",
"value": 774136
},
{
"date": "2020-09-04",
"value": 789606
},
{
"date": "2020-09-05",
"value": 741562
},
{
"date": "2020-09-06",
"value": 683295
}
]
Provides Monthly Active User (MAU) estimations for the given app and country between the dates. Max 30 days of data allowed for a single request.
GET /market-estimations/appstore/estimation/mau/{trackId}?country={country}&startDate={startDate}&endDate={endDate}&token={YOUR_API_KEY}
Request Parameters
Parameter | Description |
---|---|
trackId |
(required) AppStore track id of app |
country |
(required) 2 letter uppercase country code |
startDate |
(required) Start date in YYYY-MM-DD format |
endDate |
(required) End date in YYYY-MM-DD format |
Response Fields
Field | Description |
---|---|
date |
Date for estimation |
value |
Estimated DAU |
curl "https://api.mobileaction.co/market-estimations/appstore/estimation/mau/571800810?country=US&startDate=2020-09-01&endDate=2020-09-07&token=YOUR_API_KEY"
[
{
"date": "2020-09-01",
"value": 4483249
},
{
"date": "2020-09-02",
"value": 4634806
},
{
"date": "2020-09-03",
"value": 4802207
},
{
"date": "2020-09-04",
"value": 4853332
},
{
"date": "2020-09-05",
"value": 4703269
},
{
"date": "2020-09-06",
"value": 4549871
}
]