changedetection.io

App · 22 actions

Watch web pages for changes with changedetection.io: add, change, pause and recheck watches, read what changed on a page or across many in a period, organize them with tags, and start a workflow when a page changes, a product is back in stock or its price changes, or a watch starts failing.

Actions

ActionWhat it does
Create tagMake a tag (group) to file watches under, optionally given to every new watch whose URL matches a pattern.
Create watchStart watching a web page for changes: how often to check it, the part of the page to watch, text to ignore or wait for, and which changes count, such as only text added.
Delete tagDelete a tag (group).
Delete watchStop watching a page and delete its watch, with its history of changes.
Get changes between datesGet every watch that changed in a period, of a tag, some watches or all of them, each with what changed, and all of it as one block of text for a digest or an AI step.
Get differenceGet what changed on a page between two snapshots, by default its last change: the changed lines as text, and the lines added and removed.
Get snapshotGet a page's text as changedetection.io saw it: its latest snapshot, or the one taken at a time.
Get system infoGet changedetection.io's version, how many watches and tags it has, how many are waiting to be checked or overdue, and whether everything is paused or muted.
Get watchGet a watch: its page, tags, when it was checked and changed, any error, its settings and, for a product, its stock and price.
Import URLsStart watching a list of pages at once, one URL per line, with the tags you give.
List snapshotsList the snapshots changedetection.io kept of a page, the newest first: one each time it changed.
List tagsList the tags (groups) watches are filed under, with how many watches each has.
List watchesList watches, the most recently changed first, with when each was checked and changed, its tags and any error, of every tag or one.
Mute watchMute a watch's notifications from changedetection.io.
Pause watchPause a watch, so it isn't checked until it's resumed.
Recheck all watchesCheck every watch now, or those of one tag, or only the ones whose last check failed.
Recheck watchCheck a watch's page now, rather than at its next scheduled check, and optionally wait (up to two minutes) to see whether it changed.
Resume watchResume a paused watch, so it's checked again on its schedule.
Search watchesFind watches whose URL or title has some text, of every tag or one.
Unmute watchTurn a watch's notifications from changedetection.io back on.
Update tagRename a tag, change which new watches get it, or mute or unmute the notifications of all its watches.
Update watchChange a watch's URL, title, tags, how often it's checked, its filters or which changes count.

Create tag

Make a tag (group) to file watches under, optionally given to every new watch whose URL matches a pattern. One with the name already is returned as it is.

Inputs

NametitletextRequired
The tag's name, such as Competitors.
Give to URLs likeurl_match_patterntext
New watches whose URL matches get this tag, such as *://example.com/* or a part of the address.

Outputs

already_existedtrue/false
Whether a tag with that name was already there
createdtext
When it was made (ISO 8601)
mutedtrue/false
Whether notifications for its watches are muted
titletext
The tag's name
url_match_patterntext
New watches whose URL matches this pattern get the tag; empty if none
uuidtext
The tag's UUID
watch_countnumber
How many watches have it
Example output
{
  "already_existed": false,
  "created": "2026-10-01T08:00:00Z",
  "muted": false,
  "title": "Competitors",
  "url_match_pattern": "",
  "uuid": "597091a4-d924-40e8-bb99-02424e3dab63",
  "watch_count": 0
}

Create watch

Start watching a web page for changes: how often to check it, the part of the page to watch, text to ignore or wait for, and which changes count, such as only text added. A product page can be watched for its stock and price instead.

Inputs

URLurltextRequired
The page to watch, such as https://example.com/pricing.
Titletitletext
A name to list it by. Leave empty to use the page's own title.
Tagstagslist
Tags (groups) to file it under, by name, such as Competitors. Ones that don't exist are made.
Check every (minutes)check_every_minutesnumber
How often to check the page, in minutes, such as 60 for hourly or 1440 for daily. Leave empty for the default from changedetection.io's Settings.From 0 to 525600.
Only watch this partcss_filterlist
CSS selectors or XPath, one per line, such as #pricing or //table[1]: only that part of the page is compared. Leave empty for the whole page.
Leave out these partsremove_elementslist
CSS selectors or XPath, one per line, of parts to leave out, such as a footer or an ad (.ads).
Ignore textignore_textlist
Text whose changes don't count, one per line, such as a visitor counter's label. A /regex/ works too.
Only when this text is theretrigger_textlist
Text that must be on the page for a change to count, one per line, such as In stock. A /regex/ works too.
Added lines countnotice_addedtrue/false
Whether lines added to the page count as a change. On unless you turn it off.
Removed lines countnotice_removedtrue/false
Whether lines removed from the page count as a change. Turn this off to hear only when text is added.
Changed lines countnotice_replacedtrue/false
Whether lines that changed count as a change. On unless you turn it off.
Only new linesunique_lines_onlytrue/false
Count a change only when a line appears that the page has never had before, such as a new item in a list.
Watch forwatch_typetext
Page text changes, or a product page's stock and price (Restock and price), which the restock and price triggers follow.One of: text (Page text changes), restock (Restock and price). Default: text.
Start pausedpausedtrue/false
Add it paused, so it isn't checked until it's resumed.

Outputs

check_every_minutesnumber
How often it's checked, in minutes; 0 when it uses the default from Settings
checksnumber
How many times it has been checked
createdtext
When it was added (ISO 8601)
css_filterlist
The CSS or XPath selectors it watches only the part of
currencytext
For a restock watch, the price's currency, such as USD
edit_linktext
A link to the watch's settings in changedetection.io
errortext
Why its last check failed; empty if it worked
history_linktext
A link to the watch's history of changes
ignore_textlist
Text whose changes it ignores
in_stocktrue/false
For a restock watch, whether the product is in stock; else null
last_changedtext
When the page last changed (ISO 8601); empty if it hasn't since it was added
last_checkedtext
When it was last checked (ISO 8601); empty if never
linktext
The address to open in a browser
mutedtrue/false
Whether its notifications are muted
nametext
What changedetection.io calls it: its title, else the page's own title, else its URL
notice_addedtrue/false
Whether added lines count as a change
notice_removedtrue/false
Whether removed lines count as a change
notice_replacedtrue/false
Whether changed lines count as a change
page_titletext
The page's own title, from its last check
pausedtrue/false
Whether it's paused, so it isn't checked
previous_pricenumber
For a restock watch, the price before its last price change
pricenumber
For a restock watch, the price found; else null
remove_elementslist
The CSS or XPath selectors of parts it leaves out
snapshotsnumber
How many snapshots of the page it has kept
tagslist
Its tags (groups), by name
titletext
The title given to the watch; empty if none
trigger_textlist
Text that must be on the page for a change to count
unique_lines_onlytrue/false
Whether only lines never seen on the page before count as a change
urltext
The address it watches
uuidtext
The watch's UUID
viewedtrue/false
Whether its last change has been looked at in changedetection.io
watch_typetext
What it watches for: text (the page's text) or restock (a product's stock and price)
Example output
{
  "check_every_minutes": 60,
  "checks": 97,
  "created": "2026-10-01T08:00:00Z",
  "css_filter": [
    "#pricing-table"
  ],
  "currency": "",
  "edit_link": "https://lemonade.changedetection.io/your-login/edit/cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "error": "",
  "history_link": "https://lemonade.changedetection.io/your-login/diff/cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "ignore_text": [],
  "in_stock": null,
  "last_changed": "2026-11-11T14:02:11Z",
  "last_checked": "2026-11-12T09:30:00Z",
  "link": "https://example.com/pricing",
  "muted": false,
  "name": "Pricing page",
  "notice_added": true,
  "notice_removed": true,
  "notice_replaced": true,
  "page_title": "Pricing - Example",
  "paused": false,
  "previous_price": null,
  "price": null,
  "remove_elements": [],
  "snapshots": 4,
  "tags": [
    "Competitors"
  ],
  "title": "Pricing page",
  "trigger_text": [],
  "unique_lines_only": false,
  "url": "https://example.com/pricing",
  "uuid": "cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "viewed": false,
  "watch_type": "text"
}

Delete tag

Delete a tag (group). Its watches stay, without the tag.

Inputs

TagtagtextRequired
The tag (group): pick one, or type its name or UUID.

Outputs

deletedtrue/false
True: it's deleted, and its watches no longer have it
titletext
Its name
uuidtext
The deleted tag's UUID
Example output
{
  "deleted": true,
  "title": "Competitors",
  "uuid": "597091a4-d924-40e8-bb99-02424e3dab63"
}

Delete watch

Stop watching a page and delete its watch, with its history of changes.

Inputs

WatchwatchtextRequired
The watch: pick one, or use its UUID (from an earlier step), its exact URL or its title.

Outputs

deletedtrue/false
True: it's deleted, with its history
nametext
Its title or address
urltext
The address it watched
uuidtext
The deleted watch's UUID
Example output
{
  "deleted": true,
  "name": "Pricing page",
  "url": "https://example.com/pricing",
  "uuid": "cf501e5e-5064-47c4-b863-39d7ab521e9e"
}

Get changes between dates

Get every watch that changed in a period, of a tag, some watches or all of them, each with what changed, and all of it as one block of text for a digest or an AI step.

Inputs

Sincesincedate and timeRequired
The start of the period, such as a week ago.
Untiluntildate and time
The end of the period. Leave empty for now.
Tagtagtext
Only watches with this tag (group), by name. Leave blank for every watch.
Watcheswatcheslist
Only these watches, by UUID, URL or title, when no tag is given.
Each changeeach_changetrue/false
Give each change in the period on its own. Off: one difference per watch, from the start of the period to its end.
How manylimitnumber
The most changed watches to list, 1 to 1000. Defaults to 50.From 1 to 1000.

Outputs

changes_totalnumber
How many changes they had between them
countnumber
How many watches are listed
incompletetrue/false
True when changedetection.io ran out of time before looking at every watch: narrow it to a tag or a shorter period
reporttext
Every change as one block of text, for a message or an AI step
sincetext
The start of the period (ISO 8601)
totalnumber
How many watches changed in the period
untiltext
The end of the period (ISO 8601)
watcheslist
The watches that changed, the most recent first
watches_checkednumber
How many watches were looked at
Example output
{
  "changes_total": 1,
  "count": 1,
  "incomplete": false,
  "report": "### Pricing page - https://example.com/pricing\n--- 2026-11-01T00:00:00Z\n+++ 2026-11-11T14:02:11Z\n@@ -1 +1 @@\n-Starter $10 a month\n+Starter $12 a month",
  "since": "2026-11-01T00:00:00Z",
  "total": 1,
  "until": "2026-11-12T10:00:00Z",
  "watches": [
    {
      "added": [
        "Starter $12 a month"
      ],
      "changes": 1,
      "diff": "--- 2026-11-01T00:00:00Z\n+++ 2026-11-11T14:02:11Z\n@@ -1 +1 @@\n-Starter $10 a month\n+Starter $12 a month",
      "error": "",
      "from_time": "2026-11-01T00:00:00Z",
      "name": "Pricing page",
      "new_in_period": false,
      "no_net_difference": false,
      "removed": [
        "Starter $10 a month"
      ],
      "to_time": "2026-11-11T14:02:11Z",
      "truncated": false,
      "url": "https://example.com/pricing",
      "uuid": "cf501e5e-5064-47c4-b863-39d7ab521e9e"
    }
  ],
  "watches_checked": 12
}

Get difference

Get what changed on a page between two snapshots, by default its last change: the changed lines as text, and the lines added and removed.

Inputs

WatchwatchtextRequired
The watch: pick one, or use its UUID (from an earlier step), its exact URL or its title.
Fromfrom_snapshottext
previous (the snapshot before the latest), a snapshot's timestamp, or a date and time. Defaults to previous.
Toto_snapshottext
latest, a snapshot's timestamp, or a date and time. Defaults to latest.
Changed lines onlychanges_onlytrue/false
Only the lines that changed, without the rest of the page. On unless you turn it off.
Word by wordword_leveltrue/false
Mark the words that changed within a line, rather than whole lines.
Ignore spacingignore_whitespacetrue/false
Leave out changes that are only spaces, tabs or blank lines.

Outputs

addedlist
The lines added, or what changed lines became
changedtrue/false
Whether anything changed between the two
difftext
The difference as text, each changed line marked (added), (removed), or (changed) and (into)
from_timetext
When the older snapshot was taken (ISO 8601)
from_timestamptext
The older snapshot's timestamp
history_linktext
A link to the watch's history in changedetection.io
removedlist
The lines removed, or what changed lines were
to_timetext
When the newer snapshot was taken (ISO 8601)
to_timestamptext
The newer snapshot's timestamp
watch_uuidtext
The watch's UUID
Example output
{
  "added": [
    "Starter $12 a month"
  ],
  "changed": true,
  "diff": "(changed) Starter $10 a month\n(into) Starter $12 a month",
  "from_time": "2026-10-26T06:40:00Z",
  "from_timestamp": "1793001600",
  "history_link": "https://lemonade.changedetection.io/your-login/diff/cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "removed": [
    "Starter $10 a month"
  ],
  "to_time": "2026-11-11T14:02:11Z",
  "to_timestamp": "1794405731",
  "watch_uuid": "cf501e5e-5064-47c4-b863-39d7ab521e9e"
}

Get snapshot

Get a page's text as changedetection.io saw it: its latest snapshot, or the one taken at a time.

Inputs

WatchwatchtextRequired
The watch: pick one, or use its UUID (from an earlier step), its exact URL or its title.
Snapshotsnapshottext
latest, or a snapshot's timestamp from List snapshots, or a date and time (the snapshot taken then or just before). Defaults to latest.

Outputs

charactersnumber
How long the text is
texttext
The page's text as it was then, as changedetection.io keeps it
timetext
When it was taken (ISO 8601)
timestamptext
The snapshot's timestamp (Unix seconds)
truncatedtrue/false
Whether the text was cut at 200,000 characters
watch_uuidtext
The watch's UUID
Example output
{
  "characters": 59,
  "text": "Starter $12 a month\nTeam $29 a month\nEnterprise: talk to us",
  "time": "2026-11-11T14:02:11Z",
  "timestamp": "1794405731",
  "truncated": false,
  "watch_uuid": "cf501e5e-5064-47c4-b863-39d7ab521e9e"
}

Get system info

Get changedetection.io's version, how many watches and tags it has, how many are waiting to be checked or overdue, and whether everything is paused or muted.

Inputs

None.

Outputs

all_mutedtrue/false
Whether every notification is muted
all_pausedtrue/false
Whether every watch is paused
checking_nowlist
The watches being checked right now, the longest running first
kindslist
The kinds of watch it offers, such as text_json_diff
new_version_availabletrue/false
Whether a newer version is out
overdue_countnumber
How many watches are overdue for a check
overdue_watcheslist
The UUIDs of the watches overdue for a check
queue_sizenumber
How many watches are waiting to be checked
tag_countnumber
How many tags there are
uptime_secondsnumber
How long changedetection.io has been running
versiontext
changedetection.io's version, such as 0.70.3
watch_countnumber
How many watches there are
Example output
{
  "all_muted": false,
  "all_paused": false,
  "checking_now": [
    {
      "name": "Pricing page",
      "running_seconds": 3,
      "uuid": "cf501e5e-5064-47c4-b863-39d7ab521e9e"
    }
  ],
  "kinds": [
    "text_json_diff",
    "restock_diff"
  ],
  "new_version_available": false,
  "overdue_count": 0,
  "overdue_watches": [],
  "queue_size": 0,
  "tag_count": 5,
  "uptime_seconds": 86400,
  "version": "0.70.3",
  "watch_count": 42
}

Get watch

Get a watch: its page, tags, when it was checked and changed, any error, its settings and, for a product, its stock and price.

Inputs

WatchwatchtextRequired
The watch: pick one, or use its UUID (from an earlier step), its exact URL or its title.

Outputs

check_every_minutesnumber
How often it's checked, in minutes; 0 when it uses the default from Settings
checksnumber
How many times it has been checked
createdtext
When it was added (ISO 8601)
css_filterlist
The CSS or XPath selectors it watches only the part of
currencytext
For a restock watch, the price's currency, such as USD
edit_linktext
A link to the watch's settings in changedetection.io
errortext
Why its last check failed; empty if it worked
history_linktext
A link to the watch's history of changes
ignore_textlist
Text whose changes it ignores
in_stocktrue/false
For a restock watch, whether the product is in stock; else null
last_changedtext
When the page last changed (ISO 8601); empty if it hasn't since it was added
last_checkedtext
When it was last checked (ISO 8601); empty if never
linktext
The address to open in a browser
mutedtrue/false
Whether its notifications are muted
nametext
What changedetection.io calls it: its title, else the page's own title, else its URL
notice_addedtrue/false
Whether added lines count as a change
notice_removedtrue/false
Whether removed lines count as a change
notice_replacedtrue/false
Whether changed lines count as a change
page_titletext
The page's own title, from its last check
pausedtrue/false
Whether it's paused, so it isn't checked
previous_pricenumber
For a restock watch, the price before its last price change
pricenumber
For a restock watch, the price found; else null
remove_elementslist
The CSS or XPath selectors of parts it leaves out
snapshotsnumber
How many snapshots of the page it has kept
tagslist
Its tags (groups), by name
titletext
The title given to the watch; empty if none
trigger_textlist
Text that must be on the page for a change to count
unique_lines_onlytrue/false
Whether only lines never seen on the page before count as a change
urltext
The address it watches
uuidtext
The watch's UUID
viewedtrue/false
Whether its last change has been looked at in changedetection.io
watch_typetext
What it watches for: text (the page's text) or restock (a product's stock and price)
Example output
{
  "check_every_minutes": 60,
  "checks": 97,
  "created": "2026-10-01T08:00:00Z",
  "css_filter": [
    "#pricing-table"
  ],
  "currency": "",
  "edit_link": "https://lemonade.changedetection.io/your-login/edit/cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "error": "",
  "history_link": "https://lemonade.changedetection.io/your-login/diff/cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "ignore_text": [],
  "in_stock": null,
  "last_changed": "2026-11-11T14:02:11Z",
  "last_checked": "2026-11-12T09:30:00Z",
  "link": "https://example.com/pricing",
  "muted": false,
  "name": "Pricing page",
  "notice_added": true,
  "notice_removed": true,
  "notice_replaced": true,
  "page_title": "Pricing - Example",
  "paused": false,
  "previous_price": null,
  "price": null,
  "remove_elements": [],
  "snapshots": 4,
  "tags": [
    "Competitors"
  ],
  "title": "Pricing page",
  "trigger_text": [],
  "unique_lines_only": false,
  "url": "https://example.com/pricing",
  "uuid": "cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "viewed": false,
  "watch_type": "text"
}

Import URLs

Start watching a list of pages at once, one URL per line, with the tags you give. URLs already watched are skipped.

Inputs

URLsurlstextRequired
The pages to watch, one per line, such as https://example.com/news.
Tagstagslist
Tags (groups) to file them under, by name. Ones that don't exist are made.
Skip URLs already watchedskip_duplicatestrue/false
Leave out URLs changedetection.io already watches. On unless you turn it off.
Add pausedpausedtrue/false
Add them paused, so they aren't checked until resumed.

Outputs

countnumber
How many watches were added
in_backgroundtrue/false
True when changedetection.io adds them in the background (20 or more), so the UUIDs aren't known yet
skippednumber
How many addresses were skipped, as already watched
uuidslist
The new watches' UUIDs
Example output
{
  "count": 2,
  "in_background": false,
  "skipped": 1,
  "uuids": [
    "0b6e1f7a-2c4d-4e8f-9a1b-3c5d7e9f1a2b",
    "4d8f2a6c-1e3b-4a5c-8d7e-9f0a1b2c3d4e"
  ]
}

List snapshots

List the snapshots changedetection.io kept of a page, the newest first: one each time it changed.

Inputs

WatchwatchtextRequired
The watch: pick one, or use its UUID (from an earlier step), its exact URL or its title.
How manylimitnumber
The most snapshots to list, 1 to 1000. Defaults to 50.From 1 to 1000.

Outputs

countnumber
How many snapshots are listed
latesttext
The newest snapshot's timestamp; empty if none
snapshotslist
Its snapshots, the newest first
totalnumber
How many the watch has
watch_uuidtext
The watch's UUID
Example output
{
  "count": 2,
  "latest": "1794405731",
  "snapshots": [
    {
      "time": "2026-11-11T14:02:11Z",
      "timestamp": "1794405731"
    },
    {
      "time": "2026-10-26T06:40:00Z",
      "timestamp": "1793001600"
    }
  ],
  "total": 2,
  "watch_uuid": "cf501e5e-5064-47c4-b863-39d7ab521e9e"
}

List tags

List the tags (groups) watches are filed under, with how many watches each has.

Inputs

None.

Outputs

countnumber
How many tags there are
tagslist
The tags, by name
Example output
{
  "count": 2,
  "tags": [
    {
      "created": "2026-10-01T08:00:00Z",
      "muted": false,
      "title": "Competitors",
      "url_match_pattern": "",
      "uuid": "597091a4-d924-40e8-bb99-02424e3dab63",
      "watch_count": 12
    },
    {
      "created": "2026-10-01T08:00:00Z",
      "muted": false,
      "title": "Suppliers",
      "url_match_pattern": "",
      "uuid": "0303e5e2-ca9e-4987-bcb1-229cc280ddb7",
      "watch_count": 3
    }
  ]
}

List watches

List watches, the most recently changed first, with when each was checked and changed, its tags and any error, of every tag or one.

Inputs

Tagtagtext
Only watches with this tag (group), by name. Leave blank for every watch.
Only failingonly_with_errorstrue/false
Only watches whose last check failed.
Only unviewed changesonly_unviewedtrue/false
Only watches with a change nobody has looked at in changedetection.io yet.
How manylimitnumber
The most watches to list, 1 to 1000. Defaults to 100.From 1 to 1000.

Outputs

countnumber
How many watches are listed
totalnumber
How many matched, before the limit
watcheslist
The watches, the most recently changed first
Example output
{
  "count": 2,
  "total": 2,
  "watches": [
    {
      "currency": "",
      "edit_link": "https://lemonade.changedetection.io/your-login/edit/cf501e5e-5064-47c4-b863-39d7ab521e9e",
      "error": "",
      "history_link": "https://lemonade.changedetection.io/your-login/diff/cf501e5e-5064-47c4-b863-39d7ab521e9e",
      "in_stock": null,
      "last_changed": "2026-11-11T14:02:11Z",
      "last_checked": "2026-11-12T09:30:00Z",
      "link": "https://example.com/pricing",
      "muted": false,
      "name": "Pricing page",
      "page_title": "Pricing - Example",
      "paused": false,
      "previous_price": null,
      "price": null,
      "tags": [
        "Competitors"
      ],
      "title": "Pricing page",
      "url": "https://example.com/pricing",
      "uuid": "cf501e5e-5064-47c4-b863-39d7ab521e9e",
      "viewed": false,
      "watch_type": "text"
    },
    {
      "currency": "USD",
      "edit_link": "https://lemonade.changedetection.io/your-login/edit/8893e1f5-1e31-418e-9c15-132d9ae2e0d8",
      "error": "",
      "history_link": "https://lemonade.changedetection.io/your-login/diff/8893e1f5-1e31-418e-9c15-132d9ae2e0d8",
      "in_stock": true,
      "last_changed": "2026-11-11T14:02:11Z",
      "last_checked": "2026-11-12T09:30:00Z",
      "link": "https://shop.example.com/widget",
      "muted": false,
      "name": "Widget",
      "page_title": "Widget - Example shop",
      "paused": false,
      "previous_price": 19.99,
      "price": 17.49,
      "tags": [],
      "title": "Widget",
      "url": "https://shop.example.com/widget",
      "uuid": "8893e1f5-1e31-418e-9c15-132d9ae2e0d8",
      "viewed": false,
      "watch_type": "restock"
    }
  ]
}

Mute watch

Mute a watch's notifications from changedetection.io. It's still checked, and Lodol's triggers still see its changes.

Inputs

WatchwatchtextRequired
The watch: pick one, or use its UUID (from an earlier step), its exact URL or its title.

Outputs

check_every_minutesnumber
How often it's checked, in minutes; 0 when it uses the default from Settings
checksnumber
How many times it has been checked
createdtext
When it was added (ISO 8601)
css_filterlist
The CSS or XPath selectors it watches only the part of
currencytext
For a restock watch, the price's currency, such as USD
edit_linktext
A link to the watch's settings in changedetection.io
errortext
Why its last check failed; empty if it worked
history_linktext
A link to the watch's history of changes
ignore_textlist
Text whose changes it ignores
in_stocktrue/false
For a restock watch, whether the product is in stock; else null
last_changedtext
When the page last changed (ISO 8601); empty if it hasn't since it was added
last_checkedtext
When it was last checked (ISO 8601); empty if never
linktext
The address to open in a browser
mutedtrue/false
Whether its notifications are muted
nametext
What changedetection.io calls it: its title, else the page's own title, else its URL
notice_addedtrue/false
Whether added lines count as a change
notice_removedtrue/false
Whether removed lines count as a change
notice_replacedtrue/false
Whether changed lines count as a change
page_titletext
The page's own title, from its last check
pausedtrue/false
Whether it's paused, so it isn't checked
previous_pricenumber
For a restock watch, the price before its last price change
pricenumber
For a restock watch, the price found; else null
remove_elementslist
The CSS or XPath selectors of parts it leaves out
snapshotsnumber
How many snapshots of the page it has kept
tagslist
Its tags (groups), by name
titletext
The title given to the watch; empty if none
trigger_textlist
Text that must be on the page for a change to count
unique_lines_onlytrue/false
Whether only lines never seen on the page before count as a change
urltext
The address it watches
uuidtext
The watch's UUID
viewedtrue/false
Whether its last change has been looked at in changedetection.io
watch_typetext
What it watches for: text (the page's text) or restock (a product's stock and price)
Example output
{
  "check_every_minutes": 60,
  "checks": 97,
  "created": "2026-10-01T08:00:00Z",
  "css_filter": [
    "#pricing-table"
  ],
  "currency": "",
  "edit_link": "https://lemonade.changedetection.io/your-login/edit/cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "error": "",
  "history_link": "https://lemonade.changedetection.io/your-login/diff/cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "ignore_text": [],
  "in_stock": null,
  "last_changed": "2026-11-11T14:02:11Z",
  "last_checked": "2026-11-12T09:30:00Z",
  "link": "https://example.com/pricing",
  "muted": true,
  "name": "Pricing page",
  "notice_added": true,
  "notice_removed": true,
  "notice_replaced": true,
  "page_title": "Pricing - Example",
  "paused": false,
  "previous_price": null,
  "price": null,
  "remove_elements": [],
  "snapshots": 4,
  "tags": [
    "Competitors"
  ],
  "title": "Pricing page",
  "trigger_text": [],
  "unique_lines_only": false,
  "url": "https://example.com/pricing",
  "uuid": "cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "viewed": false,
  "watch_type": "text"
}

Pause watch

Pause a watch, so it isn't checked until it's resumed. Its history stays.

Inputs

WatchwatchtextRequired
The watch: pick one, or use its UUID (from an earlier step), its exact URL or its title.

Outputs

check_every_minutesnumber
How often it's checked, in minutes; 0 when it uses the default from Settings
checksnumber
How many times it has been checked
createdtext
When it was added (ISO 8601)
css_filterlist
The CSS or XPath selectors it watches only the part of
currencytext
For a restock watch, the price's currency, such as USD
edit_linktext
A link to the watch's settings in changedetection.io
errortext
Why its last check failed; empty if it worked
history_linktext
A link to the watch's history of changes
ignore_textlist
Text whose changes it ignores
in_stocktrue/false
For a restock watch, whether the product is in stock; else null
last_changedtext
When the page last changed (ISO 8601); empty if it hasn't since it was added
last_checkedtext
When it was last checked (ISO 8601); empty if never
linktext
The address to open in a browser
mutedtrue/false
Whether its notifications are muted
nametext
What changedetection.io calls it: its title, else the page's own title, else its URL
notice_addedtrue/false
Whether added lines count as a change
notice_removedtrue/false
Whether removed lines count as a change
notice_replacedtrue/false
Whether changed lines count as a change
page_titletext
The page's own title, from its last check
pausedtrue/false
Whether it's paused, so it isn't checked
previous_pricenumber
For a restock watch, the price before its last price change
pricenumber
For a restock watch, the price found; else null
remove_elementslist
The CSS or XPath selectors of parts it leaves out
snapshotsnumber
How many snapshots of the page it has kept
tagslist
Its tags (groups), by name
titletext
The title given to the watch; empty if none
trigger_textlist
Text that must be on the page for a change to count
unique_lines_onlytrue/false
Whether only lines never seen on the page before count as a change
urltext
The address it watches
uuidtext
The watch's UUID
viewedtrue/false
Whether its last change has been looked at in changedetection.io
watch_typetext
What it watches for: text (the page's text) or restock (a product's stock and price)
Example output
{
  "check_every_minutes": 60,
  "checks": 97,
  "created": "2026-10-01T08:00:00Z",
  "css_filter": [
    "#pricing-table"
  ],
  "currency": "",
  "edit_link": "https://lemonade.changedetection.io/your-login/edit/cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "error": "",
  "history_link": "https://lemonade.changedetection.io/your-login/diff/cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "ignore_text": [],
  "in_stock": null,
  "last_changed": "2026-11-11T14:02:11Z",
  "last_checked": "2026-11-12T09:30:00Z",
  "link": "https://example.com/pricing",
  "muted": false,
  "name": "Pricing page",
  "notice_added": true,
  "notice_removed": true,
  "notice_replaced": true,
  "page_title": "Pricing - Example",
  "paused": true,
  "previous_price": null,
  "price": null,
  "remove_elements": [],
  "snapshots": 4,
  "tags": [
    "Competitors"
  ],
  "title": "Pricing page",
  "trigger_text": [],
  "unique_lines_only": false,
  "url": "https://example.com/pricing",
  "uuid": "cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "viewed": false,
  "watch_type": "text"
}

Recheck all watches

Check every watch now, or those of one tag, or only the ones whose last check failed. Paused watches aren't checked.

Inputs

Tagtagtext
Only watches with this tag (group), by name. Leave blank for every watch.
Only failingonly_with_errorstrue/false
Only watches whose last check failed.

Outputs

messagetext
What changedetection.io said
queuednumber
How many watches were queued for a check
tagtext
The tag whose watches were queued; empty for every watch
Example output
{
  "message": "OK, queued 12 watches for rechecking",
  "queued": 12,
  "tag": "Competitors"
}

Recheck watch

Check a watch's page now, rather than at its next scheduled check, and optionally wait (up to two minutes) to see whether it changed.

Inputs

WatchwatchtextRequired
The watch: pick one, or use its UUID (from an earlier step), its exact URL or its title.
Wait for the checkwaittrue/false
Wait until the check is done, up to two minutes, and say whether the page changed. Off: the check is only queued.

Outputs

changedtrue/false
Whether the check found the page changed
check_every_minutesnumber
How often it's checked, in minutes; 0 when it uses the default from Settings
checkedtrue/false
Whether the check finished while the step waited
checksnumber
How many times it has been checked
createdtext
When it was added (ISO 8601)
css_filterlist
The CSS or XPath selectors it watches only the part of
currencytext
For a restock watch, the price's currency, such as USD
edit_linktext
A link to the watch's settings in changedetection.io
errortext
Why its last check failed; empty if it worked
history_linktext
A link to the watch's history of changes
ignore_textlist
Text whose changes it ignores
in_stocktrue/false
For a restock watch, whether the product is in stock; else null
last_changedtext
When the page last changed (ISO 8601); empty if it hasn't since it was added
last_checkedtext
When it was last checked (ISO 8601); empty if never
linktext
The address to open in a browser
mutedtrue/false
Whether its notifications are muted
nametext
What changedetection.io calls it: its title, else the page's own title, else its URL
notice_addedtrue/false
Whether added lines count as a change
notice_removedtrue/false
Whether removed lines count as a change
notice_replacedtrue/false
Whether changed lines count as a change
page_titletext
The page's own title, from its last check
pausedtrue/false
Whether it's paused, so it isn't checked
previous_pricenumber
For a restock watch, the price before its last price change
pricenumber
For a restock watch, the price found; else null
remove_elementslist
The CSS or XPath selectors of parts it leaves out
snapshotsnumber
How many snapshots of the page it has kept
tagslist
Its tags (groups), by name
titletext
The title given to the watch; empty if none
trigger_textlist
Text that must be on the page for a change to count
unique_lines_onlytrue/false
Whether only lines never seen on the page before count as a change
urltext
The address it watches
uuidtext
The watch's UUID
viewedtrue/false
Whether its last change has been looked at in changedetection.io
watch_typetext
What it watches for: text (the page's text) or restock (a product's stock and price)
Example output
{
  "changed": true,
  "check_every_minutes": 60,
  "checked": true,
  "checks": 98,
  "created": "2026-10-01T08:00:00Z",
  "css_filter": [
    "#pricing-table"
  ],
  "currency": "",
  "edit_link": "https://lemonade.changedetection.io/your-login/edit/cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "error": "",
  "history_link": "https://lemonade.changedetection.io/your-login/diff/cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "ignore_text": [],
  "in_stock": null,
  "last_changed": "2026-11-12T10:00:04Z",
  "last_checked": "2026-11-12T10:00:04Z",
  "link": "https://example.com/pricing",
  "muted": false,
  "name": "Pricing page",
  "notice_added": true,
  "notice_removed": true,
  "notice_replaced": true,
  "page_title": "Pricing - Example",
  "paused": false,
  "previous_price": null,
  "price": null,
  "remove_elements": [],
  "snapshots": 5,
  "tags": [
    "Competitors"
  ],
  "title": "Pricing page",
  "trigger_text": [],
  "unique_lines_only": false,
  "url": "https://example.com/pricing",
  "uuid": "cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "viewed": false,
  "watch_type": "text"
}

Resume watch

Resume a paused watch, so it's checked again on its schedule.

Inputs

WatchwatchtextRequired
The watch: pick one, or use its UUID (from an earlier step), its exact URL or its title.

Outputs

check_every_minutesnumber
How often it's checked, in minutes; 0 when it uses the default from Settings
checksnumber
How many times it has been checked
createdtext
When it was added (ISO 8601)
css_filterlist
The CSS or XPath selectors it watches only the part of
currencytext
For a restock watch, the price's currency, such as USD
edit_linktext
A link to the watch's settings in changedetection.io
errortext
Why its last check failed; empty if it worked
history_linktext
A link to the watch's history of changes
ignore_textlist
Text whose changes it ignores
in_stocktrue/false
For a restock watch, whether the product is in stock; else null
last_changedtext
When the page last changed (ISO 8601); empty if it hasn't since it was added
last_checkedtext
When it was last checked (ISO 8601); empty if never
linktext
The address to open in a browser
mutedtrue/false
Whether its notifications are muted
nametext
What changedetection.io calls it: its title, else the page's own title, else its URL
notice_addedtrue/false
Whether added lines count as a change
notice_removedtrue/false
Whether removed lines count as a change
notice_replacedtrue/false
Whether changed lines count as a change
page_titletext
The page's own title, from its last check
pausedtrue/false
Whether it's paused, so it isn't checked
previous_pricenumber
For a restock watch, the price before its last price change
pricenumber
For a restock watch, the price found; else null
remove_elementslist
The CSS or XPath selectors of parts it leaves out
snapshotsnumber
How many snapshots of the page it has kept
tagslist
Its tags (groups), by name
titletext
The title given to the watch; empty if none
trigger_textlist
Text that must be on the page for a change to count
unique_lines_onlytrue/false
Whether only lines never seen on the page before count as a change
urltext
The address it watches
uuidtext
The watch's UUID
viewedtrue/false
Whether its last change has been looked at in changedetection.io
watch_typetext
What it watches for: text (the page's text) or restock (a product's stock and price)
Example output
{
  "check_every_minutes": 60,
  "checks": 97,
  "created": "2026-10-01T08:00:00Z",
  "css_filter": [
    "#pricing-table"
  ],
  "currency": "",
  "edit_link": "https://lemonade.changedetection.io/your-login/edit/cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "error": "",
  "history_link": "https://lemonade.changedetection.io/your-login/diff/cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "ignore_text": [],
  "in_stock": null,
  "last_changed": "2026-11-11T14:02:11Z",
  "last_checked": "2026-11-12T09:30:00Z",
  "link": "https://example.com/pricing",
  "muted": false,
  "name": "Pricing page",
  "notice_added": true,
  "notice_removed": true,
  "notice_replaced": true,
  "page_title": "Pricing - Example",
  "paused": false,
  "previous_price": null,
  "price": null,
  "remove_elements": [],
  "snapshots": 4,
  "tags": [
    "Competitors"
  ],
  "title": "Pricing page",
  "trigger_text": [],
  "unique_lines_only": false,
  "url": "https://example.com/pricing",
  "uuid": "cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "viewed": false,
  "watch_type": "text"
}

Search watches

Find watches whose URL or title has some text, of every tag or one.

Inputs

Search forquerytextRequired
Text in the URL or title, such as example.com.
Tagtagtext
Only watches with this tag (group), by name. Leave blank for every watch.

Outputs

countnumber
How many watches matched
watcheslist
The watches, the most recently changed first
Example output
{
  "count": 1,
  "watches": [
    {
      "currency": "",
      "edit_link": "https://lemonade.changedetection.io/your-login/edit/cf501e5e-5064-47c4-b863-39d7ab521e9e",
      "error": "",
      "history_link": "https://lemonade.changedetection.io/your-login/diff/cf501e5e-5064-47c4-b863-39d7ab521e9e",
      "in_stock": null,
      "last_changed": "2026-11-11T14:02:11Z",
      "last_checked": "2026-11-12T09:30:00Z",
      "link": "https://example.com/pricing",
      "muted": false,
      "name": "Pricing page",
      "page_title": "Pricing - Example",
      "paused": false,
      "previous_price": null,
      "price": null,
      "tags": [
        "Competitors"
      ],
      "title": "Pricing page",
      "url": "https://example.com/pricing",
      "uuid": "cf501e5e-5064-47c4-b863-39d7ab521e9e",
      "viewed": false,
      "watch_type": "text"
    }
  ]
}

Unmute watch

Turn a watch's notifications from changedetection.io back on.

Inputs

WatchwatchtextRequired
The watch: pick one, or use its UUID (from an earlier step), its exact URL or its title.

Outputs

check_every_minutesnumber
How often it's checked, in minutes; 0 when it uses the default from Settings
checksnumber
How many times it has been checked
createdtext
When it was added (ISO 8601)
css_filterlist
The CSS or XPath selectors it watches only the part of
currencytext
For a restock watch, the price's currency, such as USD
edit_linktext
A link to the watch's settings in changedetection.io
errortext
Why its last check failed; empty if it worked
history_linktext
A link to the watch's history of changes
ignore_textlist
Text whose changes it ignores
in_stocktrue/false
For a restock watch, whether the product is in stock; else null
last_changedtext
When the page last changed (ISO 8601); empty if it hasn't since it was added
last_checkedtext
When it was last checked (ISO 8601); empty if never
linktext
The address to open in a browser
mutedtrue/false
Whether its notifications are muted
nametext
What changedetection.io calls it: its title, else the page's own title, else its URL
notice_addedtrue/false
Whether added lines count as a change
notice_removedtrue/false
Whether removed lines count as a change
notice_replacedtrue/false
Whether changed lines count as a change
page_titletext
The page's own title, from its last check
pausedtrue/false
Whether it's paused, so it isn't checked
previous_pricenumber
For a restock watch, the price before its last price change
pricenumber
For a restock watch, the price found; else null
remove_elementslist
The CSS or XPath selectors of parts it leaves out
snapshotsnumber
How many snapshots of the page it has kept
tagslist
Its tags (groups), by name
titletext
The title given to the watch; empty if none
trigger_textlist
Text that must be on the page for a change to count
unique_lines_onlytrue/false
Whether only lines never seen on the page before count as a change
urltext
The address it watches
uuidtext
The watch's UUID
viewedtrue/false
Whether its last change has been looked at in changedetection.io
watch_typetext
What it watches for: text (the page's text) or restock (a product's stock and price)
Example output
{
  "check_every_minutes": 60,
  "checks": 97,
  "created": "2026-10-01T08:00:00Z",
  "css_filter": [
    "#pricing-table"
  ],
  "currency": "",
  "edit_link": "https://lemonade.changedetection.io/your-login/edit/cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "error": "",
  "history_link": "https://lemonade.changedetection.io/your-login/diff/cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "ignore_text": [],
  "in_stock": null,
  "last_changed": "2026-11-11T14:02:11Z",
  "last_checked": "2026-11-12T09:30:00Z",
  "link": "https://example.com/pricing",
  "muted": false,
  "name": "Pricing page",
  "notice_added": true,
  "notice_removed": true,
  "notice_replaced": true,
  "page_title": "Pricing - Example",
  "paused": false,
  "previous_price": null,
  "price": null,
  "remove_elements": [],
  "snapshots": 4,
  "tags": [
    "Competitors"
  ],
  "title": "Pricing page",
  "trigger_text": [],
  "unique_lines_only": false,
  "url": "https://example.com/pricing",
  "uuid": "cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "viewed": false,
  "watch_type": "text"
}

Update tag

Rename a tag, change which new watches get it, or mute or unmute the notifications of all its watches.

Inputs

TagtagtextRequired
The tag (group): pick one, or type its name or UUID.
New nametitletext
Its new name. Leave empty to keep it.
Give to URLs likeurl_match_patterntext
New watches whose URL matches get this tag. Leave empty to keep it.
Mutedmutedtrue/false
Mute (on) or unmute (off) its watches' notifications. Leave unset to keep it.

Outputs

createdtext
When it was made (ISO 8601)
mutedtrue/false
Whether notifications for its watches are muted
titletext
The tag's name
url_match_patterntext
New watches whose URL matches this pattern get the tag; empty if none
uuidtext
The tag's UUID
watch_countnumber
How many watches have it
Example output
{
  "created": "2026-10-01T08:00:00Z",
  "muted": false,
  "title": "Competitors",
  "url_match_pattern": "",
  "uuid": "597091a4-d924-40e8-bb99-02424e3dab63",
  "watch_count": 12
}

Update watch

Change a watch's URL, title, tags, how often it's checked, its filters or which changes count. Settings left empty are kept.

Inputs

WatchwatchtextRequired
The watch: pick one, or use its UUID (from an earlier step), its exact URL or its title.
URLurltext
The page to watch, such as https://example.com/pricing. Leave empty to keep it.
Titletitletext
A name to list it by. Leave empty to keep what it has.
Tagstagslist
Tags (groups) to file it under, by name, such as Competitors. Ones that don't exist are made. The watch's tags become these. Leave empty to keep what it has.
Check every (minutes)check_every_minutesnumber
How often to check the page, in minutes, such as 60 for hourly or 1440 for daily. Leave empty to keep it; 0 uses the default from changedetection.io's Settings.From 0 to 525600.
Only watch this partcss_filterlist
CSS selectors or XPath, one per line, such as #pricing or //table[1]: only that part of the page is compared. Leave empty to keep what it has.
Leave out these partsremove_elementslist
CSS selectors or XPath, one per line, of parts to leave out, such as a footer or an ad (.ads). Leave empty to keep what it has.
Ignore textignore_textlist
Text whose changes don't count, one per line, such as a visitor counter's label. A /regex/ works too. Leave empty to keep what it has.
Only when this text is theretrigger_textlist
Text that must be on the page for a change to count, one per line, such as In stock. A /regex/ works too. Leave empty to keep what it has.
Added lines countnotice_addedtrue/false
Whether lines added to the page count as a change. On unless you turn it off.
Removed lines countnotice_removedtrue/false
Whether lines removed from the page count as a change. Turn this off to hear only when text is added.
Changed lines countnotice_replacedtrue/false
Whether lines that changed count as a change. On unless you turn it off.
Only new linesunique_lines_onlytrue/false
Count a change only when a line appears that the page has never had before, such as a new item in a list.
Watch forwatch_typetext
Page text changes, or a product page's stock and price (Restock and price), which the restock and price triggers follow. Leave empty to keep it.One of: text (Page text changes), restock (Restock and price).

Outputs

check_every_minutesnumber
How often it's checked, in minutes; 0 when it uses the default from Settings
checksnumber
How many times it has been checked
createdtext
When it was added (ISO 8601)
css_filterlist
The CSS or XPath selectors it watches only the part of
currencytext
For a restock watch, the price's currency, such as USD
edit_linktext
A link to the watch's settings in changedetection.io
errortext
Why its last check failed; empty if it worked
history_linktext
A link to the watch's history of changes
ignore_textlist
Text whose changes it ignores
in_stocktrue/false
For a restock watch, whether the product is in stock; else null
last_changedtext
When the page last changed (ISO 8601); empty if it hasn't since it was added
last_checkedtext
When it was last checked (ISO 8601); empty if never
linktext
The address to open in a browser
mutedtrue/false
Whether its notifications are muted
nametext
What changedetection.io calls it: its title, else the page's own title, else its URL
notice_addedtrue/false
Whether added lines count as a change
notice_removedtrue/false
Whether removed lines count as a change
notice_replacedtrue/false
Whether changed lines count as a change
page_titletext
The page's own title, from its last check
pausedtrue/false
Whether it's paused, so it isn't checked
previous_pricenumber
For a restock watch, the price before its last price change
pricenumber
For a restock watch, the price found; else null
remove_elementslist
The CSS or XPath selectors of parts it leaves out
snapshotsnumber
How many snapshots of the page it has kept
tagslist
Its tags (groups), by name
titletext
The title given to the watch; empty if none
trigger_textlist
Text that must be on the page for a change to count
unique_lines_onlytrue/false
Whether only lines never seen on the page before count as a change
urltext
The address it watches
uuidtext
The watch's UUID
viewedtrue/false
Whether its last change has been looked at in changedetection.io
watch_typetext
What it watches for: text (the page's text) or restock (a product's stock and price)
Example output
{
  "check_every_minutes": 60,
  "checks": 97,
  "created": "2026-10-01T08:00:00Z",
  "css_filter": [
    "#pricing-table"
  ],
  "currency": "",
  "edit_link": "https://lemonade.changedetection.io/your-login/edit/cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "error": "",
  "history_link": "https://lemonade.changedetection.io/your-login/diff/cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "ignore_text": [],
  "in_stock": null,
  "last_changed": "2026-11-11T14:02:11Z",
  "last_checked": "2026-11-12T09:30:00Z",
  "link": "https://example.com/pricing",
  "muted": false,
  "name": "Pricing page",
  "notice_added": true,
  "notice_removed": true,
  "notice_replaced": true,
  "page_title": "Pricing - Example",
  "paused": false,
  "previous_price": null,
  "price": null,
  "remove_elements": [],
  "snapshots": 4,
  "tags": [
    "Competitors"
  ],
  "title": "Pricing page",
  "trigger_text": [],
  "unique_lines_only": false,
  "url": "https://example.com/pricing",
  "uuid": "cf501e5e-5064-47c4-b863-39d7ab521e9e",
  "viewed": false,
  "watch_type": "text"
}

On this page