v5

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-167122208.0 KB
stats

downloads_count (node.js)

Retrieve the number of times a particular package has been downloaded given a particular criteria. This is specific to a single package inside a repository.

Default date range is 7 days ago.

Everyone for public repositories, Owners & Collaborators for private repositories.

Instead of constructing these URLs by hand, you should use the generated versions returned from any of these API's, which are guaranteed to be correct for all supported package types:

Example request:

/api/v1/repos/julio/test_repo/package/gem/my-gem/1.2.0/stats/downloads/count.json
get/api/v1/repos/{user_id}/{repo}/package/node/{package}/{version}/stats/downloads/count.json

Path parameters

user_idstring required

The user this repo belongs to.

repostring required

The name of this repository.

packagestring required

The name of the package. If the package is a scoped Node.JS package include the scope and an escaped '/' (e.g. @scope%2Fname).

versionstring required

Query parameters

end_datestring

The ISO8601 ending date (e.g., 20160231Z).

master_tokenstring

The master_token name or id to filter downloads by.

read_tokenstring

The read_token name or id to filter downloads by (:master_token required).

sourcestring

The source to filter downloads by, must be "web" or "cli"

start_datestring

The ISO8601 starting date (e.g., 20160231Z).

user_agentstring

The user_agent to filter downloads by.

Response

CountValue JSON object containing the value of the result.

valueinteger

The value of the result

Example response

{
  "value": 12312
}