App Reviews API for iOS Apps


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:

Small 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": "284882215",
  "trackCensoredName": "Facebook",
  "sellerName": "Facebook, Inc.",
  "userRatingCount": 501051,
  "averageUserRating": 3.06019,
  "artworkUrl512": "https://is1-ssl.mzstatic.com/image/thumb/Purple113/v4/de/a2/37/dea237d1-f2ca-2af8-54a2-cc1b5b8d0ecf/source/512x512bb.jpg",
  "artworkUrl100": "https://is1-ssl.mzstatic.com/image/thumb/Purple113/v4/de/a2/37/dea237d1-f2ca-2af8-54a2-cc1b5b8d0ecf/source/100x100bb.jpg",
  "trackViewUrl": "https://apps.apple.com/us/app/facebook/id284882215?uo=4&at=10l9yE",
  "formattedPrice": "Free",
  "start_date": "2020-06-10",
  "reviews": [
    {
      "author_id": "7ca0662a0c9266ea5b91343ede9762fb",
      "title": "Unfair",
      "rating": 1,
      "lang": "en",
      "content": "Facebook does not allow you to have freedom of speech! They are always censoring people when they speak their minds on certain subjects! They continue to block your post when it\u2019s the TRUTH but continue to promote lies! They steal & share your personal data and information! No child should be using Facebook! \nFacebook asks you \u201cWhat\u2019s on your mind?\u201d But you have choose your words wisely or else they will block you for days/months at a time! You can share the same photo as someone else but they will violate you and block your page for posting the same exact photo you shared from someone else\u2019s page! Facebook has become extremely controlling & it\u2019s no longer useful!!!",
      "date": "2020-07-10",
      "app_version": "276.1"
    },
    {
      "author_id": "2f76bb13e052a3b30ba59ee9d4ec9649",
      "title": "Instantly Banned By Artificial Inteligence",
      "rating": 1,
      "lang": "en",
      "content": "I did nothing wrong just signed up for a new account. My account has been instantly banned. This company is garbage! Facebook is using Artificial Intelligence to manipulate elections and censor free speech while helping the Chinese Communist Party censor free speech in China. Go to Hell Facebook! Soon you will be like MySpace a tumblr weed blowing around in the cyber ghetto of the internet.",
      "date": "2020-07-10",
      "app_version": "276.1"
    },
    {
      "author_id": "f74f7a06ef429ea4b53a12349cb159b2",
      "title": "View more posts like a saved post",
      "rating": 1,
      "lang": "en",
      "content": "Can we go back to the last update... I really liked being able to save memes then seeing \u201cmore like this\u201d and now I can\u2019t \ud83d\ude1e\ud83d\ude1e\ud83d\ude1e",
      "date": "2020-07-10",
      "app_version": "276.1"
    },
    {
      "author_id": "63377a96758b439c51518d3460f720ea",
      "title": "Fix your app",
      "rating": 1,
      "lang": "en",
      "content": "Fix your app only loads 5 things and stops. It never works correctly.",
      "date": "2020-07-10",
      "app_version": "276.1"
    },
    {
      "author_id": "4cd4897755c0b71e78b578f039e48ef8",
      "title": "Doesn\u2019t delete harassing comments about weight",
      "rating": 1,
      "lang": "en",
      "content": "I\u2019ve reported multiple comments made by user that are harassing towards my friend about her weight. Saying she doesn\u2019t take care of herself, doesn\u2019t have healthy habits, and calling her obese. Facebook said his comments are okay and are aligned with their community standards. Can only assume Facebook is fatphobic.",
      "date": "2020-07-10",
      "app_version": "276.1"
    },
    {
      "author_id": "2c5de0865ec301e15a8e01e6a771a347",
      "title": "Does not work",
      "rating": 1,
      "lang": "en",
      "content": "It\u2019s getting worse worse and it\u2019s not working properly and can\u2019t open any ikon here what\u2019s going on with FB",
      "date": "2020-07-10",
      "app_version": "276.1"
    },
    {
      "author_id": "dee7910b6d83cdeb3824ba9bc89f1aea",
      "title": "\ud83d\ude21",
      "rating": 5,
      "lang": "en",
      "content": "stop rating this app 1*",
      "date": "2020-07-10",
      "app_version": "276.1"
    },
    {
      "author_id": "468bb0294bc41f0429e3a3b678d7b53d",
      "title": "Update",
      "rating": 1,
      "lang": "en",
      "content": "The new facebook update is terrible. Trying to work it on my computer is nearly impossible. Very hard to use marketplace and take care of your own listings and I can\u2019t move photos from one album to another. Everything was perfect before the update and now nothing will work. Please fix it",
      "date": "2020-07-10",
      "app_version": "276.1"
    },
    {
      "author_id": "ffe245538fc517fe2d4b5e56440a1f48",
      "title": "eueyeh",
      "rating": 5,
      "lang": null,
      "content": "hshehe",
      "date": "2020-07-10",
      "app_version": "276.1"
    },
    {
      "author_id": "6d1343fbb0d78bd2fd327590eafc6dc5",
      "title": "The app is broken",
      "rating": 1,
      "lang": "en",
      "content": "I had been using Facebook dating since it was released and I deleted my dating profile cause I started dating someone hence I didn\u2019t need the app. Well we broke up and I wanted to use Facebook dating again and it\u2019s nowhere to be found. I\u2019m not the only one with this issue either. It\u2019s pretty upsetting cause it\u2019s actually one of the better dating apps out there and I can\u2019t access it anymore.",
      "date": "2020-07-10",
      "app_version": "276.1"
    }
  ],
  "number_reviews": 10,
  "total_reviews": 7196,
  "page": 1,
  "limit": 10,
  "total_pages": 720
}

Last Modified: 29 Apr 2020


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

Email

Salesforce

Salesforce

HubSpot

HubSpot

Slack

Slack

Intercom

Intercom

Pipedrive

Pipedrive

Zendesk

Zendesk

Gekoboard

Gekoboard

Klipfolio

Klipfolio

Dynamics

Dynamics


And many more!


GET FREE INTEGRATIONS via Zapier!