This module provides you to get the user reviews of your iOS app.
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 number
iTunesAppReviews.getReviews('740146917', 'us', 1);
// success
iTunesAppReviews.on('data', function(review) {
console.log(review);
});
// failure
iTunesAppReviews.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 number
iTunesAppReviews.getReviews('740146917', 'us', 1);
// success
iTunesAppReviews.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\nand<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 number
iTunesAppReviews.getReviews('740146917', 'us', 1);
// success
iTunesAppReviews.on('data', function(review) {
iTunesAppReviews.report(review);
});You can customize the template.
// success
iTunesAppReviews.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
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
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