API Documentation

Base URL: https://watch.alldevbox.com/api/v1

Authentication: Bearer token or X-API-Key header.

Authentication

POST/auth/register

{ "email": "you@example.com", "password": "secret" }

Returns: { "token": "...", "user": {...} }

POST/auth/login

{ "email": "you@example.com", "password": "secret" }

Watches

GET/api/v1/watches

List all your watches.

POST/api/v1/watches

{
  "name": "My Homepage",
  "url": "https://example.com",
  "interval_minutes": 60,
  "threshold": 0.1,
  "css_selector": "#content",
  "viewport_width": 1280,
  "viewport_height": 800,
  "notify_webhook": "https://hooks.slack.com/..."
}

Field	Type	Default	Description
name	string	required	Display name
url	string	required	URL to monitor
interval_minutes	int	60	Check frequency (min 5 on Business)
threshold	float	0.1	Min % diff to trigger alert
css_selector	string	null	Wait for this selector before capture
viewport_width	int	1280	Browser viewport width
viewport_height	int	800	Browser viewport height
notify_webhook	string	null	POST webhook on change

GET/api/v1/watches/:id

Get a single watch.

PATCH/api/v1/watches/:id

Update any field.

DELETE/api/v1/watches/:id

Delete a watch and all snapshots.

POST/api/v1/watches/:id/check

Trigger an immediate check. Returns the new snapshot.

Snapshots

GET/api/v1/watches/:id/snapshots?limit=20

Get snapshot history for a watch. Max 100.

GET/api/v1/screenshots/:filename

Download a screenshot or diff image.

API Keys

GET/api/v1/keys

List your API keys.

POST/api/v1/keys

{ "name": "CI Pipeline" }

DELETE/api/v1/keys/:id

Plan Limits

Feature	Free	Pro (£5)	Business (£12)
Watches	3	25	100
Min interval	60 min	15 min	5 min
Webhook alerts	—	✓	✓
CSS selectors	—	✓	✓