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/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": 637061,
  "averageUserRating": 2.79935,
  "artworkUrl512": "https://is1-ssl.mzstatic.com/image/thumb/Purple114/v4/b5/01/4c/b5014cc3-b3eb-ddb2-2245-7c6e9f205dd9/source/512x512bb.jpg",
  "artworkUrl100": "https://is1-ssl.mzstatic.com/image/thumb/Purple114/v4/b5/01/4c/b5014cc3-b3eb-ddb2-2245-7c6e9f205dd9/source/100x100bb.jpg",
  "trackViewUrl": "https://apps.apple.com/us/app/facebook/id284882215?uo=4&at=10l9yE",
  "formattedPrice": "Free",
  "start_date": "2020-10-29",
  "reviews": [
    {
      "author_id": "fa433f10fa439bf3ae202016d3a0eb82",
      "title": "Overly censored",
      "rating": 1,
      "lang": "en",
      "content": "Left Facebook due to censoring , only allowing one political view , once voice. Good luck",
      "date": "2020-11-28",
      "app_version": "297.0"
    },
    {
      "author_id": "acb8ecf407e6dc29cb4907e0330ce281",
      "title": "Made a new page and my story option don\u2019t work",
      "rating": 1,
      "lang": "en",
      "content": "I made a new fb page and my story option does not work I cannot post a story this is frustrating. Facebook I need this fixed ASAP! I can only see other people stories but I can\u2019t post a story",
      "date": "2020-11-28",
      "app_version": "297.0"
    },
    {
      "author_id": "8e559d9935200bef2ecc9e4f3db73d0f",
      "title": "HATE THE EXTREME",
      "rating": 1,
      "lang": "en",
      "content": "CENSORSHIP. No free speech allowed.",
      "date": "2020-11-28",
      "app_version": "297.0"
    },
    {
      "author_id": "99e190839e0d3673bd30ec79d481bacd",
      "title": "BANNED!!!!",
      "rating": 1,
      "lang": "en",
      "content": "horrible! Can\u2019t post for 3 days just for commenting on someone\u2019s post!!!! It had no curse words or inappropriate words but according to Facebook it violated community standards!",
      "date": "2020-11-28",
      "app_version": "297.0"
    },
    {
      "author_id": "2d91fb3350692ca69d1fb5b5789d3535",
      "title": "Worst social media platform ever",
      "rating": 1,
      "lang": "en",
      "content": "If you want someone to tell you how to think and feel get a Face Book account. This platform only gives a voice to people who agree with their politics and beliefs. Who died and made them God",
      "date": "2020-11-28",
      "app_version": "297.0"
    },
    {
      "author_id": "cefa2f338065e25dcf869794c014806e",
      "title": "Censoring",
      "rating": 1,
      "lang": "en",
      "content": "Facebook censors the truth and spies on you and collects every bit of data they can smh !!!!!",
      "date": "2020-11-28",
      "app_version": "297.0"
    },
    {
      "author_id": "9bcb21c0863394d981e601e7b8e1c333",
      "title": "Ridiculous censorship",
      "rating": 1,
      "lang": "en",
      "content": "Facebook has become so censored and one sided it\u2019s not as interesting or fun to use as it used to be.",
      "date": "2020-11-28",
      "app_version": "297.0"
    },
    {
      "author_id": "a18bccfdcd2049a72bad2bfdc4e9d440",
      "title": "Censorship is real now.",
      "rating": 1,
      "lang": "en",
      "content": "I Unfortunately can no longer support a social network that censors things it\u2019s our first amendment and it matters a great deal if we are letting this happen. You closed the three percenters page down. And labeled them as a hate group. It\u2019s 50% black And 50% white. A group made to defend our constitution so family\u2019s like mine have a defense from the evils of this world. Facts I\u2019m apart of there beliefs. And I\u2019m sure I am one of many. I thought Facebook would be different.",
      "date": "2020-11-28",
      "app_version": "297.0"
    },
    {
      "author_id": "bc81db2fbe6d59deee9082141e20bad1",
      "title": "Censorship",
      "rating": 1,
      "lang": "en",
      "content": "The Media, FB, IG, and Twitter are the worlds largest terrorist organization.",
      "date": "2020-11-28",
      "app_version": "297.0"
    },
    {
      "author_id": "02315c1915b29a58100118f600606c91",
      "title": "No lo recomiendo es una basura",
      "rating": 1,
      "lang": "es",
      "content": "Es una app asquerosa \nSeg\u00fan ellos ,no nos podemos expresar como nosotros queremos \nTe restrieguen la cuenta por unas palabras insignificantes en pocas palabras una app basura",
      "date": "2020-11-28",
      "app_version": "297.0"
    }
  ],
  "number_reviews": 10,
  "total_reviews": 23470,
  "page": 1,
  "limit": 10,
  "total_pages": 2347
}

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!