MarkUDown

Change Detection API — MarkUDown website change docs

POST/api/change-detection

Change Detection

Detect whether a URL's content has changed since it was last checked. Great for monitoring competitor pricing pages, news sites, or product inventory.

ParameterTypeRequiredDefaultDescription
urlstringrequired—URL to check.
main_contentbooleanoptionaltrueCompare only the main content (ignores navigation and footer changes).
include_diffbooleanoptionaltrueInclude the current (and, when changed, previous) Markdown in the response.
timeoutintegeroptional60Page load timeout in seconds.
callback_urlstringoptionalnullWebhook URL to POST the result to when the job completes.

Request

{
  "url": "https://store.example.com/pricing",
  "main_content": true,
  "include_diff": true
}

Response

// POST returns { "success": true, "id": "abc123", "url": "/api/change-detection/abc123" }
// Poll GET /api/change-detection/{id} — "data" when completed:
{
  "success": true,
  "data": {
    "url": "https://store.example.com/pricing",
    "changed": true,
    "previous_hash": "abc123",
    "current_hash": "def456",
    "previous_markdown": "Price: $299",
    "current_markdown": "Price: $249",
    "first_check": false,
    "checked_at": "2026-04-22T14:30:00Z"
  }
}