My-downloads NPM

My Downloads

List download totals and trends for npm packages based on author or keyword.\ Use as a CLI or an in-program API

CLI

args

searchMask

values: see https://github.com/npm/registry/blob/master/docs/REGISTRY-API.md \ e.g. author:<name>, maintainer:<name>, keywords:<keyword>, <generic search term>\

--sort sort order (optional)

values: thisWeek (default), lastWeek, diff (absolute difference versus last week), diff% (percent difference versus last week)

--direction sort direction (optional)

values: down (default), up

Globally

installation

yarn global add my-downloads or\ npm i -g my-downloads

usage examples

downloads author:jed\ (list downloads for packages authored by @jed, default sort is by this week's downloads)

downloads author:jed --sort 'diff%'\ (sorts by percent change since last week)\

downloads author:jed --sort 'diff%' --direction 'up'\ (sorts by percent change since last week, ascending)\

downloads maintainer:angus-c\ (list downloads for packages maintained by @angus-c)

downloads keywords:bundler\ (list downloads for packages with the "bundler" keyword)

downloads pie\ (list downloads related to pie)

Locally

installation

yarn add my-downloads or\ npm i my-downloads

usage example

yarn downloads author:jed or\ npm downloads author:jed

etc.\

API

import downloads from 'my-downloads';
downloads('author:jed', 'diff%', 'up').then({totals, details} => /* your code here */);

return values

totals: the totals for all listed packages\ object with properties pkg (string), thisWeek (number), lastWeek (number), diff (number), diff% (number).

details: the details for all listed packages\ array of objects with properties pkg (string), thisWeek (number), lastWeek (number), diff (number), diff% (number).

Known Issues

Hyphenated author names: The npm registry API doesn't currently process hyphenated author names, so if you're searching for an author with a hyphenated name you'll need to use maintainer: instead.
Scoped packages: The npm registry cannot currently provide download data for scoped packages. Consequently I'm filtering scoped packages from search results.