# EU Company Change Monitor EXPERT (`apixyz/eu-company-change-monitor`) Actor Watches a list of EU company domains on a schedule. Reads each company's imprint or legal page and reports changes to the VAT number, legal name, registered address, contact emails, and detected site technology. A failed fetch keeps stored history intact. From $0.006 per company checked. - **URL**: https://apify.com/apixyz/eu-company-change-monitor.md - **Developed by:** [Tarek Etman](https://apify.com/apixyz) (community) - **Categories:** Lead generation, Automation, Integrations - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event + usage 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 ## EU Company Change Monitor Watches a list of company domains and reports changes to what those companies publish about themselves. Each run reads the company's imprint or legal page, compares it with the stored result under your `monitorId`, and outputs only the rows that changed. A changed VAT number on a supplier invoice can cost you the input-VAT deduction. Outdated registered addresses invalidate contract records. This actor reports both on the next scheduled run after the company's own page shows them. ### What a run returns | `changeType` | Meaning | |---|---| | `BASELINE` | First reliable inspection of a domain on this watchlist | | `VAT_CHANGED` | The VAT number published on the legal page changed | | `LEGAL_NAME_CHANGED` | The published legal name changed | | `ADDRESS_CHANGED` | The published registered address changed | | `CONTACT_CHANGED` | Public contact emails changed | | `TECH_ADDED` / `TECH_REMOVED` | Detected site technology changed | | `PAGE_UNREACHABLE` | The page could not be read. Stored history stays intact | | `UNCHANGED` | Hidden by default. Set `fullReport` to true to include these | Rows with several simultaneous changes carry one primary `changeType` plus a `changes` array with every field delta, previous and current values included. ### Input ```json { "domains": [ { "domain": "sap.com", "label": "SAP" }, { "domain": "zalando.de", "label": "Zalando" } ], "monitorId": "suppliers", "webhookUrl": "https://hooks.zapier.com/..." } ```` Runs sharing a `monitorId` compare against each other. The optional HTTPS webhook receives one POST per run when change rows exist. VIES re-verification of found VAT numbers is available with `verifyVatWithVies` and is off by default. ### How pages are found The actor reads the homepage, follows the highest-ranked legal-page link (Impressum, legal notice, mentions lΓ©gales and equivalents in six languages), and also tries the well-known paths EU companies conventionally use, such as `/impressum` and `/legal-notice`. In live testing this resolved the correct imprint for sap.com and zalando.de and extracted their registered VAT numbers. ### Limits stated plainly Fields published as labeled text extract best. Legal names and addresses written as unlabeled prose can come back empty while the VAT number and contact emails still fill. A site that refuses datacenter traffic returns `PAGE_UNREACHABLE` and keeps its stored history; the proxy input accepts Apify Proxy settings including residential groups. ### Pricing $0.006 per company checked, $0.025 per change detected, $0.005 at actor start. A weekly watch on 100 suppliers runs about $0.61 per run, or roughly $2.65 per month at that cadence, before any change events. ### Related actors Verify a company list against the official VIES registry with [EU Company Enrichment](https://apify.com/maatdata/eu-company-enrichment-vat-verified). Watch the VAT number's registry validity itself with [EU VAT Status Monitor](https://apify.com/maatdata/eu-vat-status-monitor); it queries VIES while this actor reads the company's own website. *Built by MaatData.* # Actor input Schema ## `domains` (type: `array`): Company websites to monitor. Each item needs a domain; the label is echoed back in output rows for your own reference. ## `monitorId` (type: `string`): Runs with the same name share saved history. ## `fullReport` (type: `boolean`): Include unchanged domains in the dataset. ## `webhookUrl` (type: `string`): Receives one POST when a run detects company detail changes. ## `verifyVatWithVies` (type: `boolean`): Check an extracted VAT number against VIES during this run. ## `maxConcurrency` (type: `integer`): Number of domains fetched at the same time. ## `proxy` (type: `object`): Optional Apify Proxy settings used after a direct request fails. ## Actor input object example ```json { "domains": [ { "domain": "sap.com", "label": "SAP" }, { "domain": "zalando.de", "label": "Zalando" } ], "monitorId": "default", "fullReport": false, "verifyVatWithVies": false, "maxConcurrency": 4, "proxy": { "useApifyProxy": false } } ``` # 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 = { "domains": [ { "domain": "sap.com", "label": "SAP" }, { "domain": "zalando.de", "label": "Zalando" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("apixyz/eu-company-change-monitor").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 = { "domains": [ { "domain": "sap.com", "label": "SAP", }, { "domain": "zalando.de", "label": "Zalando", }, ] } # Run the Actor and wait for it to finish run = client.actor("apixyz/eu-company-change-monitor").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 '{ "domains": [ { "domain": "sap.com", "label": "SAP" }, { "domain": "zalando.de", "label": "Zalando" } ] }' | apify call apixyz/eu-company-change-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=apixyz/eu-company-change-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "EU Company Change Monitor EXPERT", "description": "Watches a list of EU company domains on a schedule. Reads each company's imprint or legal page and reports changes to the VAT number, legal name, registered address, contact emails, and detected site technology. A failed fetch keeps stored history intact. From $0.006 per company checked.", "version": "0.1", "x-build-id": "f0Hrgb11nEtETDcua" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apixyz~eu-company-change-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apixyz-eu-company-change-monitor", "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/apixyz~eu-company-change-monitor/runs": { "post": { "operationId": "runs-sync-apixyz-eu-company-change-monitor", "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/apixyz~eu-company-change-monitor/run-sync": { "post": { "operationId": "run-sync-apixyz-eu-company-change-monitor", "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", "required": [ "domains" ], "properties": { "domains": { "title": "Company domains to watch", "type": "array", "description": "Company websites to monitor. Each item needs a domain; the label is echoed back in output rows for your own reference.", "items": { "type": "object", "properties": { "domain": { "title": "Domain", "type": "string", "description": "Company website domain, for example sap.com. Scheme and www are optional." }, "label": { "title": "Label", "type": "string", "description": "Optional name for this company, echoed in every output row." } }, "required": [ "domain" ] } }, "monitorId": { "title": "Monitor name", "type": "string", "description": "Runs with the same name share saved history.", "default": "default" }, "fullReport": { "title": "Full report", "type": "boolean", "description": "Include unchanged domains in the dataset.", "default": false }, "webhookUrl": { "title": "Change webhook (https)", "pattern": "^https://.*", "type": "string", "description": "Receives one POST when a run detects company detail changes." }, "verifyVatWithVies": { "title": "Re-verify VAT with VIES", "type": "boolean", "description": "Check an extracted VAT number against VIES during this run.", "default": false }, "maxConcurrency": { "title": "Parallel domains", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of domains fetched at the same time.", "default": 4 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify Proxy settings used after a direct request fails.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```