# NL CAO Wijzigingen Database (`codeclouds/nl-cao-wijzigingen-database`) Actor Dutch collective labour agreement (CAO) changes, extracted from official Staatscourant algemeenverbindendverklaring publications. Structured per sector, with wage increase and validity extraction. - **URL**: https://apify.com/codeclouds/nl-cao-wijzigingen-database.md - **Developed by:** [Dennis](https://apify.com/codeclouds) (community) - **Categories:** Other, Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## NL CAO Wijzigingen Database 🇳🇱 Track **Dutch collective labour agreement (CAO) changes** as a structured, machine-readable feed — extracted directly from official Staatscourant *algemeenverbindendverklaring* (avv) publications. Every year, the Ministry of Social Affairs and Employment (SZW) publishes hundreds of decisions that make CAO provisions binding for an entire sector — new agreements, amendments, extensions, and revocations. Today, that information is only available through slow, API-less web portals (caobank.szw.nl, AWVN Cao-kijker, CAOWijzer) built for human browsing. This actor turns that public stream into clean, structured data: per-sector CAO name, publication type, validity period, and wage-increase percentages where mentioned in the text. ### Who is this for? - **Payroll & HR software vendors** who need to track CAO updates across sectors instead of following one at a time - **Salarisadministratiekantoren** monitoring multiple client sectors for wage table changes - **Employer & employee organisations** tracking sector-wide developments beyond their own CAO - **Legal & compliance teams** who need an audit trail of avv decisions affecting a sector - **Market researchers** analysing Dutch wage trends across industries - **AI agents** — clean, flat JSON output, ideal as a tool for agentic workflows (MCP-ready) ### What data do you get? Each result is one Staatscourant avv-publication: ```json { "id": "stcrt-2025-6395", "title": "Besluit van de Minister van Sociale Zaken en Werkgelegenheid van 19 maart 2025 tot wijziging van het besluit tot algemeenverbindendverklaring van bepalingen van de collectieve arbeidsovereenkomst Sociaal Werk, Welzijn & Maatschappelijke Dienstverlening", "recordType": "wijziging", "caoNaam": "Sociaal Werk, Welzijn & Maatschappelijke Dienstverlening", "ministerie": "Ministerie van Sociale Zaken en Werkgelegenheid", "publicatiedatum": "2025-03-25", "looptijd": "2025", "loonsverhogingen": [ { "percentage": 1.13, "datum": "1 januari 2025" } ], "urlHtml": "https://repository.overheid.nl/frbr/officielepublicaties/stcrt/2025/stcrt-2025-6395/1/html/stcrt-2025-6395.html", "urlXml": "https://repository.overheid.nl/frbr/officielepublicaties/stcrt/2025/stcrt-2025-6395/1/xml/stcrt-2025-6395.xml", "bron": "officielebekendmakingen", "sectorEerderGezien": false, "isWijzigingSignaal": true } ```` - **`recordType`** is derived from the publication's fixed legal phrasing — `nieuwe_avv` (fresh decision), `wijziging` (amendment), `verlenging` (extension), `intrekking` (revocation), or `verzoek` (pending request, decision not yet made) - **`caoNaam`** is the sector/CAO name — extracted from the title, or (for pending `verzoek` publications, which carry no sector name in the title) from the full-text body - **`looptijd`** and **`loonsverhogingen`** are best-effort extractions from the official full text — not every publication mentions a wage percentage (some only touch e.g. pension contributions), so these can be empty - **`isWijzigingSignaal`** is `true` for an explicit amendment/extension, or for a fresh avv covering a sector you've already seen in a previous run (only meaningful with `incrementalMode`) ### Input options | Field | Description | Example | |---|---|---| | `sectorKeyword` | Free-text filter on the full-text index | `"Bouw"`, `"Metaal"`, `"Horeca"` | | `publishedAfter` | Only publications from this date | `"2026-01-01"` | | `recordTypes` | Which publication types to include | `["nieuwe_avv", "wijziging"]` | | `maxResults` | Cap the number of results | `100` | | `incrementalMode` | Only new items since previous run + flag previously-seen sectors | `true` | ### Typical use cases **Daily monitoring feed for a payroll provider, wijziging-alerts only:** ```json { "recordTypes": ["wijziging", "verlenging"], "incrementalMode": true } ``` **Track one sector's CAO history:** ```json { "sectorKeyword": "Bouw & Infra", "maxResults": 50 } ``` **All new avv decisions since a given date:** ```json { "recordTypes": ["nieuwe_avv"], "publishedAfter": "2026-01-01" } ``` ### Scheduling & integrations - **Schedules** — run weekly and get only new/changed CAO publications - **Integrations** — push results to Google Sheets, Slack, Zapier, Make, or any webhook - **API** — fetch the dataset as JSON, CSV or Excel from your own code - **MCP** — expose this actor as a tool for AI agents (Claude, Cursor, and other MCP clients) ### Data source & legality This actor uses the **official public SRU API** of the Dutch government (KOOP / repository.overheid.nl), the same source behind zoek.officielebekendmakingen.nl and the Staatscourant. - ✅ No scraping of protected websites — official open data API only, no login, no ToS conflicts - ✅ Sector-wide agreements between employer and employee organisations — no personal data, no natural persons identified - ⚠️ `looptijd` and `loonsverhogingen` are extracted from free text with regular expressions. They are informational — always consult the official publication (`urlHtml`) for legally binding terms ### Pricing Pay per result: you are only charged for CAO records actually delivered, plus a small extra charge for each detected wijziging-alert (an amendment, extension, or a fresh avv for a sector you've seen before). ### FAQ **How fresh is the data?** Publications appear in the feed the same day SZW publishes them in the Staatscourant. **Why is `caoNaam` sometimes empty?** A small number of publications use non-standard title phrasing that doesn't match the sector-name pattern, and the full-text fallback also found nothing. This is rare — check `urlHtml` for the source in that case. **Why is `loonsverhogingen` often empty?** Not every avv decision changes wages — some only extend a CAO's term, or update non-wage clauses (pension contributions, working hours). An empty array is a normal, expected result. **How do I get only real changes, not pending requests?** Set `recordTypes` to exclude `"verzoek"` (a `verzoek` is a request awaiting a ministerial decision, not yet a finalized CAO change). ### Related Actors Also by this developer — Dutch/EU public-data actors that pair well with this one: - **[NL Vergunningen & Bekendmakingen Leadfeed](https://apify.com/codeclouds/nl-vergunningen-leadfeed)** — same official publication family, turned into commercial leads instead of HR/legal tracking. - **[NL & EU Government Tenders Scraper](https://apify.com/codeclouds/nl-eu-tenders-scraper)** — same "official government publication → structured feed" approach, applied to public procurement tenders. - **[PDOK Adres Geocoding & Buurtdata](https://apify.com/codeclouds/pdok-locatieserver)** — Dutch address geocoding and neighbourhood demographics, useful if you need to map sector activity geographically. *** *Zoekwoorden: cao database, cao wijzigingen, collectieve arbeidsovereenkomst monitor, algemeenverbindendverklaring scraper, cao loonsverhoging tracker, labour agreement Netherlands, cao sector monitoring.* ### Keywords cao, collective labour agreement, arbeidsvoorwaarden, avv, algemeenverbindendverklaring, hr, payroll, netherlands, wage tracker, labour law ### Changelog #### 2026-07-12 - Documentation update - Added a "Related Actors" section cross-linking other actors by this developer. #### 0.1.0 - Initial release - Structured CAO avv-publication feed from the official Staatscourant SRU API, with recordType classification (nieuwe\_avv, wijziging, verlenging, intrekking, verzoek), sector-name extraction, and best-effort looptijd/wage-increase parsing. # Actor input Schema ## `sectorKeyword` (type: `string`): Free-text filter on the full-text index, e.g. "Bouw", "Metaal", "Horeca", "Zorg". ## `publishedAfter` (type: `string`): Only publications from on/after this date (YYYY-MM-DD). ## `recordTypes` (type: `array`): Which title-derived publication types to include. ## `maxResults` (type: `integer`): Maximum number of CAO records to return (1-2000). Each result requires an extra full-text fetch, so keep this reasonable. ## `incrementalMode` (type: `boolean`): Only fetch publications newer than the previous run, and flag sectors seen before as a change signal. Ideal for scheduled monitoring. ## Actor input object example ```json { "recordTypes": [ "nieuwe_avv", "wijziging", "verlenging", "intrekking", "verzoek" ], "maxResults": 100, "incrementalMode": 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("codeclouds/nl-cao-wijzigingen-database").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 = {} # Run the Actor and wait for it to finish run = client.actor("codeclouds/nl-cao-wijzigingen-database").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 '{}' | apify call codeclouds/nl-cao-wijzigingen-database --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=codeclouds/nl-cao-wijzigingen-database", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "NL CAO Wijzigingen Database", "description": "Dutch collective labour agreement (CAO) changes, extracted from official Staatscourant algemeenverbindendverklaring publications. Structured per sector, with wage increase and validity extraction.", "version": "0.1", "x-build-id": "7LuQEGoYuxzOF9eoD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/codeclouds~nl-cao-wijzigingen-database/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-codeclouds-nl-cao-wijzigingen-database", "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/codeclouds~nl-cao-wijzigingen-database/runs": { "post": { "operationId": "runs-sync-codeclouds-nl-cao-wijzigingen-database", "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/codeclouds~nl-cao-wijzigingen-database/run-sync": { "post": { "operationId": "run-sync-codeclouds-nl-cao-wijzigingen-database", "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": { "sectorKeyword": { "title": "Sector Keyword", "type": "string", "description": "Free-text filter on the full-text index, e.g. \"Bouw\", \"Metaal\", \"Horeca\", \"Zorg\"." }, "publishedAfter": { "title": "Published After", "type": "string", "description": "Only publications from on/after this date (YYYY-MM-DD)." }, "recordTypes": { "title": "Record Types", "type": "array", "description": "Which title-derived publication types to include.", "items": { "type": "string", "enum": [ "nieuwe_avv", "wijziging", "verlenging", "intrekking", "verzoek", "overig" ], "enumTitles": [ "New avv decision", "Amendment to existing avv", "Extension of existing avv", "Revocation of avv", "Pending request (not yet decided)", "Other / unclassified" ] }, "default": [ "nieuwe_avv", "wijziging", "verlenging", "intrekking", "verzoek" ] }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of CAO records to return (1-2000). Each result requires an extra full-text fetch, so keep this reasonable.", "default": 100 }, "incrementalMode": { "title": "Incremental Mode", "type": "boolean", "description": "Only fetch publications newer than the previous run, and flag sectors seen before as a change signal. Ideal for scheduled monitoring.", "default": 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 } } } } } } } } } } ```