App Reviews API


Get app reviews data for an iOS app available on Apple App Store. 42matters makes best effort for collecting the available reviews and does not guarantee full coverage. Largest coverage have reviews in English.

Definition

Endpoint:

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

Hits per request:

3

Rate limit:

3 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": "AB Classic",
	"sellerName": "Rovio Entertainment Oyj",
	"userRatingCount": 826146,
	"averageUserRating": 4.5,
	"artworkUrl512": "https://is2-ssl.mzstatic.com/image/thumb/Purple128/v4/ee/76/b4/ee76b4f3-90ef-26d9-8ca3-d7ab57460e3e/source/512x512bb.jpg",
	"artworkUrl100": "https://is2-ssl.mzstatic.com/image/thumb/Purple128/v4/ee/76/b4/ee76b4f3-90ef-26d9-8ca3-d7ab57460e3e/source/100x100bb.jpg",
	"trackViewUrl": "https://itunes.apple.com/us/app/ab-classic/id343200656?mt=8&uo=4",
	"formattedPrice": "Free",
	"start_date": "2018-10-20",
	"reviews": [
		{
			"author_id": "5cedece00acd5584b1058e598aa044eb",
			"title": "Frustrated",
			"rating": 3,
			"lang": "en",
			"content": "For close to 2 weeks now, the mighty league won\u2019t load. Getting  \u201cno internet connection\u201d when I try. \nI have uninstalled, reinstalled several times. \nChecked all settings on my phone and iPad Pro. Nothing helps. The it\u2019s ONLY the mighty league. \nI\u2019m using iPhone XS Max, on iOS 12. \nMy iPad is pro running iOS 12, as well! Will you please look into this glitch? I would like to think it was just something simple with my devices but for it to be an issue on both, is telling me it\u2019s not my devices. \nThank you",
			"date": "2018-11-19",
			"app_version": "7.9.8"
		},
		{
			"author_id": "364bb01e6ba24f6d84380aefb4bdc910",
			"title": "Crash course",
			"rating": 1,
			"lang": "en",
			"content": "This app is clearly now well supported anymore. It crashes 95% of the time.",
			"date": "2018-11-19",
			"app_version": "7.9.8"
		},
		{
			"author_id": "40b69a719989ea16abdac857be8fcd5d",
			"title": "No iPhone X+ support",
			"rating": 1,
			"lang": "en",
			"content": "Game lacks support for iPhone X, XS, XS Max, and XR.",
			"date": "2018-11-19",
			"app_version": "7.9.8"
		},
		{
			"author_id": "3d92d0268f4ba2b81709e24f8263f9df",
			"title": "Yet another update...with more glitches",
			"rating": 1,
			"lang": "en",
			"content": "Previous version froze occasionally during play. This version can\u2019t even open Mighty League. Shuts down every time. Great update guys!",
			"date": "2018-11-19",
			"app_version": "7.9.8"
		},
		{
			"author_id": "1e9cde26cee39091355d22ebdcd153e8",
			"title": "Crashed",
			"rating": 1,
			"lang": "en",
			"content": "For the past 4 weeks the game has crashed\n\nI\u2019ve deleted and downloaded it again, but still not working \ud83e\udd2c\ud83e\udd2c\ud83e\udd2c",
			"date": "2018-11-18",
			"app_version": "7.9.8"
		},
		{
			"author_id": "e38e69704a4e8c926e9495d93ae20f5c",
			"title": "Angry birds",
			"rating": 4,
			"lang": "en",
			"content": "Very good for babies who always watch there older brother or sister playing a game and they want to play\ud83d\udc68\u200d\ud83d\udc69\u200d\ud83d\udc67\u200d\ud83d\udc66\ud83d\udc7c\ud83c\udffb.",
			"date": "2018-11-18",
			"app_version": "7.9.8"
		},
		{
			"author_id": "c0abb745e47adc0278a3aa2256349a4f",
			"title": "it\u2019s ehh",
			"rating": 1,
			"lang": "en",
			"content": "The game is fine, I mean it\u2019s been out for so long, but I don\u2019t like it anymore. When you first open the app there is no clear way to start playing. Also, to be able to move onto the next level you have to pay with the game currency (little stars) even if you get a high enough score. Unless I\u2019m really missing something, the game isn\u2019t fun anymore.",
			"date": "2018-11-17",
			"app_version": "7.9.8"
		},
		{
			"author_id": "2984499fdafdf5af833cd64d6158a894",
			"title": "Not working",
			"rating": 1,
			"lang": "en",
			"content": "I used to love this game- and I still do when it works. Unfortunately every time they update it, it freezes. Can\u2019t do anything",
			"date": "2018-11-17",
			"app_version": "7.9.8"
		},
		{
			"author_id": "5ebed14a13fa71127abf9388500ba6cd",
			"title": "Gone to Poo",
			"rating": 2,
			"lang": "en",
			"content": "Continually freezes and have lost to upgrades which were paid for but never came up, then do an update and now can\u2019t access",
			"date": "2018-11-17",
			"app_version": "7.9.8"
		},
		{
			"author_id": "58e2aae2793d999c22ec15a9f4e359d8",
			"title": "Problem after problem",
			"rating": 1,
			"lang": "en",
			"content": "I can\u2019t open Mighty League. Just says can\u2019t connect to internet, but everything else works. This game has gone consistently down hill over the last year or so. Game freezing which costs me points and then I drop back levels. So frustrating. Please fix the issue and fix future issues immediately. I\u2019m sure your able to see problems at your end quicker than it hits the players and without the players, there\u2019s no game...",
			"date": "2018-11-17",
			"app_version": "7.9.8"
		}
	],
	"number_reviews": 10,
	"total_reviews": 259,
	"page": 1,
	"limit": 10,
	"total_pages": 26
}

Last Modified: 2018-11-11


Automate your workflow


Bring app data into your existing workflow, dashboards, CRM, messaging platforms and many more services! Here a selection of third-party services we support:



Email

Salesforce

HubSpot

Slack

Intercom

Pipedrive

Zendesk

Gekoboard

Klipfolio

Dynamics


And many more!


GET FREE INTEGRATIONS via Zapier!