README
wpageviews
Simple module which helps to get monthly page views for wikipedia pages belonging to some category and all its subcategories using data from http://stats.grok.se.
Warning: statistics is collected for all subcategories of given
category, so getting data for high-level categories might take long. There is a random delay (500 to 2000 ms) before each request to http://stats.grok.se.
Queries to wikipedia API are also throttled by nodemw
package.
You can get total page views for any period from 1 to 90 days. Note, however, that stats.grok.se returns values either for 30, 60 or 90 days. Data is then sliced to required period. This also means that getting page views for 31 days takes significantly longer than getting page views for 30 days.
Installation
npm install wpageviews --save
Usage
var PageViewsCollector = require('wpageviews')
var pageViewsCollector = new PageViewsCollector({
lang: 'en',
period: 7 //valid values are from 1 to 90
});
pageViewsCollector.getPageViews('Some category')
.then(function(pageViewsArray) {
pageViewsArray.forEach(function(pageViews) {
// Page title
console.log(pageViews.title);
// Array of categories reflecting the path to this page from root category
// Note that these are not the categories of the page
console.log(pageViews.categories.join());
// Total page view for given period
console.log(pageViews.views);
});
});
Tests
npm test