Mobile Action API Documentation

Keyword Services

This section describes AppStore related API services.

Keyword Ranking

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

Provides historic keyword ranking for given keyword and track id of an app in AppStore. Max 30 days of history is allowed

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

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

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

Example request

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

Example response

{
    "keyword": "ticket",
    "countryCode": "US",
    "numberOfIpadApps": 4330,
    "numberOfIphoneApps": 7572,
    "searchVolume": 47,
    "ownIphoneChance": 39.151534007475355,
    "ownIpadChance": 43.2492425588346,
    "popularity": 39
}

List of Apps

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

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

Provides top charts information for given category, country, ranking type and device. Max 30 days of history is allowed.

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

Provides category rankings history of an app in AppStore. Max 30 days of history is allowed.

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

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

App Services

App Detail

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

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

This endpoint provides version list (app update timeline) of the apps in AppStore.

GET /appstore-appinfo-v2/version-list/{trackId}/{countryCode}

Request Parameters

Parameter Description
trackId (required) AppStore track id of app
countryCode (required) Two letter country code

Response Fields

Field Description
trackId AppStore track id of app
countryCode Two letter country code
versionDiffs JSON object (String, Boolean) contains the information about which properties of apps are changed in the last version
Possible values of differences field
AVERAGE_USER_RATING
AVERAGE_USER_RATING_FOR_CURRENT_VERSION
USER_RATING_COUNT
USER_RATING_COUNT_FOR_CURRENT_VERSION
CURRENT_VERSION_RELEASE_DATE
TRACK_NAME
ARTIST_ID
ARTIST_NAME
PRICE
ARTWORK_URL_60
PRIMARY_GENRE_ID
GENRE_IDS
VERSION
DESCRIPTION
SCREENSHOT_URLS
IPAD_SCREENSHOT_URLS
APPLETV_SCREENSHOT_URLS
SELLER_URL
FILE_SIZE_BYTES
RELEASE_NOTES
HAS_INAPP_PURCHASES
SUPPORT_URL
SUB_TITLE
PROMOTIONAL_TEXT
VIDEO_PREVIEW_URL
VIDEO_PREVIEW_FRAME_URL
ITUNES_NOTES
ADDONS
CUSTOMERS_ALSO_BOUGHT
EDITORIAL_ARTWORK_URLS

Example request

curl "https://api.mobileaction.co/appstore-appinfo-v2/version-list/284882215/US?token=YOUR_API_KEY"

Example response

{
  "trackId": 284882215,
  "countryCode": "US",
  "versionDiffs": [
      {
        "id": "d4167914-0146-41e2-a918-bf297e58edf4",
        "currentVersionReleaseDate": "2017-05-30",
        "differences": [
          "PROMOTIONAL_TEXT",
          "PRIMARY_GENRE_ID",
          "SCREENSHOT_URLS",
          "INSTALL_RANGE"
        ]
      }
    ]
}

App Version Detail

This endpoint provides version details (two versions) of the apps in AppStore.

GET /appstore-appinfo-v2/version-detail/{trackId}/{countryCode}/{id}

Request Parameters

Parameter Description
trackId (required) AppStore track id of app
countryCode (required) Two letter country code
id (required) Version id, you can get this value from app version list service

Response Fields

Field Description
trackId AppStore track id of app
countryCode Two letter country code
averageUserRating Average rating for the app
averageUserRatingForCurrentVersion Average rating for the current version of the app
userRatingCount Number of ratings for the app
userRatingCountForCurrentVersion Number of ratings for the current version of the app
currentVersionReleaseDate Release date of the current version
trackName Name of the app
artistId Owner id of the app
artistName Owner name of the app
price Price of the app
artworkUrl60 Icon url of the app
primaryGenreId Main category of the app
genreIds Categories of the app
version Version of the app
description Description of the app
screenshotUrls Screenshot urls of the app
ipadScreenshotUrls Screenshot urls of the app for the ipad
appletvScreenshotUrls Screenshot urls of the app for the appletv
sellerUrl Url of the owner of the app
fileSizeBytes Size of the app
supportUrl Url of the support of the app

Example request

curl "https://api.mobileaction.co/appstore-appinfo-v2/version-detail/284882215/US/e4852c38-1e86-4630-b7cf-f42bdce125c1?token=YOUR_API_KEY"

Example response

{
    "trackId": 284882215,
    "countryCode": "US",
    "averageUserRating": 3.5,
    "averageUserRatingForCurrentVersion": 2.5,
    "userRatingCount": 3044359,
    "userRatingCountForCurrentVersion": 1428,
    "currentVersionReleaseDate": "2018-03-15",
    "trackName": "Facebook",
    "artistId": "284882218",
    "artistName": "Facebook, Inc.",
    "price": "0.00",
    "artworkUrl60": "https://is3-ssl.mzstatic.com/image/thumb/Purple118/v4/b3/de/ee/b3deee26-08e1-a6a9-f39f-d50fafd3e019/source/60x60bb.jpg",
    "primaryGenreId": 6005,
    "genreIds": "6005",
    "version": "163.0",
    "description": "Keeping up with friends is faster than ever. \n• See what friends are up to\n• Share updates, photos and video.",
    "screenshotUrls": [
        {
            "url": "https://is1-ssl.mzstatic.com/image/thumb/Purple118/v4/5e/f6/67/5ef66750-59db-567f-ad85-ac62cc24b4bd/source/392x696bb.jpg",
            "hash": "34e3a42e95638064"
        },
        {
            "url": "https://is5-ssl.mzstatic.com/image/thumb/Purple128/v4/a8/d8/f9/a8d8f9c4-a682-666a-6c7c-690592a7e055/source/392x696bb.jpg",
            "hash": "bc9156c61f881d6d"
        }
    ],
    "ipadScreenshotUrls": [
        {
            "url": "https://is2-ssl.mzstatic.com/image/thumb/Purple128/v4/1c/d7/8e/1cd78eab-5b2d-f64c-c645-e2f1b61d40f6/source/576x768bb.jpg",
            "hash": "cf7fe511222d21df"
        },
        {
            "url": "https://is3-ssl.mzstatic.com/image/thumb/Purple128/v4/23/d7/76/23d7762e-ef5b-28f8-74be-938047ab215e/source/552x414bb.jpg",
            "hash": "6fcf9c80666abc8a"
        }
    ],
    "appletvScreenshotUrls": [],
    "sellerUrl": "http://www.facebook.com/mobile",
    "fileSizeBytes": "495288320",
    "supportUrl": "http://www.facebook.com/help/?page=18834",
    "editorialArtworkUrls": {
        "fullscreenBackground": {
            "url": "https://is2-ssl.mzstatic.com/image/thumb/Features127/v4/d6/63/83/d6638388-7259-157a-b8ad-95673ef26297/source/1024x512.png",
            "hash": null
        },
        "originalFlowcaseBrick": {
            "url": "https://is4-ssl.mzstatic.com/image/thumb/Features3/v4/6a/b8/3e/6ab83e21-4191-0f44-60e6-dfbaa611bf5b/source/1024x192.png",
            "hash": null
        },
        "contentLogo": {
            "url": "https://is1-ssl.mzstatic.com/image/thumb/Features122/v4/d9/be/4d/d9be4d7f-9932-ac7f-e09a-b63925138d21/source/1024x166.png",
            "hash": null
        },
        "storeFlowcase": {
            "url": "https://is3-ssl.mzstatic.com/image/thumb/Features118/v4/3d/1f/63/3d1f632c-d862-dd77-017b-c72b8ae4d358/source/1024x256.png",
            "hash": null
        }
    }
}

Developer Apps

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 Reviews

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

Download-Revenue Estimations

Provides download-revenue estimations of an app in AppStore. Max 30 days of history is allowed.

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

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
download Download estimation
revenue Revenue estimation

Example request

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

Example response

{
    "download": 6174985,
    "revenue": 420080
}

Apple Search Ads Services

This section describes Apple Search Ads related services.

Provides paid keywords of SearchAds and their shares for the given app.

GET /searchads-stats/paid-keywords/{trackId}/{countryCode}?date={date}

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, history start date, covers to 7 days prior

Response Fields

Field Description
trackId Appstore track id of the app
shares List of paid keywords and their shares

Example request

curl "http://api.mobileaction.co/searchads-stats/paid-keywords/479516143/US?date=2019-06-13&token=YOUR_API_KEY"

Example response

{
    "trackId": 479516143,
    "shares": [
        {
            "keyword": "platoon",
            "appShare": 100
        },
        {
            "keyword": "flappy golf",
            "appShare": 100
        },
        {
            "keyword": "pokémon",
            "appShare": 100
        },
        {
            "keyword": "duck life",
            "appShare": 100
        },
        {
            "keyword": "rick and morty",
            "appShare": 100
        },
        {
            "keyword": "fnaf free",
            "appShare": 100
        }
    ]
}

Try MobileAction free for a week!

No credit card required.