App Reviews API for iOS Apps

---

App Reviews API for Apple App Store iOS Apps from 42matters. Retrieve comprehensive app review data for any iOS app available on Apple App Store.

Definition

Endpoint:

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

Hits per request:

3

Rate limit:

3 QPS

Required plan:

Small or above.

Historical data:

default 30 days (up to 7 years with 'Historical Package')

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 Apple App Store - (e.g for Facebook the ID is 284882215).	Existing App ID on Apple App 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 from this date. To get historical data you need to make separate requests for each month as the allowed range per request is max 30 days. With the Historical data package you can go back up to 7 years.	A valid date in the format yyyy-MM-dd, for example: 2020-05-24	30 days ago
end_date	optional	Get reviews until this date. To get historical data you need to make separate requests for each month as the allowed range per request is max 30 days.	A valid date in the format yyyy-MM-dd, for example: 2020-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.	Maximum 30 days	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_hash, title, rating, lang, content, date, app_version. Please note that author_hash is a hash, whose value might change for the same author and it should not be used to track separate authors or reviews.
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

Reviews for the Facebook app on Apple App Store:

https://data.42matters.com/api/v4.0/ios/apps/reviews.json?id=284882215&access_token=YOUR_ACCESS_TOKEN

---

This request can also be imported into Postman. Check out our Postman integration guide.

Example Response

Last Modified: 22 Feb 2022