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
| Action | What it does |
|---|---|
| Create tag | Make a tag (group) to file watches under, optionally given to every new watch whose URL matches a pattern. |
| 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. |
| Delete tag | Delete a tag (group). |
| Delete watch | Stop watching a page and delete its watch, with its history of changes. |
| 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. |
| 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. |
| Get snapshot | Get a page's text as changedetection.io saw it: its latest snapshot, or the one taken at a time. |
| 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. |
| 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. |
| Import URLs | Start watching a list of pages at once, one URL per line, with the tags you give. |
| List snapshots | List the snapshots changedetection.io kept of a page, the newest first: one each time it changed. |
| List tags | List the tags (groups) watches are filed under, with how many watches each has. |
| 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. |
| Mute watch | Mute a watch's notifications from changedetection.io. |
| Pause watch | Pause a watch, so it isn't checked until it's resumed. |
| Recheck all watches | Check every watch now, or those of one tag, or only the ones whose last check failed. |
| 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. |
| Resume watch | Resume a paused watch, so it's checked again on its schedule. |
| Search watches | Find watches whose URL or title has some text, of every tag or one. |
| Unmute watch | Turn a watch's notifications from changedetection.io back on. |
| Update tag | Rename a tag, change which new watches get it, or mute or unmute the notifications of all its watches. |
| Update watch | Change 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
- Name
titletextRequired - The tag's name, such as Competitors.
- Give to URLs like
url_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
- URL
urltextRequired - The page to watch, such as https://example.com/pricing.
- Title
titletext - A name to list it by. Leave empty to use the page's own title.
- Tags
tagslist - 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 part
css_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 parts
remove_elementslist - CSS selectors or XPath, one per line, of parts to leave out, such as a footer or an ad (.ads).
- Ignore text
ignore_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 there
trigger_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 count
notice_addedtrue/false - Whether lines added to the page count as a change. On unless you turn it off.
- Removed lines count
notice_removedtrue/false - Whether lines removed from the page count as a change. Turn this off to hear only when text is added.
- Changed lines count
notice_replacedtrue/false - Whether lines that changed count as a change. On unless you turn it off.
- Only new lines
unique_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 for
watch_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 paused
pausedtrue/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
- Tag
tagtextRequired - 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
- Watch
watchtextRequired - 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
- Since
sincedate and timeRequired - The start of the period, such as a week ago.
- Until
untildate and time - The end of the period. Leave empty for now.
- Tag
tagtext - Only watches with this tag (group), by name. Leave blank for every watch.
- Watches
watcheslist - Only these watches, by UUID, URL or title, when no tag is given.
- Each change
each_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 many
limitnumber - 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
- Watch
watchtextRequired - The watch: pick one, or use its UUID (from an earlier step), its exact URL or its title.
- From
from_snapshottext - previous (the snapshot before the latest), a snapshot's timestamp, or a date and time. Defaults to previous.
- To
to_snapshottext - latest, a snapshot's timestamp, or a date and time. Defaults to latest.
- Changed lines only
changes_onlytrue/false - Only the lines that changed, without the rest of the page. On unless you turn it off.
- Word by word
word_leveltrue/false - Mark the words that changed within a line, rather than whole lines.
- Ignore spacing
ignore_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
- Watch
watchtextRequired - The watch: pick one, or use its UUID (from an earlier step), its exact URL or its title.
- Snapshot
snapshottext - 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
- Watch
watchtextRequired - 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
- URLs
urlstextRequired - The pages to watch, one per line, such as https://example.com/news.
- Tags
tagslist - Tags (groups) to file them under, by name. Ones that don't exist are made.
- Skip URLs already watched
skip_duplicatestrue/false - Leave out URLs changedetection.io already watches. On unless you turn it off.
- Add paused
pausedtrue/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
- Watch
watchtextRequired - The watch: pick one, or use its UUID (from an earlier step), its exact URL or its title.
- How many
limitnumber - 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
- Tag
tagtext - Only watches with this tag (group), by name. Leave blank for every watch.
- Only failing
only_with_errorstrue/false - Only watches whose last check failed.
- Only unviewed changes
only_unviewedtrue/false - Only watches with a change nobody has looked at in changedetection.io yet.
- How many
limitnumber - 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
- Watch
watchtextRequired - 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
- Watch
watchtextRequired - 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
- Tag
tagtext - Only watches with this tag (group), by name. Leave blank for every watch.
- Only failing
only_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
- Watch
watchtextRequired - The watch: pick one, or use its UUID (from an earlier step), its exact URL or its title.
- Wait for the check
waittrue/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
- Watch
watchtextRequired - 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 for
querytextRequired - Text in the URL or title, such as example.com.
- Tag
tagtext - 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
- Watch
watchtextRequired - 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
- Tag
tagtextRequired - The tag (group): pick one, or type its name or UUID.
- New name
titletext - Its new name. Leave empty to keep it.
- Give to URLs like
url_match_patterntext - New watches whose URL matches get this tag. Leave empty to keep it.
- Muted
mutedtrue/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
- Watch
watchtextRequired - The watch: pick one, or use its UUID (from an earlier step), its exact URL or its title.
- URL
urltext - The page to watch, such as https://example.com/pricing. Leave empty to keep it.
- Title
titletext - A name to list it by. Leave empty to keep what it has.
- Tags
tagslist - 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 part
css_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 parts
remove_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 text
ignore_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 there
trigger_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 count
notice_addedtrue/false - Whether lines added to the page count as a change. On unless you turn it off.
- Removed lines count
notice_removedtrue/false - Whether lines removed from the page count as a change. Turn this off to hear only when text is added.
- Changed lines count
notice_replacedtrue/false - Whether lines that changed count as a change. On unless you turn it off.
- Only new lines
unique_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 for
watch_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"
}