{"uid":"cap_zevrDhc6AkoIJBL5tgLWc","slug":"npm-package-cdn-rank-lookup-3270b3fc","name":"NPM Package CDN Rank Lookup","description":"Real browser-side adoption signal from the official jsDelivr Stats API: global CDN hit rank, rank within npm, total hits over the period, previous-period comparison and a derived trend (up/down/flat, lower rank = more popular). Query: ?pkg=react&period=week (period: day, week, month, year). Complements npm download counts; cached 6h.","url":"https://data.greeneris.io/v1/npm/cdn-rank","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["pkg"],"properties":{"pkg":{"type":"string","description":"npm package name, e.g. react or @angular/core"},"period":{"enum":["day","week","month","year"],"type":"string","default":"week","description":"Stats window"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"rank":130,"trend":"down","period":"week","source":"jsDelivr CDN stats (data.jsdelivr.com)","package":"react","prev_rank":127,"type_rank":106,"total_hits":68480875,"prev_total_hits":70187760}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YOiw95P1RhH5qwlpa5X-q","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the CDN delivery rank and download hit count for an npm package based on jsDelivr CDN statistics, with trend direction over a configurable time window.","exampleAgentPrompt":"What's the current weekly CDN rank for the 'react' npm package on jsDelivr — is it trending up or down compared to last week?","exampleUseCases":null,"resultDescription":"A JSON object containing the package's current CDN rank, previous rank, trend direction (up/down/stable), total CDN hits for the period, previous period's hits, type-specific rank, the time period queried, and the data source (jsDelivr).","failureModes":["Unknown or misspelled package name returns empty or error response","Package has no CDN traffic and may not appear in rankings","Invalid period enum value causes request rejection","Network timeout if jsDelivr upstream data is temporarily unavailable"],"whenToPreferThis":"Use this endpoint when you need to assess the relative popularity or CDN adoption of a specific npm package using jsDelivr delivery statistics. Ideal for comparing library traction, monitoring if a package is gaining or losing momentum, or making dependency decisions based on community adoption signals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:34:06.350Z","isFirstParty":false}