Changes API

Query detected changes.

List Changes

GET /changes

Query Parameters

Parameter	Type	Description
domain_id	string	Filter by domain
severity	string	Filter by severity (critical, high, medium, low)
since	datetime	Changes after this date
limit	integer	Max results (default: 50, max: 100)

Response

{
  "data": [
    {
      "id": "chg_abc123",
      "domain_id": "dom_xyz789",
      "page_url": "/pricing",
      "change_type": "price_change",
      "severity": "high",
      "summary": "Price increased from $99 to $129",
      "detected_at": "2024-01-15T10:30:00Z"
    }
  ],
  "meta": {
    "total": 42,
    "limit": 50,
    "offset": 0
  }
}

Get Change

GET /changes/:id

Response

{
  "data": {
    "id": "chg_abc123",
    "domain_id": "dom_xyz789",
    "page_url": "/pricing",
    "change_type": "price_change",
    "severity": "high",
    "summary": "Price increased from $99 to $129",
    "diff": {
      "before": "Starting at $99/month",
      "after": "Starting at $129/month"
    },
    "snapshot_before_id": "snap_111",
    "snapshot_after_id": "snap_222",
    "detected_at": "2024-01-15T10:30:00Z"
  }
}

Change Types

Type	Description
price_change	Pricing modification
feature_added	New feature listed
feature_removed	Feature removed
terms_update	Legal/terms change
content_change	General content update