# WOZ Waardeloket Scraper - Dutch Property Tax Values (`studio-amba/woz-waardeloket-scraper`) Actor Scrape Dutch property tax values (WOZ-waarden) from the official WOZ Waardeloket. Look up any Dutch address and get current and historical property valuations, reference dates, and municipality info. No login required. - **URL**: https://apify.com/studio-amba/woz-waardeloket-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## WOZ Waardeloket Scraper Scrape Dutch property tax values (WOZ-waarden) from the official WOZ Waardeloket (wozwaardeloket.nl). Look up any Dutch address and get current and historical property valuations with municipality and location data. No login or cookies required. ### How to scrape WOZ Waardeloket data 1. Go to [this actor's page](https://apify.com/store) on the Apify Store. 2. Click "Start" to open the input configuration. 3. Enter a Dutch address, street name, or postcode (e.g., "Keizersgracht Amsterdam" or "1012AB"). 4. Set the maximum number of results you want. 5. Choose whether to include historical WOZ values. 6. Click "Start" and wait for the scraper to finish. 7. Download your data in JSON, CSV, XML, or Excel format. ### What is the WOZ Waardeloket? The WOZ Waardeloket is the official Dutch government portal for looking up property tax values. WOZ stands for "Waardering Onroerende Zaken" (Valuation of Real Property). Every property in the Netherlands has a WOZ value determined annually by the municipality, used as the basis for property taxes, income tax deductions, and mortgage valuations. The WOZ value is set based on a reference date (peildatum) of January 1st of the previous year. For example, the 2024 WOZ value is based on property values as of January 1, 2023. ### How it works This scraper uses a two-step approach: 1. **Address resolution** — Uses the PDOK locatieserver (official Dutch government address API) to resolve your search query into specific addresses with unique identifiers. 2. **WOZ value extraction** — Queries the WOZ Waardeloket to retrieve property valuations for each resolved address. This approach ensures accurate address matching and reliable data extraction. ### Input parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `searchQuery` | string | "Keizersgracht Amsterdam" | Dutch address, street name, or postcode to look up | | `maxItems` | integer | 50 | Maximum number of valuations to return (1-500) | | `includeHistory` | boolean | true | Include WOZ values from previous years | | `proxyConfiguration` | object | Residential proxy | Proxy settings for reliable access | #### Example input ```json { "searchQuery": "Dorpsstraat 10 Utrecht", "maxItems": 20, "includeHistory": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` #### Search query examples - Full address: `"Keizersgracht 100 Amsterdam"` - Street + city: `"Dorpsstraat Utrecht"` - Postcode: `"1012AB"` - Postcode + number: `"1012AB 1"` - City only (returns many): `"Haarlem"` ### Output format Each result in the dataset contains: | Field | Type | Description | |-------|------|-------------| | `address` | string | Full display name of the address | | `street` | string | Street name | | `houseNumber` | string | House number (including letter/addition) | | `postcode` | string | Dutch postcode (e.g., "1012AB") | | `city` | string | City/town name | | `municipality` | string | Municipality (gemeente) name | | `province` | string | Province name | | `wozValue` | number | WOZ value in euros | | `referenceDate` | string | Valuation reference date (peildatum) | | `valuationYear` | number | Tax year the valuation applies to | | `objectType` | string | Property type (e.g., "woonfunctie") | | `nummeraanduidingId` | string | Official BAG address identifier | | `adresseerbaarObjectId` | string | Official BAG object identifier | | `latitude` | number | GPS latitude coordinate | | `longitude` | number | GPS longitude coordinate | | `url` | string | Link to WOZ Waardeloket | | `scrapedAt` | string | ISO timestamp of when data was collected | #### Example output ```json { "address": "Keizersgracht 100, 1015AA Amsterdam", "street": "Keizersgracht", "houseNumber": "100", "postcode": "1015AA", "city": "Amsterdam", "municipality": "Amsterdam", "province": "Noord-Holland", "wozValue": 685000, "referenceDate": "2023-01-01", "valuationYear": 2024, "objectType": "woonfunctie", "nummeraanduidingId": "0363200000161668", "adresseerbaarObjectId": "0363010000700332", "latitude": 52.3712, "longitude": 4.8867, "url": "https://www.wozwaardeloket.nl/", "scrapedAt": "2026-06-07T14:30:00.000Z" } ``` ### Use cases - **Real estate investment** — Compare property values across neighborhoods before buying. - **Market analysis** — Track property value trends in Dutch municipalities over time. - **Tax planning** — Verify your WOZ value for property tax (OZB) calculations. - **Property portfolios** — Monitor valuations across multiple properties at once. - **Academic research** — Analyze housing market dynamics with official government data. - **Mortgage assessment** — Compare WOZ values with asking prices for market analysis. - **Municipal comparisons** — Compare property values across different Dutch municipalities. ### Cost and performance - Typical run: 30-90 seconds for 20 addresses - Memory: 2048 MB recommended (Playwright browser) - Proxy: Residential proxy recommended for reliable access - Cost: approximately $0.05-0.15 per run depending on the number of addresses ### Tips for best results - Use specific addresses for exact results (e.g., "Dorpsstraat 10 Amsterdam") - Use postcodes for quick lookups of a specific area - Use street + city for multiple addresses on the same street - Set `includeHistory: true` to see how values changed over the years - The WOZ Waardeloket updates annually (new values published in February/March) ### Limitations - WOZ values are only available for the Netherlands - Some very new properties may not have WOZ values yet - The WOZ Waardeloket may occasionally be unavailable during maintenance - Maximum 500 addresses per run (PDOK API limitation) - Historical values typically go back 5-10 years depending on the municipality - Commercial properties may have limited public value disclosure ### Data sources - **PDOK Locatieserver** — Official Dutch government geocoding service for address resolution - **WOZ Waardeloket** — Official government portal maintained by the Waarderingskamer (Valuation Chamber) ### Legal and compliance All data scraped by this actor is publicly available government information. The WOZ Waardeloket explicitly provides this data for public access. Property valuations are public information under Dutch law (Wet WOZ, Article 40a). This actor only collects data that is freely accessible without any authentication or login. # Actor input Schema ## `searchQuery` (type: `string`): Dutch address or postcode to look up (e.g., 'Keizersgracht 1 Amsterdam', '1012AB', 'Dorpsstraat 10 Utrecht'). Leave empty to use the default example address. ## `maxItems` (type: `integer`): Maximum number of property valuations to return. ## `includeHistory` (type: `boolean`): Include WOZ values from previous years (multiple entries per address). ## `proxyConfiguration` (type: `object`): Proxy settings for the scraper. Residential proxies recommended for reliable access. ## Actor input object example ```json { "searchQuery": "Keizersgracht Amsterdam", "maxItems": 20, "includeHistory": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "searchQuery": "Keizersgracht Amsterdam", "maxItems": 20, "includeHistory": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/woz-waardeloket-scraper").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 = { "searchQuery": "Keizersgracht Amsterdam", "maxItems": 20, "includeHistory": True, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/woz-waardeloket-scraper").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 '{ "searchQuery": "Keizersgracht Amsterdam", "maxItems": 20, "includeHistory": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call studio-amba/woz-waardeloket-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/woz-waardeloket-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "WOZ Waardeloket Scraper - Dutch Property Tax Values", "description": "Scrape Dutch property tax values (WOZ-waarden) from the official WOZ Waardeloket. Look up any Dutch address and get current and historical property valuations, reference dates, and municipality info. No login required.", "version": "0.1", "x-build-id": "3gVMLcNjzaUyPfGyY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~woz-waardeloket-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-woz-waardeloket-scraper", "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/studio-amba~woz-waardeloket-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-woz-waardeloket-scraper", "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/studio-amba~woz-waardeloket-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-woz-waardeloket-scraper", "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": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Dutch address or postcode to look up (e.g., 'Keizersgracht 1 Amsterdam', '1012AB', 'Dorpsstraat 10 Utrecht'). Leave empty to use the default example address." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of property valuations to return.", "default": 50 }, "includeHistory": { "title": "Include Historical Values", "type": "boolean", "description": "Include WOZ values from previous years (multiple entries per address).", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for the scraper. Residential proxies recommended for reliable access.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```