API to retrieve total iOS rating from app store?

Question

I can retrieve recent iOS reviews like this:

fetch(`https://itunes.apple.com/${IOS_LANG_CODE}/rss/customerreviews/id=${IOS_ID}/sortBy=mostRecent/json`)
         


        

Answer 1

We (Appfigures) have an API that gives you global ratings for any app, broken down by star and countries over time.

Here's a quick example for getting all of the ratings for an app in the US and China in the last 30 days:

Request:

GET https://api.appfigures.com/v2/reports/ratings?products={product_id}&start=-30&countries=us,cn

Which will give you this response:

{
  "breakdown": [ /* current ratings */
    5860419,
    1431510,
    2802529,
    6458451,
    44737094
  ],
  "new": [ /* new ratings in the range */
    163812,
    52324,
    120262,
    300016,
    2779912
  ],
  "average": "4.35",
  "total": 61290003,
  "new_average": "4.60",
  "new_total": 3416326,
  "positive": 51195545,
  "negative": 7291929,
  "neutral": 2802529,
  "new_positive": 3079928,
  "new_negative": 216136,
  "new_neutral": 120262
}

The overall rating you're looking for would be the total in this result.

You can find the documentation here: https://docs.appfigures.com/api/reference/v2/reports-ratings