# Belgium Real Estate Scraper ($0.80/1K) (`carabain-digital/belgium-real-estate`) Actor Search Zimmo, Immoweb and Immovlan at once for homes in Belgium (te koop, te huur). One search, one dataset: merged, deduplicated on postcode and house number, newest first. Optional full details and price history. Residential proxy included. Export to JSON, CSV or Excel. - **URL**: https://apify.com/carabain-digital/belgium-real-estate.md - **Developed by:** [Carabain Digital](https://apify.com/carabain-digital) (community) - **Categories:** Real estate, Lead generation - **Security:** Limited permissions - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.48 / 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 Belgium Real Estate Scraper? **Belgium Real Estate Scraper** searches **three property portals in Belgium with one query** (Zimmo, Immoweb and Immovlan) and returns one clean dataset of vastgoed (huizen and appartementen, te koop and te huur): **merged, deduplicated across sites and sorted newest first**. Export as JSON, CSV or Excel. Costs **$0.80 per 1,000 listings**; 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. - ๐ŸŒ **3 sites, one run**: Zimmo, Immoweb and Immovlan are searched in parallel, usually in seconds for 100 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 | |---|---|---|---|---| | [Zimmo](https://www.zimmo.be) | Belgium | [zimmo-listings](https://apify.com/carabain-digital/zimmo-listings) | yes | Up to about 9,950 results per search; search results already contain the full details | | [Immoweb](https://www.immoweb.be) | Belgium | [immoweb-listings](https://apify.com/carabain-digital/immoweb-listings) | yes | Largest Belgian portal; up to 9,960 per search; Belgian residential proxy; no listing date in search results | | [Immovlan](https://immovlan.be) | Belgium | [immovlan-listings](https://apify.com/carabain-digital/immovlan-listings) | yes | **At most 1,000 listings per query** (split by price bands above that); no street or date in search results | **Results per site are capped by each site, not by this Actor** (Zimmo, Immoweb and Immovlan (1,000 per query)). Asking for more returns what the site offers. #### 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 Belgian real estate? 1. [Create a free Apify account](https://console.apify.com/sign-up) and open this Actor. 2. Enter a **Location** (for example `Gent`) 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 Belgian property sites? You **pay per home** that ends up in your dataset: **$0.80 per 1,000 unique listings**, after duplicates are removed. 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. **Zimmo** already returns everything and is never 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`, `land`, `commercial`, `parking`, `room` | | **Min rooms** (`min_rooms`) | At least this many rooms (bedrooms on the Belgian sites) | | **Min living area** (`min_living_area_m2`) | At least this many m2 | | **Sites** (`sites`) | `zimmo`, `immoweb`, `immovlan` (default: `zimmo`, `immoweb`, `immovlan`) | | **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 BE by default; the Actor applies it only to the sites that need it | Example input: ```json { "location": "Gent", "listing_type": "sale", "max_price": 500000, "limit": 100 } ``` #### Location All sites are in Belgium, 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: only Zimmo knows `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": "zimmo:1234567", "source": "zimmo", "url": "https://www.zimmo.be/nl/gent-9000/te-koop/huis/ABCDE/", "title": "Korenlei 12A", "listing_type": "sale", "property_type": "house", "status": "available", "price": 485000, "price_currency": "EUR", "price_period": null, "address": "Korenlei 12A, 9000 Gent", "street": "Korenlei", "house_number": "12A", "postcode": "9000", "city": "Gent", "country": "BE", "living_area_m2": 165, "bedrooms": 3, "energy_label": "B", "listed_at": "2026-10-30T14:50:49Z", "scraped_at": "2026-10-30T15:20:01Z", "also_on": [ "immoweb" ] } ``` (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: Zimmo, Immoweb, Immovlan) 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). Immovlan search results have no house number, so it 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 Belgian 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 - All three sites are fast; 100 listings usually take a few seconds. - Immovlan returns at most 1,000 listings per query: split bigger searches by place or price range. - For a daily feed, schedule a run with a high **Max listings** and **Price history** on. - Need a search URL you built on one site? Use that site's own Actor ([zimmo-listings](https://apify.com/carabain-digital/zimmo-listings), [immoweb-listings](https://apify.com/carabain-digital/immoweb-listings), [immovlan-listings](https://apify.com/carabain-digital/immovlan-listings)). ### Frequently asked questions #### Can I use Belgium 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/belgium-real-estate").call(run_input={"location": "Gent", "listing_type": "sale", "max_price": 500000, "limit": 100}) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item["source"], item["title"]) ``` #### Can I use Belgium 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/belgium-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 apartments for rent in Gent" (`location`, `listing_type`, `property_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/) #### Belgium 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 three single-site Actors behind this one are linked in the table above: [zimmo-listings](https://apify.com/carabain-digital/zimmo-listings), [immoweb-listings](https://apify.com/carabain-digital/immoweb-listings), [immovlan-listings](https://apify.com/carabain-digital/immovlan-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`): Belgian city, municipality or postcode, sent to all selected sites. Several places separated by commas run as separate searches. Example: `Gent`, `Antwerpen, Gent` or `9000`. Leave empty for all of Belgium. ## `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. A site that does not know the type (only Zimmo has `room`) is skipped. ## `min_rooms` (type: `integer`): Only homes with at least this many bedrooms (Zimmo, Immoweb and Immovlan all count bedrooms). Example: `2`. ## `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: all of them. Example: `["zimmo", "immoweb", "immovlan"]`. ## `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 Immoweb and Immovlan: description, coordinates, area, agent and more. Adds $2.00 per 1,000 listings that were actually enriched. Zimmo already has everything in the search and is never 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 Belgium for Immoweb and uses no proxy for Zimmo and Immovlan. ## Actor input object example ```json { "location": "Gent", "listing_type": "sale", "property_type": "any", "sites": [ "zimmo", "immoweb", "immovlan" ], "limit": 20, "includeDetails": false, "trackHistory": false, "historyStoreName": "realestate-history", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "BE" } } ``` # 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": "Gent", "listing_type": "sale", "sites": [ "zimmo", "immoweb", "immovlan" ], "limit": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "BE" } }; // Run the Actor and wait for it to finish const run = await client.actor("carabain-digital/belgium-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": "Gent", "listing_type": "sale", "sites": [ "zimmo", "immoweb", "immovlan", ], "limit": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "BE", }, } # Run the Actor and wait for it to finish run = client.actor("carabain-digital/belgium-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": "Gent", "listing_type": "sale", "sites": [ "zimmo", "immoweb", "immovlan" ], "limit": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "BE" } }' | apify call carabain-digital/belgium-real-estate --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,carabain-digital/belgium-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/Fw0EorvDIEUhcKQIL/builds/AQen2BWeJCcBgcEni/openapi.json