$ man npm-package-stats
/npm-package-stats
PRICE / CALL
$0.003
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
webprobeCATEGORY
uncategorized
STATUS
● live
NAME
npm-package-stats — fetches the public npm registry record for a package and returns description, license, repository, latest version, total version count, r…
SYNOPSIS
POST https://x402.agentutility.ai/npm-package-stats
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Fetches the public npm registry record for a package and returns description, license, repository, latest version, total version count, recent versions with publish timestamps and deprecation flags, age in days, days since last release, maintainer count + list, and downloads for the last day, week, month, year. The npm registry numbers behind package-risk-npm, just the metrics without the risk write-up. Public npm registry (registry.npmjs.org + api.npmjs.org), commercial use permitted under the npm Public Registry Open Source Terms. Use it for npm package stats, npm registry lookup, npm downloads, package release history, or package metadata.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| package | string | npm package name. Supports scoped names ('@types/node', '@vercel/next'). | required |
| recent_versions | number | How many most-recent version entries to include. 1-20. Default 5. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| package | string | Echo of the requested package name. |
| name | string | Canonical package name as recorded in the npm registry document. |
| description | string | Package description string from the registry document. null if unset. |
| license | string | License identifier (e.g. 'MIT') extracted from the registry document. null if unset. |
| homepage | string | Homepage URL from the registry document. null if unset. |
| repository | string | Repository URL from the registry document. null if unset. |
| keywords | array | Package keywords array from the registry document. |
| latest_version | string | Current 'latest' dist-tag from the registry. |
| total_versions | number | Total number of versions ever published with timestamps in the registry. |
| recent_versions | array | Most-recent N versions, each with version string, published ISO timestamp, and deprecated boolean. |
| first_published | string | ISO timestamp of the earliest version publish. Useful for age math. |
| last_published | string | ISO timestamp of the most recent version publish. |
| age_days | number | Days since the first publish. |
| days_since_last_release | number | Days since the most recent publish — staleness signal. |
| maintainer_count | number | Count of registered maintainers on the package. |
| maintainers | array | First 10 maintainer usernames. |
| downloads | object | Object with last_day, last_week, last_month, last_year integer download counts from api.npmjs.org. Individual fields may be null if the registry returned an error for that window. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/npm-package-stats \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the npm-package-stats tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- web-probenpmpackage-statsdownloadsregistrydependency
- methods
- POST
- cluster
- webprobe
- price
- $0.003 USDC per call
ADJACENT — other endpoints in webprobe
| endpoint | description | price |
|---|---|---|
| crates-io-stats | Fetches the public crates.io API record for a Rust crate and returns description, license, repository, homepage, documentation, keywords,… | $0.003 |
| crypto-news-api | Returns recent cryptocurrency headline metadata and sentiment. | $0.003 |
| homoglyph-check | Detects Unicode lookalike characters that impersonate ASCII Latin letters, a common phishing-domain trick. | $0.003 |
| jwt-decode | Decodes a JWT and inspects its claims without needing the signing key. | $0.003 |
| pypi-package-stats | Fetches the public PyPI JSON record for a Python package and returns summary, license, homepage, repository, documentation, issues URL, a… | $0.003 |
| url-metadata-extract | Extracts page metadata from any URL: title, description, Open Graph and Twitter Card tags, canonical link, and favicon. | $0.003 |
| keyword-suggest | Keyword and autocomplete suggestions for any seed query. | $0.002 |
| arxiv-bibtex | Turns an arXiv paper into a BibTeX entry: pulls title, authors, year, abstract, and DOI from the arXiv API and generates a properly-forma… | $0.005 |
SEE ALSO