App Reviews API


Get app reviews data for an iOS app available on Apple App Store.

Definition

Endpoint:

GET https://data.42matters.com/api/v2.0/ios/apps/reviews.json

Hits per request:

3

Rate limit:

5 QPS

Required plan:

basic or above.

Parameters

Name Required Description Available Values Default
access_token required Your access token for using this API. You can get it for FREE by signing up .
id required The app ID on the iTunes store - (e.g for Facebook the ID is 284882215). Existing App ID on iTunes Store
rating optional Filter reviews with a specific rating value. A valid integer number in the range 1 to 5, for example: 4
start_date optional Get reviews newer than this date. A valid date in the format yyyy-MM-dd, for example: 2016-05-24
end_date optional Get reviews older than this date. A valid date in the format yyyy-MM-dd, for example: 2016-05-30
days optional Set the date range from yesterday to the specified number of days in the past. This field overwrites start_date and end_date. 1-30 30 (if no start_date and end_date)
lang optional Return language-specific reviews. ID of Supported Languages
limit optional Number of reviews to return. 1-100 10
page optional Page based on the limit parameter, used for pagination. 1 - max pages. 1
callback optional If supplied, the response will use the JSONP format with a callback of the given name.

Responses

Status Code Indication Content-Type Body
200 Everything is OK application/json
Attribute Type Description
trackId String Numeric unique identifier for the app assigned by Apple
trackCensoredName String App title
sellerName String Seller company name (developer name)
userRatingCount Integer Number of ratings of the app for all versions
averageUserRating Double The average rating of the app for all versions (from 0 to 5, 5 highest)
artworkUrl512 URL Icon image with 512px square sizes
artworkUrl100 URL Icon image with 100px square sizes
formattedPrice String Price and currency of the app
trackViewUrl URL Link to the app on the Apple App Store
start_date Date A date in the format: yyyy-MM-dd
end_date Date A date in the format: yyyy-MM-dd
number_reviews Integer Number of reviews returned
total_reviews Integer Number of reviews available based on query/filters used
page Integer Current page
limit Integer Maximum number of reviews per page.
total_pages Integer Number of pages available based on "limit" parameter.
reviews Array of Objects Sorted list of reviews objects in the response. Each reviews contains: author_id, title, rating, lang, content, date, app_version.
404 The track id/bundle id is not found application/json Error object
402 Your request exceeds what's allowed by your current subscription plan application/json Error object
403 Your access token is not valid application/json Error object
429 Your request rate is over the limit application/json Error object

Example Request

Example Response

{
	"trackId": "343200656",
	"trackCensoredName": "Angry Birds",
	"sellerName": "Rovio Entertainment Ltd",
	"userRatingCount": 824543,
	"averageUserRating": 4.5,
	"artworkUrl512": "http://is4.mzstatic.com/image/thumb/Purple128/v4/87/25/8b/87258bd2-8628-0f2c-47bb-c5e914e97444/source/512x512bb.jpg",
	"artworkUrl100": "http://is4.mzstatic.com/image/thumb/Purple128/v4/87/25/8b/87258bd2-8628-0f2c-47bb-c5e914e97444/source/100x100bb.jpg",
	"trackViewUrl": "http://itunes.apple.com/app/angry-birds/id343200656?uo=5",
	"formattedPrice": "Free",
	"start_date": "2017-10-19",
	"reviews": [
		{
			"author_id": "3a77333e15c568b848c437b48fbd52f9",
			"title": "\uac8c\uc784\uc740 \uc7ac\ubc0c\ub294\ub370",
			"rating": 5,
			"lang": "ko",
			"content": "\uc800\uc7a5\uc6a9\ub7c9\ub54c\ubb38\uc5d0 \ub2e4\uc6b4\ub85c\ub4dc \uae30\ub85d\uc880 \uc0ad\uc81c\ud574\uc8fc\uc138\uc694",
			"date": "2017-11-16",
			"app_version": "7.7.7"
		},
		{
			"author_id": "0ed25d2ddcb5a4c7824372fea7520dc9",
			"title": "Buggy",
			"rating": 1,
			"lang": "en",
			"content": "I had previously given this app 5 stars. But the latest update has *not* fixed this festering bug:\n\nAt times even if you\u2019ve surpassed the score to beat the level doesn\u2019t end on its own. So you wait. When you\u2019re tired of waiting, you force quit the app, play the level again, using up a ticket and maybe a power up. However, this \u201csolution\u201d doesn\u2019t seem to work. So you reset your phone and play the level anew. Alas, resetting the phone doesn\u2019t work, either. So you wind up using another ticket. Rinse. Repeat. Rinse. Repeat. Ad infinitum.\n\nPlease fix!\n\nI will reconsider my rating once and update is pushed to fix this issue. Based on the reviews posted thus far I note that I\u2019m not the only user of this app to experience and raise this issue.",
			"date": "2017-11-16",
			"app_version": "7.7.7"
		},
		{
			"author_id": "af6b31291a4b3d62ba89a3562d2610e9",
			"title": "Good",
			"rating": 3,
			"lang": "en",
			"content": "Not amazing but could get rid of the adds as mire people would play then",
			"date": "2017-11-16",
			"app_version": "7.7.7"
		},
		{
			"author_id": "e67184f3f335d0b1b4724929fc577b3f",
			"title": "Hours of fun!",
			"rating": 5,
			"lang": "en",
			"content": "I could play this game forever. So many great levels and stories",
			"date": "2017-11-16",
			"app_version": "7.7.5"
		},
		{
			"author_id": "a8ec0c76de459ec9dab6f82765753f1a",
			"title": "It was a fun game",
			"rating": 1,
			"lang": "en",
			"content": "This was one of my favorite games out now all it does is crash all the time don\u2019t waste your money or time on this game they won\u2019t fix it!!!!!!! And you pay for a game not to get ads and then they still put on ads after you pay BS",
			"date": "2017-11-16",
			"app_version": "7.7.7"
		},
		{
			"author_id": "ee32b179a7d809d8a5540345794be7a1",
			"title": "Abst\u00fcrze",
			"rating": 3,
			"lang": "de",
			"content": "Obwohl es ein tolles Spiel ist, muss ich laut sagen, dass der Spass auf Grund der App-Start-Abst\u00fcrze massiv leidet! Pro Spielversuch 3 Abst\u00fcrze!",
			"date": "2017-11-16",
			"app_version": "7.7.7"
		},
		{
			"author_id": "e5f9aedde502c04e787a95af58071276",
			"title": "\u0412\u044b\u043b\u0435\u0442\u0430\u0435\u0442",
			"rating": 4,
			"lang": "ru",
			"content": "\u0412\u043e \u0432\u0440\u0435\u043c\u044f \u0438\u0433\u0440\u044b \u0432\u044b\u043b\u0435\u0442\u0430\u0435\u0442 \u0432\u0441\u0435 \u0432\u0440\u0435\u043c\u044f \u043d\u0435 \u043f\u043e\u0439\u043c\u0443 \u0432 \u0447\u0435\u043c \u043f\u0440\u043e\u0431\u043b\u0435\u043c\u0430",
			"date": "2017-11-16",
			"app_version": "7.7.7"
		},
		{
			"author_id": "bcc7d927244b9d9b357fd229822b58a8",
			"title": "Enough",
			"rating": 1,
			"lang": "en",
			"content": "I havnt played these games in a while. I paid for the full version and now I'm swamped with adds. I'll never pay another dime to rovio.",
			"date": "2017-11-14",
			"app_version": "7.4.0"
		},
		{
			"author_id": "84193b62ef0674ad0a93d997a1459787",
			"title": "Game",
			"rating": 1,
			"lang": "en",
			"content": "This game used to be real fun now it\u2019s nothing but advertisements do not download and if you have the game now on install it.",
			"date": "2017-11-14",
			"app_version": "7.7.7"
		},
		{
			"author_id": "a2e02a30f525ae21c2ed94bca03151f2",
			"title": "...",
			"rating": 4,
			"lang": "en",
			"content": "Good game ruined with power-ups... stages have been modded like that you have to buy these power-ups or there is no way to 3 star the stage",
			"date": "2017-11-14",
			"app_version": "7.7.7"
		}
	],
	"number_reviews": 10,
	"total_reviews": 107,
	"page": 1,
	"limit": 10,
	"total_pages": 11
}

Last Modified: 2017-10-30


Get Free Support


We offer free email support to all our customers, with the 42matters team glad to provide you prompt, professional support. We’re here to help.


CONTACT US