Monitors

Body parameters

Send at most one of selector, selectors and schema. The first check runs right away and sets the baseline; later checks compare against the last content seen.

Create a monitor

curl -X POST https://api.104-236-84-15.sslip.io/v1/monitors \
  -H "Authorization: Bearer $PAGETEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/pricing","name":"Competitor pricing","interval":"daily","mode":"http","selector":"#plans","ignore":["Updated * ago"],"webhook":{"url":"https://your-app.example.com/hooks/pageteer"}}'

const res = await fetch('https://api.104-236-84-15.sslip.io/v1/monitors', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PAGETEER_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "url": "https://example.com/pricing",
    "name": "Competitor pricing",
    "interval": "daily",
    "mode": "http",
    "selector": "#plans",
    "ignore": [
      "Updated * ago"
    ],
    "webhook": {
      "url": "https://your-app.example.com/hooks/pageteer"
    }
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.message);
console.log(data, res.headers.get('x-credits-remaining'));

import os
import requests

headers = {"Authorization": f"Bearer {os.environ['PAGETEER_API_KEY']}"}
res = requests.post(
    "https://api.104-236-84-15.sslip.io/v1/monitors",
    headers=headers,
    json={
        "url": "https://example.com/pricing",
        "name": "Competitor pricing",
        "interval": "daily",
        "mode": "http",
        "selector": "#plans",
        "ignore": ["Updated * ago"],
        "webhook": {
            "url": "https://your-app.example.com/hooks/pageteer",
        },
    },
    timeout=120,
)
res.raise_for_status()
print(res.json(), res.headers["x-credits-remaining"])

{
  "id": "mon_6b1f3c2a9e4d5f6a7b8c9d0e",
  "name": "Competitor pricing",
  "url": "https://example.com/pricing",
  "interval": "daily",
  "status": "active",
  "paused_reason": null,
  "compare": "text",
  "selector": "#plans",
  "ignore": ["Updated * ago"],
  "webhook": { "url": "https://your-app.example.com/hooks/pageteer", "events": ["monitor.changed", "monitor.paused"] },
  "next_check_at": "2026-10-27T12:00:00.000Z",
  "last_checked_at": null,
  "checks": 0,
  "changes": 0,
  "credits_used": 0,
  "webhook_secret": "whsec_5f0c…"
}

Change history

curl "https://api.104-236-84-15.sslip.io/v1/monitors/mon_6b1f3c2a9e4d5f6a7b8c9d0e/changes?limit=1" \
  -H "Authorization: Bearer $PAGETEER_API_KEY"

const res = await fetch(`https://api.104-236-84-15.sslip.io/v1/monitors/mon_6b1f3c2a9e4d5f6a7b8c9d0e/changes?${new URLSearchParams({"limit":"1"})}`, {
  headers: { Authorization: `Bearer ${process.env.PAGETEER_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.message);
console.log(data, res.headers.get('x-credits-remaining'));

import os
import requests

headers = {"Authorization": f"Bearer {os.environ['PAGETEER_API_KEY']}"}
res = requests.get(
    "https://api.104-236-84-15.sslip.io/v1/monitors/mon_6b1f3c2a9e4d5f6a7b8c9d0e/changes",
    headers=headers,
    params={
        "limit": 1,
    },
    timeout=120,
)
res.raise_for_status()
print(res.json(), res.headers["x-credits-remaining"])

{
  "changes": [
    {
      "id": "chg_6b1f4e7d0a1b2c3d4e5f6a7b",
      "monitor_id": "mon_6b1f3c2a9e4d5f6a7b8c9d0e",
      "at": "2026-10-28T12:01:13.402Z",
      "status": 200,
      "final_url": "https://example.com/pricing",
      "title": "Pricing",
      "added": 1,
      "removed": 1,
      "diff": "@@ -3,3 +3,3 @@\n Starter\n-$19 per month\n+$24 per month\n Billed yearly",
      "diff_truncated": false,
      "fields": null,
      "fields_truncated": false,
      "hash": "9b2c…",
      "previous_hash": "41de…"
    }
  ],
  "next": "chg_6b1f4e7d0a1b2c3d4e5f6a7b"
}

Newest first; pass next as before for older changes, until it is null. Changes are kept 90 days. diff is a unified diff of the normalized text with two lines of context (up to 20,000 characters; added/removed are exact). Data monitors also get fields: [{ path, kind: "added" | "removed" | "changed", before, after }], with paths like price or items[2].name.

What counts as a change

Content is normalized before it is hashed and compared: whitespace runs, blank lines, invisible characters (zero-width spaces, soft hyphens, non-breaking spaces) and cache-busting query strings on image URLs never count. Your ignore patterns are removed next. A check that sees the same normalized content is not a change, even when the site re-rendered the page. A site error (5xx) is a failed check, not a change; a 404 is a successful check and shows up as a change when the page disappears.

Read, edit, pause, delete

• GET /v1/monitors lists your monitors, newest first (?status=active|paused, ?limit= up to 100). GET /v1/monitors/:id returns one.
• PATCH /v1/monitors/:id takes any create field (null removes an optional one) and paused: true | false. Changing what is compared (url, mode, wait_for, selector, markdown_mode, selectors, schema, ignore) starts a new baseline. Resuming runs the next check right away.
• DELETE /v1/monitors/:id deletes the monitor and its change history.
• POST /v1/monitors/:id/check checks now (also while paused) and answers { checked_at, baseline, changed, change, status, credits, monitor }. The schedule does not move. 409 conflict while another check of the same monitor runs.

curl -X PATCH "https://api.104-236-84-15.sslip.io/v1/monitors/mon_6b1f3c2a9e4d5f6a7b8c9d0e" \
  -H "Authorization: Bearer $PAGETEER_API_KEY" -H "content-type: application/json" \
  -d '{"paused": true}'

Monitor fields

Besides your settings (url, name, interval, mode, unblock, selector, selectors, schema, ignore, webhook, metadata):

Scheduling, failures and pausing

Checks run at the interval plus a little jitter (at most 5 %, never more than 10 minutes), so monitors created together spread out. A failed check (timeout, block, CAPTCHA, site error) is free and retried sooner: after 5 minutes, then 10, 20…, never later than the regular interval, and never before a site's Retry-After. After 5 failed checks in a row the monitor pauses (failures). It also pauses at once when your credits or spend limit run out, when the organization is suspended, or when the plan no longer includes what it uses. Each pause sends monitor.paused; resume with PATCH { "paused": false } or from the Monitors page of the dashboard.

Webhooks

Events are signed and retried exactly like batch webhooks (pageteer-signature, pageteer-event, pageteer-delivery headers): see Webhooks for verification in Node and Python.

{
  "id": "evt_6b1f4e7d9f0a1b2c3d4e5f60",
  "type": "monitor.changed",
  "created_at": "2026-10-28T12:01:13.455Z",
  "data": {
    "monitor": { "id": "mon_6b1f3c2a9e4d5f6a7b8c9d0e", "url": "https://example.com/pricing", "changes": 1, "…": "…" },
    "change": { "id": "chg_6b1f4e7d0a1b2c3d4e5f6a7b", "added": 1, "removed": 1, "diff": "@@ -3,3 +3,3 @@\n …" }
  }
}

monitor.paused carries { monitor, reason, error? }. A change whose event would be over 1 MB is sent without its diff (diff_omitted: true); read it from the change history.

Credits

There is no monitor fee: each successful check costs what the fetch costs. HTTP mode 1 credit, browser mode 5, plus the add-on of the unblocking tier that served it; a page that answers 304 Not Modified to our conditional request costs 1. selectors cost the same; schema adds 40 only for checks where the page changed. A daily HTTP monitor is about 30 credits a month. Failed checks, creating, listing and reading changes are free. Checks appear in your usage as the monitors endpoint.

Errors

Check now can also answer with the target errors of render (target_blocked, captcha_required, timeout…); they are recorded on the monitor as last_error and never charged.