npm
Badges for npm packages — version, downloads, license, types, and more.
Display live stats for any npm package.
Available badges
| Badge | Endpoint | Description |
|---|---|---|
| Version | /npm/{package} | Latest version |
| Downloads | /npm/dw/{package}, /npm/dm/{package}, etc. | Download counts |
| License | /npm/license/{package} | Package license |
| Node Version | /npm/node/{package} | Required Node.js version |
| Types | /npm/types/{package} | TypeScript types status |
| Dependents | /npm/dependents/{package} | Dependent package count |
Quick examples
Scoped packages
For scoped packages like @types/react, use the full scope:
Endpoint details
Open focused sandboxes and exact URL shapes for each npm badge type.
Use these sections when you need the exact URL shape or an interactive builder for a specific badge type. Most users only need the table and quick examples above.
npm Dependents
This section covers the npm/dependents badge endpoint.
Show how many other packages depend on this package.
Path Parameters
URL format
/npm/dependents/{package}.svgCopy-paste examples
Default — ecosystem adoption signal
Outline with custom label — social proof for package pages
npm Downloads
This section covers the npm/downloads badge endpoint.
Show weekly, monthly, yearly, or total download counts.
Path Parameters
URL formats
| Period | Endpoint | Example |
|---|---|---|
| Weekly | /npm/dw/{package} | /npm/dw/react |
| Monthly | /npm/dm/{package} | /npm/dm/react |
| Yearly | /npm/dy/{package} | /npm/dy/react |
| Total | /npm/dt/{package} | /npm/dt/react |
| Legacy | /npm/{package}/downloads | /npm/react/downloads |
Copy-paste examples
Default — monthly downloads as a growth signal
Outline — long-term adoption signal
npm License
This section covers the npm/license badge endpoint.
Show the license specified in a package's package.json.
Path Parameters
URL format
/npm/license/{package}.svgCopy-paste examples
Default — license badge for package pages
Ghost — subtle metadata badge for footer rows
npm Node Version
This section covers the npm/node badge endpoint.
Show the Node.js version requirement from a package's engines.node field.
Path Parameters
URL format
/npm/node/{package}.svgCopy-paste examples
Outline — good compatibility badge for libraries
With Node.js logo — branded compatibility badge
Notes
- Returns the
engines.nodevalue from package.json - Shows "any" if no Node version is specified
npm Types
This section covers the npm/types badge endpoint.
Show whether a package includes TypeScript types or has types available via DefinitelyTyped.
Path Parameters
URL format
/npm/types/{package}.svgExamples
Type status values
| Value | Meaning |
|---|---|
bundled | Package includes its own TypeScript definitions |
@types/{pkg} | Types available via DefinitelyTyped |
none | No TypeScript types available |
Copy-paste examples
Blue theme — highlights TS support clearly
Branded with TypeScript logo — strong developer experience signal
npm Version
This section covers the npm/version badge endpoint.
Show the current published version of a package.
Path Parameters
Unscoped (react) or scoped (@types/react).
URL formats
/npm/{package}.svg/npm/v/{package}.svg/npm/v/{package}/{tag}.svgCopy-paste examples
Default — clean version badge for READMEs
Branded — npm's official red
Scoped package — secondary variant
Data source
- Version, license, types, node: registry.npmjs.org
- Downloads: api.npmjs.org
No API key required. Cached 1 hour.