Introduction

DiffHook is an API-first web change monitoring platform. Point it at any public URL — competitor pages, regulatory filings, news feeds, job boards — and get notified the moment content changes.

How it works

1. Create a monitor — provide a URL, a webhook destination, and a check interval
2. DiffHook polls your URL on schedule, diffing each snapshot against the last
3. On change detected — a structured page.changed event fires to your configured endpoint

Key concepts

Monitor — A configured URL + interval + destination. Monitors can be active or paused, and triggered on demand at any time.

Webhook event — An HTTP POST to your endpoint containing the diff, monitor metadata, and timestamps.

Base URL

All API requests go to:

https://www.diffhook.com/api/

All endpoints require a valid API key passed as a bearer token. All responses are JSON.

Response format

Success responses wrap the result in a data key:

{
  "data": { "id": "mon_abc123", "status": "active" }
}

Error responses return an error object with a machine-readable code:

{
  "error": {
    "code": "MONITOR_LIMIT",
    "message": "Free tier is limited to 5 monitors"
  }
}