Contact |Login| Go to SearchAds
Blog
Pricing
Schedule a demo Sign up free

Mobile Action API Documentation

Introduction
Dashboard Services
App Store Services
Google Play Store Services
Ad Intelligence Services
Search Ads
CPP Intelligence Services
Other Services

Keyword Services

This section describes AppStore related API services.

Keyword Ranking ( 3 Credits / Request )

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

Example request

curl "https://api.mobileaction.co/appstore-keyword-ranking/366562751/US/keywordrankings?keywords=ticket&token=YOUR_API_KEY"

Example response

[
  {
    "trackId":366562751,
    "keyword":"ticket",
    "rank":3,
    "countryCode":"US",
    "date":1466060806000,
    "appKind":"IPHONE"
  },
  {
    "trackId":366562751,
    "keyword":"ticket",
    "rank":1,
    "countryCode":"US",
    "date":1466060806000,
    "appKind":"IPAD"
  }
]

Keyword History ( 10 Credits / Request )

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

Example request

curl "https://api.mobileaction.co/appstore-keyword-ranking/366562751/US/ticket/keywordrankings?startDate=2017-01-01&endDate=2017-01-15&token=YOUR_API_KEY"

Example response

[
  {
    "trackId":366562751,
    "keyword":"ticket",
    "rank":3,
    "countryCode":"US",
    "date":1466060806000,
    "appKind":"IPHONE"
  },
  {
    "trackId":366562751,
    "keyword":"ticket",
    "rank":1,
    "countryCode":"US",
    "date":1466060806000,
    "appKind":"IPAD"
  }
]

Top Keywords ( 20 Credits / Request )

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

Example request

curl "https://api.mobileaction.co/appstore-keyword-ranking/284882215/US/top-keywords?date=2018-06-26&device=IPAD&limit=150&token=YOUR_API_KEY"

Example response

[
  {
    "keyword":"facebook",
    "searchVolume":85,
    "rank":1
  },
  {
    "keyword":"face",
    "searchVolume":75,
    "rank":1
  }
]

Keyword Metadata ( 5 Credits / Request )

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

Example request

curl "https://api.mobileaction.co/appstore-keyword-ranking/US/keyword-metadata?keyword=whatsapp&token=YOUR_API_KEY"

Example response

{
    "keyword": "whatsapp",
    "countryCode": "US",
    "numberOfIpadApps": 610,
    "numberOfIphoneApps": 968,
    "searchVolume": 61.0,
    "ownIphoneChance": 38.4,
    "ownIpadChance": 37.7,
    "popularity": 87,
    "brandApp": 310633997
}

List of Apps ( 5 Credits / Request )

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

Example request

curl "https://api.mobileaction.co/appstore-keyword-ranking/US/keyword-apps?keyword=twitter&token=YOUR_API_KEY"

Example response

{
    "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
    ]
}

Organic Keywords ( 50 Credits / Request )

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

Example request

curl "https://api.mobileaction.co/appstore-keyword-ranking/1194582243/US/IPHONE/organic-keywords?date=2019-06-13&token=YOUR_API_KEY

Example response

{
  "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
    }
  ]
}

Category Services

Top Charts ( 10 Credits / Request )

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

Example request

curl "https://api.mobileaction.co/appstore-category-v2/topcharts/v1/36/US/FREE/IPHONE?date=2019-03-01&token=YOUR_API_KEY"

Example response

{
    "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
    ]
}

Category Ranking ( 10 Credits / Request )

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

Example request

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"

Example response

{
    "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
                        }
                    ]
                }
            ]
        }
    }
}

Global Last Day Category Rankings ( 20 Credits / Request )

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

Example request

curl "https://api.mobileaction.co/appstore-category-v2/global-rankings-last-day/529479190/IPHONE?token=YOUR_API_KEY"

Example response

{
  "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
            }
          ]
        }
      ]
    }
  }
}

New Apps ( 3 Credits / Request )

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

Example request

curl "https://api.mobileaction.co/appstore-category-v2/new-apps/6000/US/FREE?token=YOUR_API_KEY"

Example response

[
    {
        "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."
    }
]

App Services

App Detail ( 5 Credits / Request )

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

Example request

curl "https://api.mobileaction.co/appstore-appinfo-v2/app/detailed/284882215?token=YOUR_API_KEY"

Example response

{
    "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"]
}

App Simple Information ( 1 Credit / Request )

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

Example request

curl "https://api.mobileaction.co/appstore-appinfo-v2/app/simple/US?trackIds=284882215,389801252&token=YOUR_API_KEY"

Example response

[
  {
    "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"
  }
]

App Version List ( 1 Credit / Request )

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

Example request

curl "https://api.mobileaction.co/appstore-appinfo-v2/versions/324684580/US?startDate=2020-07-15&endDate=2020-08-01&token=YOUR_API_KEY"

Example response

[
    {
        "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"
        ]
    }
]

App Version List Detailed ( 50 Credits / Request )

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

Example request

curl "https://api.mobileaction.co/appstore-appinfo-v2/versions/detailed/324684580/US?startDate=2020-07-15&endDate=2020-07-22&token=YOUR_API_KEY"

Example response

[
    {
        "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
        }
    }
]

Developer Apps ( 5 Credits / Request )

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

Example request

curl "https://api.mobileaction.co/appstore-appinfo-v2/app/developer/447553567/US?token=YOUR_API_KEY"

Example response

[
    {
        "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
    }
]

App Discovery ( 1 Credit / Request )

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.

Example request

curl "https://api.mobileaction.co/appstore-appinfo-v2/app/discover/447553567?token=YOUR_API_KEY"

Example response

true

App Reviews ( 5 Credits / Request )

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

Example request

curl "https://api.mobileaction.co/appstore-app-reviews/284882215/2017-10-01/2017-11-01?rating=1,2&countries=US&token=YOUR_API_KEY"

Example response

[
    {
      "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"
    }
]

App Review Analysis ( 10 Credits / Request )

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

Example Request

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"

Example Response

[
    {
        "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
        }
    }
]

Download-Revenue Estimations ( 100 Credits / Request )

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

Example request

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"

Example response

[
  {
    "date": "2019-01-01",
    "download": 14344,
    "revenue": 143
  },
  {
    "date": "2019-01-02",
    "download": 3051,
    "revenue": 30
  }
]

Monthly Global Download-Revenue Estimations ( 2 Credits / Request )

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

Example request

curl "https://api.mobileaction.co/market-estimations/appstore/estimation/download-revenue-last-month/284882215?token=YOUR_API_KEY"

Example response

{
    "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
}

Daily Active User (DAU) Estimations ( 50 Credits / Request )

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

Example request

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"

Example response

[
    {
        "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
    }
]

Monthly Active User (MAU) Estimations ( 50 Credits / Request )

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

Example request

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"

Example response

[
    {
        "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
    }
]

Start for free - upgrade anytime!

No credit card required.

Company

Products

Resources

Recent Blog Posts

| Go to SearchAds.com
Company
Products
Resources
Recent Blog Posts