# Netherlands Real Estate Scraper ($1/1K) (`carabain-digital/netherlands-real-estate`) Actor Search Huislijn and Pararius at once for huurwoningen and koopwoningen in the Netherlands. One search, one dataset: merged, deduplicated on postcode and house number, newest first. Optional details and price history. Proxy included. JSON, CSV, Excel. - **URL**: https://apify.com/carabain-digital/netherlands-real-estate.md - **Developed by:** [Carabain Digital](https://apify.com/carabain-digital) (community) - **Categories:** Real estate, Lead generation - **Security:** Limited permissions - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.75 / 1,000 listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ### What is Netherlands Real Estate Scraper? **Netherlands Real Estate Scraper** searches **two property portals in the Netherlands with one query** (Huislijn and Pararius) and returns one clean dataset of huurwoningen and koopwoningen: **merged, deduplicated across sites and sorted newest first**. Export as JSON, CSV or Excel. Costs **$1.00 per 1,000 listings** (plus a small start fee); full details are an add-on at $2 per 1,000 and price history at $1 per 1,000. A residential proxy is built in. - ๐ŸŒ **Two sites**: Huislijn and Pararius are searched in parallel; Huislijn is plain HTTP, Pararius needs a real browser (about 15 seconds for 20 listings) - ๐Ÿงน **Cross-site dedup**: the same home on several portals (same postcode, house number and listing type) appears once, with an `also_on` list of the other sites - ๐Ÿ“… **Newest first** across all sites, with a total **Max listings** cap and an optional cap per site - ๐ŸŽฏ **Pick the sites** you want under **Sites** - ๐Ÿ›ก๏ธ **A blocked or failing site never fails the run**: it is retried on a fresh proxy session, then skipped and logged; the others still deliver - ๐Ÿ“ˆ **Optional price history**: the same shared store as our single-site Actors - ๐Ÿค– **Agent friendly**: one flat schema for all sites, works through the Apify MCP server #### Which sites are included? | Site | Country | Single-site Actor | Default | Notes | |---|---|---|---|---| | [Huislijn](https://www.huislijn.nl) | Netherlands | [huislijn-listings](https://apify.com/carabain-digital/huislijn-listings) | yes | Fed by about 2,500 estate agents; up to about 10,000 per search; rentals hide the house number | | [Pararius](https://www.pararius.nl) | Netherlands | [pararius-listings](https://apify.com/carabain-digital/pararius-listings) | yes | Real browser behind Cloudflare, Dutch residential proxy; about 20 seconds per 30 listings; mostly rentals | **Results per site are capped by each site, not by this Actor** (Huislijn (about 10,000) and Pararius (about 100 pages of 30)). Asking for more returns what the site offers. Browser sites run one at a time (each opens its own browser), alongside the HTTP sites. #### What data can I extract?
๐Ÿ†” Stable listing ID, source site and URL๐Ÿ’ถ Asking price or monthly rent
๐Ÿ“ Address, postcode, city, region, country๐Ÿ  Property type, listing type and status
๐Ÿ“ Living area and plot area๐Ÿ› Rooms and bedrooms
โšก Energy label๐Ÿ“… Date listed
๐Ÿง‘โ€๐Ÿ’ผ Agent name, phone and link (where the site shows them)๐Ÿ–ผ Photos
๐Ÿ” also_on: other sites with the same home๐Ÿ“– Description, coordinates, build year (add-on)
Every site fills what it has; the rest is `null`. Site-specific extras are kept as extra fields. #### How do I scrape Dutch real estate? 1. [Create a free Apify account](https://console.apify.com/sign-up) and open this Actor. 2. Enter a **Location** (for example `Utrecht`) and choose **For sale** or **For rent**. 3. Optionally set price, property type, rooms, living area and **Max listings**. 4. Optionally change **Sites**, and switch on **Full details** and/or **Price history**. 5. Click **Start** and download the listings from the **Output** tab as JSON, CSV, Excel, XML or HTML. ### How much does it cost to scrape Dutch property sites? You **pay per home** that ends up in your dataset: **$1.00 per 1,000 unique listings**, after duplicates are removed, plus a start fee of $0.025 per GB of run memory (the image contains a browser for Pararius; the default 2 GB run costs $0.05 to start). No subscription, the proxy is included. - **Add-on: Full details, $2.00 per 1,000** listings, **off by default**. Charged only for listings that were actually enriched. One price for all sites. **Pararius details are best effort**: they are fetched inside the browser run, only for the listings it reached, and a bot wall can stop them early; those listings are not charged. - **Add-on: Price history, $1.00 per 1,000** listings, **off by default**. Charged only for listings that already had history (the first run is free). - The monthly credit of Apify's free plan covers thousands of listings. - You are charged for the listings in the dataset, not for the (more numerous) listings fetched before deduplication and the **Max listings** cut. Set a maximum cost per run in the run options. ### Input See the **Input** tab for all options. The shared fields are the same as in our single-site real-estate Actors, except Start URLs (they are site-specific: for those use the single-site Actors). | Field | Description | |---|---| | **Location** (`location`) | City or postcode, sent to every selected site. Commas run separate searches | | **Listing type** (`listing_type`) | `sale` (default) or `rent` | | **Min / Max price** (`min_price`, `max_price`) | Asking price, or rent per month, in euro | | **Property type** (`property_type`) | `any`, `house`, `apartment`, `studio`, `room`, `land`, `commercial`, `parking` | | **Min rooms** (`min_rooms`) | At least this many rooms | | **Min living area** (`min_living_area_m2`) | At least this many m2 | | **Sites** (`sites`) | `huislijn`, `pararius` (default: both) | | **Max listings** (`limit`) | Cap on the merged dataset; every site gets a fair share | | **Max listings per site** (`limit_per_site`) | Optional cap per site (default: Max listings) | | **Full details** (`includeDetails`) | Paid add-on: detail page data | | **Price history** (`trackHistory`, `historyStoreName`) | Paid add-on: history in your own named store | | **Proxy** (`proxyConfiguration`) | Apify RESIDENTIAL, country NL by default; the Actor applies it only to the sites that need it | Example input: ```json { "location": "Utrecht", "listing_type": "rent", "max_price": 2000, "limit": 100 } ``` #### Location All sites are in the Netherlands, so one location works everywhere. The Actor sends it to **every selected site as is**: - **Several places**: a comma list runs one search per place on every site (the per-site limit is divided over the places). A place that a site rejects is skipped for that site. - **No location** means everything on the selected sites. Country names are not accepted as location. - If **every** selected site rejects the input, the run fails with an input error so you notice. - Some filters differ per site: Pararius only knows `house`, `apartment`, `studio` and `room`, Huislijn has no `studio` or `room`; a site that does not know the property type is skipped. ### Output Listings are stored in the default dataset, one item per unique home. Export them as JSON, CSV, Excel, XML or HTML. Every site uses the same field names (`id` is `:`). Example (shortened): ```json { "id": "huislijn:1234567", "source": "huislijn", "url": "https://www.huislijn.nl/huurwoning/nederland/utrecht/1234567", "title": "Oudegracht 123", "listing_type": "rent", "property_type": "apartment", "status": "available", "price": 1750, "price_currency": "EUR", "price_period": "month", "postcode": "3511AB", "city": "Utrecht", "country": "NL", "living_area_m2": 62, "rooms": 3, "scraped_at": "2026-10-31T09:00:01Z", "also_on": [ "pararius" ] } ``` (shortened; all real-estate fields are present, `null` when the site has none. Values above are illustrative.) `status` is `available`, `under_offer`, `sold` or `rented`. #### How duplicates are removed Two listings are the same home when they have the same **postcode**, **house number (with addition)** and **listing type** (sale or rent), on different sites. The first one is kept (order: Huislijn, Pararius) and the other sites go in `also_on`. Listings without postcode or house number are never merged, and two listings of the same site are never merged (flats in one building). Huislijn rentals hide the house number, so Huislijn contributes few matches unless you switch on **Full details**. #### Sorting With **Max listings**, every site gets a fair share: listings are taken in turns from each site (each in its own newest-first order), so sites without exact dates are not pushed out. The result is then sorted newest first by `listed_at`; items without a date keep their site order. #### Price history: track price and status changes Switch on **Price history** (`trackHistory`) to follow listings over time. The Actor keeps a small history record per listing in a **named key-value store in your own Apify account** (default name `realestate-history`; change it with `historyStoreName`). We run no database and hold none of your data. - **Shared with the single-site Actors.** Our single-site real-estate Actors use the same default store name and listing IDs, so a listing tracked there continues its series here, and the other way round. - **The first run starts the series.** Listings seen for the first time are not charged for the add-on. - **Every later run** adds `first_seen_at`, `previous_price`, `price_change`, `price_change_pct`, `status_changed` and `price_history` (the last 20 points) to each listing you saw before. - **History runs once over the merged list**, after deduplication, so a home on two sites is tracked under the site it was kept from. - **Do not run two runs on the same store at the same time**: the last writer wins per record. If you delete the store, history silently starts empty. ### What can I do with Dutch real estate data? - ๐Ÿ“ˆ **Market research**: compare asking prices and rents per city and portal - ๐Ÿ”” **Alerts and feeds**: new listings and price drops to Slack, e-mail or your own site - ๐Ÿข **Investors and agents**: find new listings, compare price per m2, benchmark competitors - ๐Ÿง  **AI and analytics**: feed listing data into valuation models ### Tips for best results - Huislijn plus Pararius is the default: about 15 seconds for 40 listings. Pararius is a real browser, so a cold start can take longer; use **Max listings per site** to keep it short. - For a daily feed, schedule a run with a high **Max listings** and **Price history** on. - Leave **Full details** off for monitoring; switch it on when you need descriptions, coordinates or all photos. ### Frequently asked questions #### Can I use Netherlands Real Estate Scraper with the Apify API? Yes. Use the [Apify API](https://docs.apify.com/api/v2) or the Apify clients. Python: ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("carabain-digital/netherlands-real-estate").call(run_input={"location": "Utrecht", "listing_type": "rent", "max_price": 2000, "limit": 100}) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item["source"], item["title"]) ``` #### Can I use Netherlands Real Estate Scraper through an MCP server or with AI agents? Yes. Add the [Apify MCP server](https://mcp.apify.com) to your AI agent (Claude, ChatGPT, Cursor and others) and let it call `carabain-digital/netherlands-real-estate` with `call-actor`. The input is small and every field has a description, so an agent can fill it from a request such as "find the 20 newest rentals in Utrecht" (`location`, `listing_type`, `limit`). A small run finishes in seconds; the agent then reads the dataset with `get-dataset-items`. Add-ons are off by default, so an agent pays only the base price unless it asks for more. #### Can I integrate the data with other apps? Yes: Make, Zapier, Google Sheets, Slack, Airbyte and webhooks, via Apify's [integrations](https://apify.com/integrations). #### Why are there fewer listings than Max listings? Each site returns what matches your search, duplicates across sites are removed, and sites that do not know a filter are skipped. A narrow search or a site's own ceiling can leave you with fewer. #### Why does one site return nothing? Either it has no match for your search, or it was blocked and skipped after retries. The run log lists skipped sites. If **all** selected sites fail, the run fails so you notice. Try again later or open an issue. #### Is it legal to scrape property portals? The Actor only collects publicly visible listing data. Listings can contain personal data (for example an agent's name or phone number), and rules such as GDPR may apply to how you store and use it. Check your use case with a lawyer. See also [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/) #### Netherlands Real Estate Scraper not working? / Feedback Open an issue in the **Issues** tab of this Actor with the run link and the input you used; I usually answer within a few days. ### Other scrapers by us The two single-site Actors behind this one are linked in the table above: [huislijn-listings](https://apify.com/carabain-digital/huislijn-listings), [pararius-listings](https://apify.com/carabain-digital/pararius-listings). They are cheaper per home when you need one site only, and take search URLs. โญ **Does it work well for you?** A review on the Store page helps others find this Actor and helps us keep it maintained. # Actor input Schema ## `location` (type: `string`): Dutch city or postcode, sent to all selected sites. Several places separated by commas run as separate searches. Example: `Utrecht`, `Amsterdam, Rotterdam` or `3511`. Leave empty for all of the Netherlands. ## `listing_type` (type: `string`): Search homes `rent` or `sale`. Example: `rent`. ## `min_price` (type: `integer`): Lowest asking price in euro (rent per month for rentals). Example: `1000` (rent) or `250000` (sale). ## `max_price` (type: `integer`): Highest asking price in euro (rent per month for rentals). Example: `2000` (rent) or `500000` (sale). ## `property_type` (type: `string`): Only this type of property. Example: `apartment`. `any` returns every type. Pararius only knows house, apartment, studio and room; Huislijn has no studio or room. A site that does not know the type is skipped. ## `min_rooms` (type: `integer`): Only homes with at least this many rooms (kamers, living room included). Example: `3`. ## `min_living_area_m2` (type: `integer`): Only homes with at least this living area in square metres. Example: `60`. ## `sites` (type: `array`): Which sites to search. Default: Huislijn and Pararius. Example: `["huislijn", "pararius"]`. ## `limit` (type: `integer`): Cap on the merged dataset, newest first. Example: `100`. ## `limit_per_site` (type: `integer`): Optional cap per site, to keep the mix balanced and browser sites short. Default: Max listings. Example: `25`. ## `includeDetails` (type: `boolean`): Also open each listing's detail page on Huislijn and Pararius: description, coordinates, area, agent and more. Adds $2.00 per 1,000 listings that were actually enriched. Pararius fetches details inside its browser run and only for the listings it fetched (best effort: a bot wall can stop it early, those listings are not charged). Runs take longer. ## `trackHistory` (type: `boolean`): Keep a price and status history per listing in a named storage in your own account and add `first_seen_at`, `previous_price`, `price_change`, `price_change_pct`, `status_changed` and `price_history` to every listing you have scraped before. The history store is shared with our single-site real-estate Actors. Adds $1.00 per 1,000 listings that already had history (the first run only starts the series). Do not run two runs on the same store at once. ## `historyStoreName` (type: `string`): Name of the key-value store that holds the history (a-z, 0-9 and dashes). Use the same name in all our real-estate Actors to share one history. Example: `realestate-history`. ## `proxyConfiguration` (type: `object`): Keep Apify RESIDENTIAL (the default). The Actor sets the exit country to the Netherlands for Pararius and uses no proxy for Huislijn. ## Actor input object example ```json { "location": "Utrecht", "listing_type": "rent", "property_type": "any", "sites": [ "huislijn", "pararius" ], "limit": 20, "includeDetails": false, "trackHistory": false, "historyStoreName": "realestate-history", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "NL" } } ``` # Actor output Schema ## `listings` (type: `string`): All listings from the selected sites, merged and deduplicated, newest first. # 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 = { "location": "Utrecht", "listing_type": "rent", "sites": [ "huislijn", "pararius" ], "limit": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "NL" } }; // Run the Actor and wait for it to finish const run = await client.actor("carabain-digital/netherlands-real-estate").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 = { "location": "Utrecht", "listing_type": "rent", "sites": [ "huislijn", "pararius", ], "limit": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "NL", }, } # Run the Actor and wait for it to finish run = client.actor("carabain-digital/netherlands-real-estate").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "location": "Utrecht", "listing_type": "rent", "sites": [ "huislijn", "pararius" ], "limit": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "NL" } }' | apify call carabain-digital/netherlands-real-estate --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,carabain-digital/netherlands-real-estate" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/fGYtg9fj01ZZYTdcc/builds/c5ZMBx0oBqRb5d9pt/openapi.json