Quick Start

Get your first monitor running in under 2 minutes.

1. Get your API key

Sign in to your DiffHook account, go to Settings → API Keys, and generate a key. It will look like dh_live_xxxxxx.

2. Create a monitor

curl -X POST https://www.diffhook.com/api/monitors \
  -H "Authorization: Bearer dh_live_yourkey" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://competitor.com/pricing",
    "webhookUrl": "https://n8n.example.com/webhook/abc123",
    "intervalMinutes": 60,
    "label": "Competitor pricing page"
  }'

Response:

{
  "data": {
    "id": "mon_abc123",
    "status": "active",
    "nextCheckAt": "2026-03-16T15:00:00Z"
  }
}

3. Receive change events

When content changes, DiffHook POSTs to your webhookUrl:

{
  "event": "page.changed",
  "monitor_id": "mon_abc123",
  "url": "https://competitor.com/pricing",
  "triggered_at": "2026-03-16T14:22:00Z",
  "diff": {
    "summary": "Pro plan price changed from $49 to $59",
    "added": ["$59/month"],
    "removed": ["$49/month"]
  }
}

4. Test it manually

You can trigger an immediate check at any time:

curl -X POST https://www.diffhook.com/api/monitors/mon_abc123/trigger \
  -H "Authorization: Bearer dh_live_yourkey"

Next steps

• Scope monitoring — add a cssSelector to ignore nav/footer noise
• Pause when not needed — use /pause and /resume to avoid burning credits
• Verify signatures — authenticate incoming webhooks with the signing secret