iTunes App Reviews
This module provides you to get the user reviews of your iOS app.
Usuage
The getReviews()
function returns the reviews of your app.
app id
{string} your app ID on iTunes (Required)country
{string} two strings country name such as "us", "ch", "it" and "jp"limit page number
{number} normally the iTunes API returns 50 items per 1 page
var ItunesAppReviews = require('itunes-app-reviews');var iTunesAppReviews = new ItunesAppReviews(); // your app ID, country, limit page numberiTunesAppReviews.getReviews('740146917', 'us', 1); // successiTunesAppReviews.on('data', function(review) { console.log(review);}); // failureiTunesAppReviews.on('error', function(err) { console.log(err);});
Notice: Sometimes iTunes API returns no data.
You're able to filter the reviews by date or the app version with the filterByDate()
and the filterByVersion()
functions.
var ItunesAppReviews = require('itunes-app-reviews');var iTunesAppReviews = new ItunesAppReviews(); // Your App ID, country, limit page numberiTunesAppReviews.getReviews('740146917', 'us', 1); // successiTunesAppReviews.on('data', function(review) { console.log(iTunesAppReviews.filterByDate(review, '2015-01-27')); console.log(iTunesAppReviews.filterByVersion(review, '1.1.3'));});
Notice: You might not be able to get any items, if the older date or version was selected. The iTunes API has only 500 items.
To report user reviews, use the report()
function.
data
{array} review data (Required)options
{object} optional objectseparator
{string} break word string like\n
and<br>
day
{string} day string added to headertemplate.header
{string} template stringtemplate.entry
{string} template string
var ItunesAppReviews = require('itunes-app-reviews');var iTunesAppReviews = new ItunesAppReviews(); // Your App ID, country, limit page numberiTunesAppReviews.getReviews('740146917', 'us', 1); // successiTunesAppReviews.on('data', function(review) { iTunesAppReviews.report(review);});
You can customize the template.
// successiTunesAppReviews.on('data', function(review) { var options = { template: { header: '{title} total: {summary.total}{separator}', entry: '{entry.rating.icon} by {entry.author}{separator}' } }; console.log(iTunesAppReviews.report(review, options));});
returns:
iTunes Review Report total: 50
★★★ by Andrew
header
Default template:
{title} {day}{separator}
total:{summary.total} avg:{summary.average}{separator}
{icon.s1} {summary.rating.s1} {icon.s2} {summary.rating.s2} {icon.s3} {summary.rating.s3} {icon.s4} {summary.rating.s4} {icon.s5} {summary.rating.s5}{separator}
{separator}
Output:
iTunes Review Report 2015-01-27
total:50 avg:3.92
★ 3 ★★ 6 ★★★ 8 ★★★★ 8 ★★★★★ 25
entry
Default template:
{entry.title} by {entry.author}{separator}
{entry.rating.icon}{separator}
{entry.comment}{separator}
{entry.updated} {entry.version}{separator}
{separator}
Output:
Great by Huntershdgj
★★★★★
I love it great wonderful app
2015-01-27 7:59:00 AM v1.1.3
Totally awesome! by catshive
★★★★★
Fixes shakes in my videos so well!
2015-01-26 4:34:00 AM v1.1.3