# Website Change Monitor & Structured Diff API (`blaidlink/website-change-intelligence`) Actor Website change monitor for up to 20 authorized public pages per run. Preserve caller-isolated baselines and receive structured sentence additions, removals, hashes, and change ratios for schedules, APIs, and AI agents. - **URL**: https://apify.com/blaidlink/website-change-intelligence.md - **Developed by:** [Blaidlink Labs](https://apify.com/blaidlink) (community) - **Categories:** Automation, Developer tools - **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 page monitoreds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Website Change Monitor & Structured Diff API Monitor up to 20 authorized public pages per run and turn meaningful text changes into structured evidence. This Actor stores a caller-isolated baseline, removes noisy page furniture, and returns additions, removals, hashes, and change ratios for schedules, APIs, and AI agents. ### Quick start For a zero-configuration smoke test, run the Actor with `{}`. It safely monitors `https://example.com/` and creates a caller-isolated baseline. Then replace the example URL with the authorized page you actually need to monitor. For a durable workflow: 1. Open the public [Track SaaS pricing page changes](https://apify.com/blaidlink/website-change-intelligence/examples/track-saas-pricing-page-changes) example and choose **Try for free**. 2. Run it once to create a private baseline in your Apify account. 3. Run the same Task again after the page changesโ€”or schedule itโ€”to receive `changed` or `unchanged` evidence in the same output schema. The public example monitors the authorized public `https://apify.com/pricing` page with `contentSelector` set to `main`. **Use the same saved Task for both runs** so it can find the caller-isolated baseline. The retired private Blaidlink Sites fixture is not part of the public example. #### What the two runs look like Run one creates evidence that the baseline exists and tells you exactly what to do next: ```json { "url": "https://example.com/pricing", "status": "baseline", "changed": false, "previousHash": null, "workflowStep": "baseline-created", "nextAction": "Run this same saved Task again to compare, or add a schedule for recurring checks." } ```` The next run uses the same output shape and returns either `changed` or `unchanged` evidence: ```json { "url": "https://example.com/pricing", "status": "changed", "changed": true, "changeRatio": 0.1667, "added": ["The Pro plan now costs $29 per month."], "removed": ["The Pro plan costs $19 per month."], "workflowStep": "comparison-complete", "nextAction": "Keep this saved Task scheduled to receive the next structured comparison." } ``` Each successful page check is one `$0.005` `page-monitored` event. The two single-page runs above therefore create `$0.01` in Blaidlink events total; Apify platform usage is separate. ### What it is for - Competitor pricing and product-page monitoring - Public RFP, policy, regulation, and documentation changes - Job and careers-page monitoring - Terms, feature, and availability changes - Supplying structured change events to AI agents through API or MCP The first run creates a baseline. Schedule the same Actor task to run hourly or daily; subsequent runs return `changed`, `unchanged`, `skipped`, or `error` results. ### Input | Field | Purpose | |---|---| | `startUrls` | Up to 20 public HTTP(S) pages | | `contentSelector` | CSS selector for the meaningful region, for example `main`, `#pricing`, or `.release-notes` | | `ignoreSelectors` | Volatile regions to remove before comparison | | `respectRobotsTxt` | Honors robots exclusions by default | | `resetBaseline` | Replaces old snapshots without reporting a change | | `includeUnchanged` | Emits successful unchanged checks when enabled | ### Output example ```json { "url": "https://example.com/pricing", "status": "changed", "changed": true, "changeRatio": 0.1667, "added": ["The Pro plan now costs $29 per month."], "removed": ["The Pro plan costs $19 per month."], "contentHash": "...", "previousHash": "...", "checkedAt": "2026-07-18T12:00:00.000Z" } ``` ### Persistent state and privacy Snapshots are stored in a named key-value store opened with the token of the user who starts the run. This isolates state in the caller's Apify account rather than mixing customer snapshots in the publisher's storage. ### Responsible use Only monitor pages you are authorized to access. The Actor blocks local/private-network targets, limits redirects and response sizes, identifies itself with a dedicated user agent, and honors `robots.txt` by default. Website terms, database rights, copyright, privacy rules, and rate limits still apply to you and the target. ### Recommended schedule Create an Actor Task with stable input and schedule it. Hourly checks work for fast-moving public pages; daily checks are more appropriate for documentation, policies, RFPs, and career pages. ### Pricing The live price is **$0.005 per `page-monitored` event**. A bounded 20-page run therefore creates up to **$0.10 in Blaidlink events**. Apify platform usage is billed separately by Apify. The Actor stops cleanly when the customer's maximum run charge is reached. ### Output views - **Monitoring overview** prioritizes status, page, change ratio, excerpt counts, check time, and errors. - **Change details** prioritizes the sentence-level additions and removals used by reviewers and downstream agents. # Actor input Schema ## `startUrls` (type: `array`): Public HTTP(S) pages you are authorized to monitor. Maximum 20 pages per run. ## `contentSelector` (type: `string`): Optional CSS selector for the page region that matters, such as main or #pricing. ## `ignoreSelectors` (type: `array`): Remove volatile areas such as navigation, cookie banners, timestamps, or ads before comparison. ## `respectRobotsTxt` (type: `boolean`): Skip pages disallowed for this Actor's user agent. Keep enabled unless you have explicit authorization. ## `includeUnchanged` (type: `boolean`): Return a result for every checked page instead of only baselines, changes, and errors. ## `resetBaseline` (type: `boolean`): Treat the current content as a new baseline without reporting an old-to-new change. ## `timeoutSecs` (type: `integer`): Maximum network time for each request. ## `maxContentChars` (type: `integer`): Caps stored text and comparison work to control runtime and storage costs. ## Actor input object example ```json { "startUrls": [ { "url": "https://example.com/" } ], "contentSelector": "main", "ignoreSelectors": [ "nav", "footer", "script", "style", "noscript" ], "respectRobotsTxt": true, "includeUnchanged": true, "resetBaseline": false, "timeoutSecs": 20, "maxContentChars": 100000 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://example.com/" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("blaidlink/website-change-intelligence").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://example.com/" }] } # Run the Actor and wait for it to finish run = client.actor("blaidlink/website-change-intelligence").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://example.com/" } ] }' | apify call blaidlink/website-change-intelligence --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=blaidlink/website-change-intelligence", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Website Change Monitor & Structured Diff API", "description": "Website change monitor for up to 20 authorized public pages per run. Preserve caller-isolated baselines and receive structured sentence additions, removals, hashes, and change ratios for schedules, APIs, and AI agents.", "version": "0.1", "x-build-id": "ZnCOSkdb9fKOWykfc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/blaidlink~website-change-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-blaidlink-website-change-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/blaidlink~website-change-intelligence/runs": { "post": { "operationId": "runs-sync-blaidlink-website-change-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/blaidlink~website-change-intelligence/run-sync": { "post": { "operationId": "run-sync-blaidlink-website-change-intelligence", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "startUrls": { "title": "Pages to monitor", "type": "array", "description": "Public HTTP(S) pages you are authorized to monitor. Maximum 20 pages per run.", "default": [ { "url": "https://example.com/" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "contentSelector": { "title": "Content CSS selector", "type": "string", "description": "Optional CSS selector for the page region that matters, such as main or #pricing.", "default": "main" }, "ignoreSelectors": { "title": "Ignore CSS selectors", "type": "array", "description": "Remove volatile areas such as navigation, cookie banners, timestamps, or ads before comparison.", "default": [ "nav", "footer", "script", "style", "noscript" ], "items": { "type": "string" } }, "respectRobotsTxt": { "title": "Respect robots.txt", "type": "boolean", "description": "Skip pages disallowed for this Actor's user agent. Keep enabled unless you have explicit authorization.", "default": true }, "includeUnchanged": { "title": "Include unchanged pages", "type": "boolean", "description": "Return a result for every checked page instead of only baselines, changes, and errors.", "default": true }, "resetBaseline": { "title": "Reset stored baseline", "type": "boolean", "description": "Treat the current content as a new baseline without reporting an old-to-new change.", "default": false }, "timeoutSecs": { "title": "Per-page timeout (seconds)", "minimum": 5, "maximum": 60, "type": "integer", "description": "Maximum network time for each request.", "default": 20 }, "maxContentChars": { "title": "Maximum normalized characters", "minimum": 1000, "maximum": 500000, "type": "integer", "description": "Caps stored text and comparison work to control runtime and storage costs.", "default": 100000 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```