Global change feed

Material infrastructure changes detected across the catalog, from the recent-observation window (last 24h). Two modes: feed (default, newest first) and sync (pass since and/or cursor - ordered (detected_at, id) ascending with keyset pagination for incremental data pulls).

get/v1/changes

Request

  • Base URL: https://domaindrift.io
  • URL: https://domaindrift.io/v1/changes
  • Auth: API key in header X-DomainDrift-Key

Query parameters

limitinteger

Feed mode caps at 100 (default 20); sync mode caps at 500 (default 100)

domainstring

Filter to a specific domain

typestring

Filter by event type, PREFIX match: type=dns matches every dns.* event (dns.ns.changed, dns.a.added, ...); a full type like dns.ns.changed matches exactly. Prefixes: dns, tls, whois, http, subdomain, content.

sincestring date-time

Sync mode: return changes with detected_at >= this ISO timestamp, ordered (detected_at, id) ascending. Page forward with next_cursor.

cursorstring

Sync mode: opaque keyset cursor (the next_cursor of the previous response). Resumes strictly after the last row of that page.

Response

Recent changes

next_cursorstring nullable

Sync mode only: opaque cursor for the next page, or null when this page is the end. Absent in feed mode.

Example response

{
  "changes": [
    {
      "changes": [
        {
          "type": "dns.ns.changed",
          "field": "dns.ns"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.