{"uid":"cap_kgI6ZRLeLVQuyRp70PUYG","slug":"package-health-npm-downloads-popularity-3fb92d0f","name":"Package Health – npm Downloads & Popularity","description":"npm package adoption: downloads last week and month, plus trend within the month and a popularity band.","url":"https://package-health.x402tookit.com/npm-downloads?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"npm package name, e.g. express or @types/node"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"band":{"type":["null","string"]},"name":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"lastWeek":{"type":["null","number"]},"lastMonth":{"type":["null","number"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"thresholds":{"type":["null","object"],"properties":{"lowWeekly":{"type":["null","number"]},"popularWeekly":{"type":["null","number"]},"moderateWeekly":{"type":["null","number"]},"veryPopularWeekly":{"type":["null","number"]}}},"trendWithinMonthPct":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tBEBISOMWZ3e1JX78F7Hs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns last-week and last-month npm download counts, intra-month trend percentage, and a popularity band for a given npm package.","exampleAgentPrompt":"How popular is the `zod` npm package right now — can you check its weekly and monthly download counts and tell me what popularity band it falls into?","exampleUseCases":[{"title":"Vetting a new dependency","prompt":"Before I add `fastify` to our project, can you check how many downloads it gets per week and month on npm, and whether it's trending up or down within the month?"},{"title":"Comparing library adoption","prompt":"I'm deciding between `joi` and `zod` for schema validation — can you look up the npm download counts and popularity bands for both so I can see which one is more widely adopted?"},{"title":"Package health dashboard automation","prompt":"For our internal report, pull the npm download stats and popularity band for `webpack` — I need last week's count, last month's count, and the trend percentage within the month."}],"resultDescription":"A JSON object with the package name, last-week download count, last-month download count, intra-month trend percentage, a popularity band (e.g. low/moderate/popular/very-popular), a human-readable verdict and summary, supporting reasons, download thresholds used for banding, the data source URL, an asOf timestamp, and optional degraded/disclaimer flags.","failureModes":["Unknown or misspelled package name returns null fields or an error verdict","npm registry API unavailability causes a degraded response with partial data","Scoped packages (e.g. @types/node) must include the full scoped name or the lookup fails","Very new packages with no download history may return zero counts and a low band by default","Rate limiting or upstream npm stats lag may result in stale or missing asOf timestamps"],"whenToPreferThis":"Choose this endpoint when you need quantitative npm adoption signals — download counts and trend direction — for a single package. It is purpose-built for npm and returns a structured popularity band alongside raw counts, making it ideal for dependency vetting, supply-chain analysis, or populating package health dashboards. Prefer it over generic web search when you need machine-readable, normalized popularity data rather than prose descriptions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T02:25:51.125Z","isFirstParty":false,"canonicalSlug":"package-health-npm-downloads-popularity-3fb92d0f"}