Mobile Action API Documentation

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.