cURL

# Compare previous snapshot to latest with colored HTML
curl -X GET "https://detect.coolify.vkuprin.com/api/v1/watch/095be615-a8ad-4c33-8e9c-c7612fbf6c9f/difference/previous/latest?format=htmlcolor" \
  -H "x-api-key: YOUR_API_KEY"

# Compare two specific timestamps in plain text with word-level diff
curl -X GET "https://detect.coolify.vkuprin.com/api/v1/watch/095be615-a8ad-4c33-8e9c-c7612fbf6c9f/difference/1640995200/1640998800?format=text&word_diff=true" \
  -H "x-api-key: YOUR_API_KEY"

# Show only additions (hide removed/replaced content), ignore whitespace
curl -X GET "https://detect.coolify.vkuprin.com/api/v1/watch/095be615-a8ad-4c33-8e9c-c7612fbf6c9f/difference/previous/latest?format=htmlcolor&removed=false&replaced=false&ignoreWhitespace=true" \
  -H "x-api-key: YOUR_API_KEY"

import requests

headers = {'x-api-key': 'YOUR_API_KEY'}
uuid = '095be615-a8ad-4c33-8e9c-c7612fbf6c9f'

# Compare previous to latest with colored HTML output
response = requests.get(
    f'https://detect.coolify.vkuprin.com/api/v1/watch/{uuid}/difference/previous/latest',
    headers=headers,
    params={'format': 'htmlcolor'}
)
print(response.text)

# Compare specific timestamps with word-level diff
from_ts = '1640995200'
to_ts = '1640998800'
response = requests.get(
    f'https://detect.coolify.vkuprin.com/api/v1/watch/{uuid}/difference/{from_ts}/{to_ts}',
    headers=headers,
    params={'format': 'text', 'word_diff': 'true'}
)
print(response.text)

# Show only additions, ignore whitespace and use word-level diff
response = requests.get(
    f'https://detect.coolify.vkuprin.com/api/v1/watch/{uuid}/difference/previous/latest',
    headers=headers,
    params={
        'format': 'htmlcolor',
        'type': 'diffWords',
        'removed': 'false',
        'replaced': 'false',
        'ignoreWhitespace': 'true'
    }
)
print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://detect.coolify.vkuprin.com/api/v1/watch/{uuid}/difference/{from_timestamp}/{to_timestamp}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

"<string>"

Watch History

Get the difference between two snapshots

Generate a difference (comparison) between two historical snapshots of a web page change monitor (watch).

This endpoint compares content between two points in time and returns the differences in your chosen format. Perfect for reviewing what changed between specific versions or comparing recent changes.

Timestamp Keywords:

Use 'latest' for the most recent snapshot (to_timestamp)
Use 'previous' for the second-most-recent snapshot (from_timestamp)
Or use specific Unix timestamps from the watch history

Format Options:

text (default): Plain text with (removed) and (added) prefixes
html: HTML format with (removed) and (added) text
htmlcolor: Rich HTML with colored highlights (green for additions, red for deletions)

Word-Level Diffing:

Enable word-level granularity with word_diff=true for detailed inline comparisons
Disable with word_diff=false for line-level comparisons only (default false/off, line-level mode by default)

Raw Diff Output:

Use no_markup=true to get raw diff content without any formatting applied
Returns content with placeholders for opening/closing tags of changes
Allows you to implement your own custom colorisation or formatting
Skips all HTML color application and service tweaks (added text, html color tags, etc)

GET

watch

{uuid}

difference

{from_timestamp}

{to_timestamp}

cURL

# Compare previous snapshot to latest with colored HTML
curl -X GET "https://detect.coolify.vkuprin.com/api/v1/watch/095be615-a8ad-4c33-8e9c-c7612fbf6c9f/difference/previous/latest?format=htmlcolor" \
  -H "x-api-key: YOUR_API_KEY"

# Compare two specific timestamps in plain text with word-level diff
curl -X GET "https://detect.coolify.vkuprin.com/api/v1/watch/095be615-a8ad-4c33-8e9c-c7612fbf6c9f/difference/1640995200/1640998800?format=text&word_diff=true" \
  -H "x-api-key: YOUR_API_KEY"

# Show only additions (hide removed/replaced content), ignore whitespace
curl -X GET "https://detect.coolify.vkuprin.com/api/v1/watch/095be615-a8ad-4c33-8e9c-c7612fbf6c9f/difference/previous/latest?format=htmlcolor&removed=false&replaced=false&ignoreWhitespace=true" \
  -H "x-api-key: YOUR_API_KEY"

import requests

headers = {'x-api-key': 'YOUR_API_KEY'}
uuid = '095be615-a8ad-4c33-8e9c-c7612fbf6c9f'

# Compare previous to latest with colored HTML output
response = requests.get(
    f'https://detect.coolify.vkuprin.com/api/v1/watch/{uuid}/difference/previous/latest',
    headers=headers,
    params={'format': 'htmlcolor'}
)
print(response.text)

# Compare specific timestamps with word-level diff
from_ts = '1640995200'
to_ts = '1640998800'
response = requests.get(
    f'https://detect.coolify.vkuprin.com/api/v1/watch/{uuid}/difference/{from_ts}/{to_ts}',
    headers=headers,
    params={'format': 'text', 'word_diff': 'true'}
)
print(response.text)

# Show only additions, ignore whitespace and use word-level diff
response = requests.get(
    f'https://detect.coolify.vkuprin.com/api/v1/watch/{uuid}/difference/previous/latest',
    headers=headers,
    params={
        'format': 'htmlcolor',
        'type': 'diffWords',
        'removed': 'false',
        'replaced': 'false',
        'ignoreWhitespace': 'true'
    }
)
print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://detect.coolify.vkuprin.com/api/v1/watch/{uuid}/difference/{from_timestamp}/{to_timestamp}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

"<string>"

Authorizations

x-api-key

string

header

required

API key for authentication. You can find your API key in the Site Spy dashboard under Settings → API.

Path Parameters

uuid

string<uuid>

required

Web page change monitor (watch) unique ID

from_timestamp

required

Starting snapshot timestamp, 'previous' for second-most-recent, or specific Unix timestamp Unix timestamp of the starting snapshot

to_timestamp

required

Ending snapshot timestamp, 'latest' for most recent, or specific Unix timestamp Unix timestamp of the ending snapshot

Query Parameters

format

enum<string>

default:text

Output format for the diff:

text (default): Plain text with (removed) and (added) prefixes
html: Basic HTML format
htmlcolor: Rich HTML with colored backgrounds (red for deletions, green for additions)
markdown: Markdown format with HTML rendering

Available options:

text,

html,

htmlcolor,

markdown

word_diff

enum<string>

default:false

Enable word-level diffing for more granular comparisons. When enabled, changes are highlighted at the word level rather than line level. Default is false (line-level mode). Accepts: true, false, 1, 0, yes, no, on, off

Available options:

true,

false,

1,

0,

yes,

no,

on,

off

no_markup

enum<string>

default:false

When set to true, returns the raw diff content without any markup formatting. The content will include placeholders for opening/closing tags of the changes, allowing you to implement your own custom colorisation or formatting. This skips all HTML color application and service tweaks. Accepts: true, false, 1, 0, yes, no, on, off

Available options:

true,

false,

1,

0,

yes,

no,

on,

off

type

enum<string>

default:diffLines

Diff granularity type:

diffLines (default): Line-level comparison, showing which lines changed
diffWords: Word-level comparison, showing which words changed within lines

This parameter is an alternative to word_diff for better alignment with the UI. If both are specified, type=diffWords will enable word-level diffing.

Available options:

diffLines,

diffWords

changesOnly

enum<string>

default:true

When enabled, only show lines/content that changed (no surrounding context). When disabled, include unchanged lines for context around changes. Accepts: true, false, 1, 0, yes, no, on, off

Available options:

true,

false,

1,

0,

yes,

no,

on,

off

ignoreWhitespace

enum<string>

default:false

When enabled, ignore whitespace-only changes (spaces, tabs, newlines). Useful for focusing on content changes and ignoring formatting differences. Accepts: true, false, 1, 0, yes, no, on, off

Available options:

true,

false,

1,

0,

yes,

no,

on,

off

removed

enum<string>

default:true

Include removed/deleted content in the diff output. When disabled, content that was deleted will not appear in the diff. Accepts: true, false, 1, 0, yes, no, on, off

Available options:

true,

false,

1,

0,

yes,

no,

on,

off

added

enum<string>

default:true

Include added/new content in the diff output. When disabled, content that was added will not appear in the diff. Accepts: true, false, 1, 0, yes, no, on, off

Available options:

true,

false,

1,

0,

yes,

no,

on,

off

replaced

enum<string>

default:true

Include replaced/modified content in the diff output. When disabled, content that was modified (changed from one value to another) will not appear in the diff. Accepts: true, false, 1, 0, yes, no, on, off

Available options:

true,

false,

1,

0,

yes,

no,

on,

off

Response

Formatted diff between the two snapshots

Plain text diff with change markers

Get watch history Get single snapshot

⌘I

Getting Started

Endpoints

Get the difference between two snapshots

Authorizations

Path Parameters

Query Parameters

Response