npm-package-downloads

Get packages download counts.

Usage no npm install needed!

<script type="module">
  import npmPackageDownloads from 'https://cdn.skypack.dev/npm-package-downloads';
</script>

README

npm-package-downloads

fetch packages download counts.

Install

$ npm i npm-package-downloads --save

Usage

npmPackageDownloads(pkgName(s), period)
  • pkgName{String|Array(String)}: pkg name or array of pkgs name. eg: 'express', ['express', 'koa']
  • period{String}:
    • semantic: 'last-day', 'last-week', 'last-month'
    • specific date: '2016-01-01'
    • specific range: '2016-01-01:2016-01-31'

Example

'use strict';

var npmPackageDownloads = require('npm-package-downloads');

npmPackageDownloads('').catch(function (error) {
  console.log(error.message);
  // npm-package-downloads need a module name or array of names.
});

npmPackageDownloads('express', 'last-month').then(function (res) {
  console.log(res);
  // { downloads: 13359424,
  //   package: 'express',
  //   start: '2017-06-12',
  //   end: '2017-07-11' }
});

npmPackageDownloads([
  'express',// exist
  'ahudsfgikaj',// not exist
  '@shimo/gulp-build',// exist
  '@shimo/gulp-buildhaha'// not exist
], '2016-01-01:2016-01-31').then(function (res) {
  console.log(res);
  // [ { downloads: 0,
  //     start: '2016-01-01',
  //     end: '2016-01-31',
  //     package: '@shimo/gulp-build' },
  //   { package: '@shimo/gulp-buildhaha' },
  //   { downloads: 4686332,
  //     package: 'express',
  //     start: '2016-01-01',
  //     end: '2016-01-31' },
  //   { package: 'ahudsfgikaj' } ]
});

License

MIT