API access

DeltaWatch provides a comprehensive REST API for full programmatic control over watches, snapshots, notifications, conditions, tags, imports, exports, and workspaces. API access is available on Pulse and Sentinel plans.

Enabling your API key

1. Sign in at app.deltawatch.ing.
2. Navigate to Settings > API.
3. Click Generate API key.
4. Copy and store your key securely — it won’t be shown again.

Authentication

Include your API key in the Authorization header:

Authorization: Bearer your-api-key-here

Endpoint groups

The API is organised into logical groups:

• Watches — create, read, update, delete watches. Manage check intervals, selectors, and configuration.
• Snapshots — retrieve snapshot history and diff data for any watch.
• Notifications — manage notification channels and their configuration.
• Conditions — create and manage alerting conditions.
• Workspaces — manage workspaces, members, and billing.
• Import/Export — trigger imports from changedetection.io or export your data.
• Tags — organise watches with tags.

Interactive documentation

Full interactive OpenAPI documentation is available at:

app.deltawatch.ing/api/docs

You can test endpoints directly from the browser with your API key.

Rate limiting

API requests are rate-limited to protect the service. Current limits:

• 120 requests per minute per API key.
• Rate limit headers are included in every response (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset).

Example: creating a watch

curl -X POST https://app.deltawatch.ing/api/watches \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/pricing",
    "interval": 300,
    "selector": ".pricing-table"
  }'

Need help?

If you run into issues with the API, check the interactive docs first or reach out through the app.