Home

Awesome

npm-stats

Convenience module for getting back data from an NPM registry. All of the methods return a JSON stream, and/or take a callback. Where specified, some methods take an optional options object as well.

API

registry = require('npm-stats')([url, options])

Returns a new registry instance, defaulting to isaacs.iriscouch.com.

Options:

registry.list()

Returns an array containing every module currently in the chosen NPM registry.

registry.listByDate(options)

Get a list of each module in the chosen NPM registry, sorted by date last updated, in ascending order.

You can also pass the following options:

Keywords

registry.keyword(name).count()

Get the number of modules using a specific keyword.

registry.keyword(name).list()

Get a list of modules using a specific keyword.

Users

registry.user(name).count()

Get the number of modules a user has authored.

registry.user(name).list()

Get a list of the modules a user has authored.

registry.user(name).starred()

Get a list of the modules a user has starred.

Modules

registry.module(name).info()

Returns the data normally accessible from https://registry.npmjs.org/:pkg.

registry.module(name).version(version)

Returns the data normally accessible from http://registry.npmjs.org/:pkg/:version.

registry.module(name).downloads()

Returns a list of download counts for the module, by date, e.g.:

[
  { "date": "2012-12-10", "value": 64 },
  { "date": "2012-12-11", "value": 82 }
]

Days without a download are omitted. Options:

registry.module(name).stars()

Returns a list of the users who have starred a module.

registry.module(name).dependents()

Returns a list of modules that depend on a module.

registry.module(name).latest()

Returns the latest package.json file for a module.

registry.module(name).field(name, [callback])

Returns a field from the latest package.json file for a module.

registry.module(name).size()

Returns data on the module's size, e.g.

{
  "_id": "browserify",
  "size": 26338241,
  "count": 179,
  "avg": 147141.01117318432
}