Monitors

Watch a page, a sitemap or an extraction on a schedule and get a webhook when it changes

AI agent instructions

Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

A monitor checks a target on a schedule and records a change when the result differs from what it saw before. Add a webhook to be notified.

Try it in the Console

Try this API in the playground, no code needed.

​

Quick start

curl -X POST https://api.notte.cc/data/monitors \
  -H "Authorization: Bearer $NOTTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Pricing page",
    "target": {"type": "page", "url": "https://example.com/pricing"},
    "schedule": {"type": "interval", "frequency": 1, "unit": "days"},
    "change_detection": {"type": "exact"},
    "webhook": {"url": "https://your-app.com/hooks/notte", "events": ["change.detected"]}
  }'

{
  "id": "mon_d6d9873bc88a4df19d0ddd1c576fd27a",
  "name": "Pricing page",
  "status": "active",
  "next_run_at": "2026-11-12T12:47:27Z",
  "initial_run_id": "run_e7853515005345c08e9f9fd7aa98971e",
  "webhook": {
    "url": "https://your-app.com/hooks/notte",
    "events": ["change.detected"],
    "secret": "whsec_..."
  }
}

Creating a monitor runs it once right away to record a baseline. Save the webhook secret.

​

Create a monitor

name · string · required

A label for the monitor.

target · object · required

What to watch. Pick a type:

type	What it watches	Fields
page	One page	url, instructions, include_selectors, exclude_selectors, actions (up to 5), normalize_whitespace (default true)
sitemap	The list of URLs in a sitemap	url, include, exclude, max_urls (default 5000)
extract	Data extracted from one or more pages	url, instructions (required), schema, max_pages (default 10), max_depth, follow_subdomains (default false)

A page target’s actions run before each check, in order. Each one is one of:

• {"do": "wait", "timeMs": 1000}
• {"do": "scroll", "direction": "down", "amount": "viewport", "maxScrolls": 3}
• {"do": "perform", "action": "click the Load more button"}

schedule · object · required

{"type": "interval", "frequency": 1, "unit": "days"}. unit is minutes, hours or days.

change_detection · object

How changes are decided:

• {"type": "exact"}: any difference counts.
• {"type": "semantic", "confidence_threshold": 0.75}: only meaningful differences count.

webhook · object

url, events (change.detected, run.completed) and optional retry with delays_seconds, for example [10, 60, 300].

tags · string[]

Free-form labels.

​

Manage monitors

Action	Request
List	GET /data/monitors
Get	GET /data/monitors/{monitor_id}
Update	PATCH /data/monitors/{monitor_id}
Delete	DELETE /data/monitors/{monitor_id}
Run now	POST /data/monitors/{monitor_id}/run
Check your limit	GET /data/monitors/limits
Check credit usage	GET /data/monitors/credit-usage

PATCH accepts the same fields as create, plus status: active or paused.

POST .../run returns 202 with the run_id.

​

Runs and changes

Every check is a run. A run that finds a difference also creates a change.

Action	Request
Runs of a monitor	GET /data/monitors/{monitor_id}/runs
One run	GET /data/monitors/{monitor_id}/runs/{run_id}
Changes of a monitor	GET /data/monitors/{monitor_id}/changes
One change	GET /data/monitors/{monitor_id}/changes/{change_id}
Runs across all monitors	GET /data/monitors/runs
Changes across all monitors	GET /data/monitors/changes

A run looks like this:

{
  "id": "run_2e5eaa50d8ed4d4a95dcfe5bbed36964",
  "monitor_id": "mon_d6d9873bc88a4df19d0ddd1c576fd27a",
  "status": "completed",
  "run_type": "scheduled",
  "change_detected": false,
  "change_id": null,
  "webhook_delivery_ids": []
}

run_type is baseline for the first run and scheduled for the others.

​

Webhooks

When a monitor has a webhook, Notte sends a delivery to your url for each event you subscribed to.

• change.detected: a run found a change.
• run.completed: a run finished.

Check what happened to a delivery:

Action	Request
List deliveries	POST /data/webhooks/deliveries
One delivery	GET /data/webhooks/deliveries/{delivery_id}
Delivery attempts	GET /data/webhooks/deliveries/{delivery_id}/attempts
Retry a delivery	POST /data/webhooks/deliveries/{delivery_id}/retry

A delivery’s status is pending, delivering, retrying, delivered, failed or cancelled.

The list request needs "type": "monitor". Add any of monitor_id, run_id, status, created_after, limit (default 25, max 100) and cursor to filter and page:

curl -X POST https://api.notte.cc/data/webhooks/deliveries \
  -H "Authorization: Bearer $NOTTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "monitor", "monitor_id": "mon_d6d9873bc88a4df19d0ddd1c576fd27a", "status": "failed"}'

Rotate a webhook secret with POST /data/monitors/{monitor_id}/webhook/rotate-secret.