App Services

App Detail ( 5 Credits / Request )

Provides detailed information for an app in AppStore.

bash

GET /appstore-appinfo-v2/app/detailed/{trackId}

bash

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

bash

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

Example response

json

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

bash

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

bash

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

Example response

json

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

bash

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

bash

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

json

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

bash

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

bash

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

json

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

bash

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

bash

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

Example response

json

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

bash

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

bash

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

Example response

json

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.

bash

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

bash

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

json

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

bash

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

json

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

bash

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

bash

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

json

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

bash

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

bash

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

Example response

json

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

Featured Apps ( 40 credits / Request )

This endpoint retrieves detailed information about how an application is featured within a specific category on the App Store, including the type of feature, associated imagery, titles, and related applications.

bash

GET /appstore-category-v2/featured-app/{trackId}/{categoryId}

Request Parameters

Parameter	Description
`trackId`	(required) App Store track id of app
`categoryId`	(required) Integer category id
`startDate`	(optional) Start date in YYYY-MM-DD format and default (endDate - 1 day)
`endDate`	(optional) End date in YYYY-MM-DD format and default today
`countryCode`	(optional) 2 letter uppercase country code and default 'All Countries'

Response Fields

Field	Description
`data`	An object containing the requested information.
`trackId`	The track identifier as requested
`categoryId`	The category identifier as requested
`Cards`	An array of objects, each representing a different way in which the app was featured within the category
`date`	The date on which the featuring information is applicable.
`countryCode`	The country for which the featuring information is applicable.
`data`	An object containing more detailed information about the featuring.
`cards`	An array of objects, each representing a specific feature.
`type`	The type of feature, such as "FullImage", "AppList", "Grid", etc.
`label`	A label describing the feature, e.g., "NOW TRENDING".
`title`	The title of the feature, e.g., "Fun today, gone tomorrow".
`name`	The name of the feature, e.g., "This Week’s Best In‑Game Events".
`shortName`	A shorter or alternate name for the feature.
`link`	A link to more information or the featured content itself.
`imageUrl`	The URL to an image associated with the feature.
`apps`	An array of App Store track IDs for the apps included in this feature, sorted to indicate the order of the apps within the list.
`success`	A boolean indicating whether the request was successful.

Example request

bash

curl "https://api.mobileaction.co/appstore-category-v2/featured-app/1482155847/6014?token=YOUR_API_KEY"

Example response

json

{
  "data": {
    "trackId": 1482155847,
    "categoryId": 6014,
    "cards": [
      {
        "date": "2024-02-28",
        "countryCode": "US",
        "data": {
          "cards": [
            {
              "type": "FullImage",
              "label": "NOW TRENDING",
              "title": "Fun today, gone tomorrow",
              "name": "This Week's Best In‑Game Events",
              "shortName": "Sweet rides, clever creatures, and more.",
              "link": "This Week's Best In‑Game Events : App Store Story ",
              "imageUrl": "https://is1-ssl.mzstatic.com/image/thumb/Features112/v4/fc/46/f7/fc46f77d-c777-9531-3b2b-edfe34b433f8/cd4add6c-9077-4a7e-96e3-4caeb2a141a4.png/750x430sr.png",
              "apps": [
                1482155847,
                1333256716,
                1053012308,
                1664335636,
                1517783697,
                964436963,
                638689075,
                1618130846,
                1176027022,
                1534821475,
                805603214,
                6446124916,
                1478394669
              ]
            }
            // ...
          ]
        }
      }
    ]
  },
  "success": true
}

Featuring Analysis ( 20 credits / Request )

This endpoint analyzes the featuring of an application across different App Store categories, such as today, games, and apps, within specified or default date ranges and country codes.

bash

GET /appstore-category-v2/featuring-analysis/{trackId}

Request Parameters

Parameter	Description
`trackId`	(required) App Store track id of app
`startDate`	(optional) Start date in YYYY-MM-DD format and default (endDate - 1 day)
`endDate`	(optional) End date in YYYY-MM-DD format and default today
`countryCode`	(optional) 2 letter uppercase country code and default 'All Countries'

Response Fields

Field	Description
`games`	The number of times the application was featured in the "Games" category on the specified date and country.
`apps`	The number of times the application was featured in the general "Apps" category on the specified date and country.
`kids`	The number of times the application was featured in the "Kids" category on the specified date and country.
`countryCode`	The ISO 3166-1 alpha-2 country code indicates the country for which the analysis data is applicable.

Example request

bash

curl "https://api.mobileaction.co/appstore-category-v2/featuring-analysis/1482155847?token=YOUR_API_KEY"

Example response

json

[
  {
    "today": 0,
    "games": 28,
    "apps": 0,
    "countryCode": "US"
  },
  {
    "today": 0,
    "games": 24,
    "apps": 0,
    "countryCode": "TR"
  }
  // ...
]

App Services ​

App Detail ( 5 Credits / Request ) ​

App Simple Information ( 1 Credit / Request ) ​

App Version List ( 1 Credit / Request ) ​

App Version List Detailed ( 50 Credits / Request ) ​

Developer Apps ( 5 Credits / Request ) ​

App Discovery ( 1 Credit / Request ) ​

App Reviews ( 5 Credits / Request ) ​

App Review Analysis ( 10 Credits / Request ) ​

Download-Revenue Estimations ( 100 Credits / Request ) ​

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

Featured Apps ( 40 credits / Request ) ​

Featuring Analysis ( 20 credits / Request ) ​

App Services

App Detail ( 5 Credits / Request )

App Simple Information ( 1 Credit / Request )

App Version List ( 1 Credit / Request )

App Version List Detailed ( 50 Credits / Request )

Developer Apps ( 5 Credits / Request )

App Discovery ( 1 Credit / Request )

App Reviews ( 5 Credits / Request )

App Review Analysis ( 10 Credits / Request )

Download-Revenue Estimations ( 100 Credits / Request )

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

Featured Apps ( 40 credits / Request )

Featuring Analysis ( 20 credits / Request )