npm

List npm registry changes

List npm registry changes from a sequence cursor, with deleted-document markers.

GET/v1/npm/registry/changes
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
sinceintegerquery

Start after this sequence. Omit it or use `0` for the oldest changes. No call returns the current sequence: for recent changes pass one such as `141000000`, then your stored `lastSeq`. Not with `cursor`.

≥ 0

limitintegerquery

Changes per page, 1 to 1000. Default: 100.

≥ 1 · ≤ 1000

cursorstringquery

Cursor from `page.nextCursor` of the previous response. It only continues the same lookup and filters.

min 1 chars · max 2048 chars

Response fields
16

Endpoint-specific response payload.

A page of changes.

datachanges[]seq
integer

Registry sequence number.

≥ 0

datachanges[]name
string

Package name the change is about.

datachanges[]deleted
boolean

True when the package was removed from the registry at this change; a later change may bring a package of that name back.

datalastSeq
integernullable

The registry sequence at the end of this page.

≥ 0

Pagination state for this page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Opaque cursor for the next request; null on the last page.

datapagepage
integeroptional

The 1-based page number of this response, when numbered.

≥ 0

datapageperPage
integeroptional

Rows per page, when fixed.

≥ 0

datapagetotal
integernullableoptional

Total rows, or null when npm does not publish one.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/npm/registry/changes?since=141000000&limit=100" \
  -H "x-api-key: YOUR_API_KEY"

Responses

npm changes.