Monitors

Re-check a page on a schedule and get an email or a signed webhook when it changes. Screenshot monitors compare pixels and mark the changes in red; Markdown monitors send a line diff of the text. 1 credit per check, up to 20 monitors per account.

POST/v1/monitors

curl -X POST https://shotlane.dev/v1/monitors -H "X-API-Key: $SHOTLANE_API_KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/pricing","kind":"markdown","interval":"daily"}'

Fields

Field	Default	Description
`url`	—	Page to watch.
`kind`	`screenshot`	`screenshot` (how it looks) or `markdown` (what it says).
`interval`	`daily`	`hourly`, `6h`, `daily` or `weekly`.
`selector`	—	Watch one element only, e.g. `#pricing`.
`threshold`	`1`	Screenshots: percent of pixels that must change before it counts.
`full_page` `width` `wait_for_selector`	—	As on /v1/screenshot. Cookie banners, ads and popups are hidden by default.
`notify_email`	`true`	Email the account address when the page changes.
`webhook_url`	—	https URL for a signed `monitor.changed` event with `snapshot_url` and `diff_url` (webhooks).

Manage monitors

`GET /v1/monitors`	List your monitors.
`GET /v1/monitors/{id}`	One monitor with its recent checks.
`POST /v1/monitors/{id}`	Change `active`, `interval`, `notify_email` or `webhook_url`.
`POST /v1/monitors/{id}/check`	Check now (replaces the next scheduled check).
`DELETE /v1/monitors/{id}`	Remove it.

The first check stores a baseline. A monitor pauses itself when your credits run out and resumes when you top up.

PreviousCrawl NextWebhooks