Skip to content

npm API: Get download stats

Returns total and daily or Monday-start weekly npm downloads for a package over the last week, month, or year.

npmjs.com (opens in a new tab)Version 1ReadNo sign-inVerified Nov 2, 2026

Unofficial. Not affiliated with or endorsed by npm.

Inputs

Values from the run on Oct 23, 2026, shown under Output.

Period optionalperiod

The time period, such as last_month.

last_month (default)

One of last_week, last_month, last_year.

Package, requiredpackage

The npm package name, such as express or @types/node.

express

Breakdown optionalbreakdown

Group counts by day or Monday-start week, such as day.

day (default)

One of day, week.

Output

From a run on Oct 23, 2026, shortened for this page.
{  "package": "express",  "end_date": "2026-10-18",  "downloads": [    {      "date": "2026-09-19",      "download_count": 13679155    },    {      "date": "2026-09-20",      "download_count": 13971133    },    {      "date": "2026-09-21",      "download_count": 25107465    }  ],  "start_date": "2026-09-19",  "package_url": "https://www.npmjs.com/package/express",  "total_downloads": 585410126}
Price
1 credit per completed run (1¢ with pay as you go); failed runs are free.
Method
npmjs.com/get_download_stats
Returns
package, package_url, start_date, end_date, total_downloads, downloads by day or week

Use it from your agent

Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method npmjs.com/get_download_stats with the inputs above.

Ask your agent

  • How many times was the express package downloaded last month, broken down by day?
  • Show weekly download totals for @types/node over the past year from npmjs.com
  • What were the npm download counts for lodash last week?
  • I need total downloads for react-dom for the last year, grouped by Monday-start weeks.
  • Get the daily npm download figures for typescript covering last month.
  • Looks up a public npm package by name or npm link. Returns its latest version, weekly downloads, maintainers, links, dates and version count.

    npmjs.com/get_package
  • Searches the npm registry for JavaScript packages by description or keywords, in npm's search order, and returns each package's latest version, weekly downloads and publish date.

    npmjs.com/search_packages
  • Looks up a NuGet package by name or nuget.org link. Inexact names match the top search result. Returns the latest stable release's details and the 10 most recent versions, including prereleases.

    nuget.org/get_package
  • Returns human-reader view counts for a Wikipedia article by day or month, with totals, daily averages and the peak period.

    wikipedia.org/get_page_views
  • Looks up a company by name or ticker on Stock Analysis and returns its annual or quarterly income statement, balance sheet, or cash flow statement for the free periods.

    stockanalysis.com/get_financial_statements
  • Gets a PyPI package's current version, release date, metadata, project links and its 10 most recently published versions from a package name or PyPI link.

    pypi.org/get_package
  • Looks up a Ruby gem on RubyGems by name or gem page link and returns its latest version, release date, description, downloads, authors, license, links and runtime dependencies.

    rubygems.org/get_gem
  • Lists up to 25 public repositories trending on GitHub, in page order, optionally filtered by programming language and time period.

    github.com/list_trending_repositories