# Immoweb Scraper ($0.85/1K) - Belgian Property Listings (`carabain-digital/immoweb-listings`) Actor Scrape real-estate listings from Immoweb (immoweb.be), Belgium's biggest property portal: houses, apartments, land and commercial property for sale and for rent. Filter by city, postcode or province, price, bedrooms, area and type. Newest first, with old price. Add-on: full details with agent phone. - **URL**: https://apify.com/carabain-digital/immoweb-listings.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.35 / 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 Immoweb Listings Scraper? **Immoweb Listings Scraper** scrapes **property listings from Immoweb ([immoweb.be](https://www.immoweb.be))**, the biggest property portal in Belgium, with more than 50,000 houses for sale alone plus apartments, land and rentals from agents, developers and private sellers. Search by **city or postcode, sale or rent, property type, price range, bedrooms and living area**, or paste a search URL from the site, and get clean, flat listing data as JSON, CSV, Excel, XML or HTML: price, address, coordinates, living and plot area, bedrooms, EPC label, agent contact, photos and description. Prefilled example: the 20 newest properties for sale in Gent, ready in seconds. Costs **$0.85 per 1,000 listings**. Add-ons: **Full details** (description, construction year, bathrooms, agent phone and more) and **Price history** (price changes over time), $2.00 and $1.00 per 1,000 listings. - 🔎 **Search like on the site**: city, postcode or province, sale or rent, property type, price range, bedrooms, living area, or paste an Immoweb search URL - ⚡ **Fast**: Immoweb's own JSON search, 60 listings per request, newest first, no browser - 💶 **Old price included**: listings that dropped their price carry the previous price in `old_price` - 📚 **Full details on demand**: switch on **Full details** for the description, construction year, bathrooms, publication date, agent phone and all photos - 📈 **Track prices over time**: switch on **Price history** to compare every run with the last one - 🔌 **Connect anywhere**: API, schedules, webhooks, Google Sheets, Make, Zapier, MCP / AI agents #### What data can I extract from Immoweb?
🆔 Stable listing ID and URL💶 Price (sale) or monthly rent
📍 Address, postcode, city, province🧭 Latitude and longitude
🏠 Property type and subtype📐 Living area and plot area (m²)
🛏️ Bedrooms and bathrooms⚡ EPC energy label
🏷️ Status: available, under offer, sold, rented📅 Listed and last-updated date
🏢 Agent name, phone and website📷 Photo URLs
📝 Description💶 Previous price and rental charges
The search results carry price, address, coordinates, areas, bedrooms, EPC label, agent name and a few photos. **Description, construction year, bathrooms, publication date, agent phone and website** and the full photo set come from the listing page and are only filled with the **Full details** add-on. `rooms` is only filled when the agent entered a room count, and `title` is rarely set on Immoweb. #### How do I scrape Immoweb listings? 1. [Create a free Apify account](https://console.apify.com/sign-up) and open this Actor. 2. Enter a **Location** (for example `Gent` or `9000`), pick **Sale or rent** and, if you like, a property type and price range. Or paste one or more **Search URLs** copied from immoweb.be. 3. Set **Max listings** (the newest come first). 4. Click **Start**, then download the listings from the **Output** tab as JSON, CSV, Excel, XML or HTML. #### How much does it cost to scrape Immoweb? You pay per listing that ends up in your dataset: **$0.85 per 1,000 listings**, no subscription. The monthly credit of Apify's Free plan ($5) covers around 5,900 listings without add-ons. Paid plans get volume discounts. - **Add-on: Full details, $2.00 per 1,000 listings** (off by default). Opens every listing's page and adds the description, construction year, bathrooms, publication date (`listed_at`), agent phone and website, all photos and the exact status. Charged only for listings that were actually enriched. - **Add-on: Price history, $1.00 per 1,000 listings** (off by default). Adds `first_seen_at`, `previous_price`, `price_change`, `price_change_pct`, `status_changed` and `price_history`. Charged only for listings that already had history from an earlier run, so the first run is free. See the *Price history* section below. - Failed runs and empty searches cost nothing; you can cap spending with **Maximum cost per run** in the run options. See the **Pricing** tab for the current prices. #### ⬇️ Input | Field | Description | |---|---| | **Location** (`location`) | City, municipality, province or postcode; several separated by commas | | **Sale or rent** (`listing_type`) | `sale` or `rent` | | **Property type** (`property_type`) | `any`, `house`, `apartment`, `land`, `commercial`, `parking` | | **Minimum / maximum price** (`min_price`, `max_price`) | In euro; for rentals per month | | **Minimum bedrooms** (`min_rooms`) | Number of bedrooms | | **Minimum living area** (`min_living_area_m2`) | In m²; listings without a known area are left out | | **Search URLs** (`start_urls`) | Search pages copied from immoweb.be; they replace the filters above | | **Max listings** (`limit`) | Stop after this many listings | | **Full details** (`includeDetails`) | Paid add-on: description, agent phone, construction year and more | | **Price history** (`trackHistory`) | Paid add-on: compare with your previous runs | | **History store name** (`historyStoreName`) | Where the history is kept (default `realestate-history`) | | **Proxy** (`proxyConfiguration`) | Belgian residential proxy, preselected (Apify Residential, country BE). Immoweb blocks datacenter IPs | ```json { "location": "Gent", "listing_type": "sale", "limit": 20 } ``` Immoweb needs a Belgian residential proxy: the default is already set. With **Search URLs** paste a page like `https://www.immoweb.be/en/search/house/for-sale/gent/9000?minPrice=200000`; filters in the URL are kept and the page number is ignored. **Location** accepts a city (all its sub-municipalities are included), a postcode or a province, as on the site. There is no room/kot type on Immoweb. #### ⬆️ Output Listings are stored in the default dataset, newest first. View them as a table in the **Output** tab or export JSON, CSV, Excel, XML or HTML. Fields a listing does not have are `null`; every item has the same keys. ##### A listing with the Full details add-on (rental) ```json { "id": "immoweb:21954873", "source": "immoweb", "url": "https://www.immoweb.be/en/classified/apartment/for-rent/antwerpen/2000/21954873", "title": "Flat", "listing_type": "rent", "property_type": "apartment", "property_subtype": "apartment", "status": "available", "price": 900, "price_currency": "EUR", "price_period": "month", "price_type": "asking", "old_price": null, "monthly_costs": 110, "address": "Amerikalei 91 4, 2000 ANTWERPEN", "street": "Amerikalei", "house_number": "91 4", "postcode": "2000", "city": "ANTWERPEN", "region": "Antwerp", "country": "BE", "lat": 51.2069148, "lon": 4.3974303, "living_area_m2": 72, "plot_area_m2": null, "rooms": null, "bedrooms": 2, "bathrooms": 1, "energy_label": "C", "construction_year": 1968, "listed_at": "2026-10-30T10:04:19.760Z", "updated_at": "2026-10-30T11:36:58.845Z", "agent_name": "Abricasa", "agent_phone": "+3232590404", "agent_url": null, "image_urls": [ "https://media-resize.immowebstatic.be/classifieds/629484bd-7e96-4a34-af1f-4f0f8a3b9835/2560x1440/72916ef644f06155e5d7a7ab5d52e693.jpg", "https://media-resize.immowebstatic.be/classifieds/629484bd-7e96-4a34-af1f-4f0f8a3b9835/2560x1440/778461adc06f55df6352cb504b2a5853.jpg", "..." ], "description": "Surf naar www.abricasa.be en plan jouw verhuurafspraak in samen met onze digitale assistente Alice!\n\nFijn appartement met 2 slaapkamers op 't Zuid!\n\nVia de lift/trap bereik je het appartement op de 3e verdieping. Vooraan bevindt zich de ruime en lichtrijke ...", "scraped_at": "2026-10-30T14:58:50Z" } ``` ##### Extra fields with the Price history add-on ```json { "first_seen_at": "2026-10-23T07:00:12+00:00", "previous_price": 575000, "price_change": -25000, "price_change_pct": -4.35, "status_changed": false, "price_history": [ { "at": "2026-10-23T07:00:12+00:00", "price": 575000, "status": "available" }, { "at": "2026-10-30T07:00:09+00:00", "price": 550000, "status": "available" } ] } ``` #### What can I do with Immoweb data? - 📉 **Price drop alerts**: schedule a run with **Price history** and get notified when `price_change` is negative - 🏘️ **Market research**: asking prices per m² per postcode, new supply per week, time on market - 🔎 **Deal finding and investment**: filter by price, area and EPC label, compare rent and sale prices per neighbourhood - 📇 **Lead generation**: agents and notaries with their active listings per region - 🧠 **AI and analytics**: feed descriptions and attributes into valuation models or LLM pipelines #### Tips for best results - **Immoweb shows at most about 9,960 results per search** (333 pages of 60). To collect more, split the search by postcode or by price range and run them as separate searches or several **Search URLs**. - Results come in Immoweb's "newest" order, which follows the last modification: a listing whose price just changed or that was re-activated comes first (roughly, not strictly by date), which is what you want for monitoring. - For a daily feed, schedule a run with a high **Max listings** and **Price history** switched on. - Leave **Full details** off for counting, price monitoring and market research; switch it on when you need descriptions or agent phone numbers. - New-build projects appear as one listing with `price_type` `from` (the lowest price of the project). - Results from one run are deduplicated by listing ID. #### Price history Switch on **Price history** (`trackHistory`) and the Actor remembers every listing between runs, so you can see price drops, status changes and how long a property has been on the market. - **Where it lives.** History is kept in a *named key-value store in your own Apify account* (default name `realestate-history`, change it with **History store name**). Named stores never expire, you own the data, and storage costs a fraction of a cent. - **First run starts the series.** The first time a listing is seen there is nothing to compare with, so `previous_price` is `null` and you are not charged for the add-on on that listing. From the second run on, each listing gets `first_seen_at`, `previous_price`, `price_change`, `price_change_pct`, `status_changed` and `price_history` (the last 20 price/status points, one point per change). - **Run it on a schedule.** History only grows when you run the Actor. Create a [schedule](https://docs.apify.com/platform/schedules) (daily is typical) with the same search and the same store name. - **One store, several Actors.** Every real-estate Actor we publish uses the same default store name, so a listing keeps one history even if you scrape it with a different one of our Actors. Item IDs start with the site (`immoweb:...`), so sites never clash. Use a different store name per search if you want separate series. - **Do not run two runs on the same store at the same time.** Records are updated per listing and the last writer wins, so two parallel runs can overwrite each other's newest point. Run searches that share a store one after another. - **If you delete the store,** the Actor starts a new empty history without an error. - **Cost:** $1.00 per 1,000 listings that already had history (see pricing above). - Immoweb also marks recent price changes itself: `old_price` holds the previous price on listings the agent reduced. It is free and always on, but it is only the last change; **Price history** keeps every change you saw. #### Frequently asked questions #### Can I use Immoweb Listings Scraper with the Apify API? Yes. Every run has a dataset you can read through the [Apify API](https://docs.apify.com/api/v2). Python: ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("carabain-digital/immoweb-listings").call(run_input={ "location": "Gent", "listing_type": "sale", "property_type": "house", "max_price": 450000, "limit": 100, }) for home in client.dataset(run["defaultDatasetId"]).iterate_items(): print(home["price"], home["address"], home["living_area_m2"], "m2") ``` JavaScript: ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: '' }); const run = await client.actor('carabain-digital/immoweb-listings').call({ location: 'Gent', listing_type: 'sale', property_type: 'house', max_price: 450000, limit: 100, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items.length, 'listings'); ``` #### Can I use Immoweb Listings Scraper through an MCP server or with AI agents? Yes. Add it to an AI agent through the [Apify MCP server](https://mcp.apify.com) (`https://mcp.apify.com?tools=carabain-digital/immoweb-listings`), or let the agent find it with `search-actors` and run it with `call-actor`. A small search (`limit` 20) finishes in a few seconds, and the items are flat and small, so agents can read them with `get-dataset-items`. Example prompt: *"Use Immoweb Listings Scraper to list the 20 newest apartments for rent in Antwerp under 1,500 euro and tell me which have an A or B energy label."* #### Can I integrate Immoweb data with other apps? Yes: Google Sheets, Slack, Make, Zapier, n8n, Airtable or your own webhook, through Apify [integrations](https://apify.com/integrations) and [webhooks](https://docs.apify.com/platform/integrations/webhooks). Schedule a run every morning and send the new listings or price drops to your inbox or CRM. #### Why do I need a proxy? Immoweb is behind Cloudflare and blocks datacenter IP addresses. The Actor therefore defaults to Apify's residential proxy in Belgium. If a run is blocked it retries once on a fresh proxy session; if it still fails the run fails with a clear message instead of returning an empty dataset. #### Why is a field empty? Without **Full details**, `description`, `construction_year`, `bathrooms`, `listed_at`, `agent_phone` and `agent_url` are `null`: Immoweb only publishes them on the listing page. Some listings also have no area, room count or EPC label, and private sellers have no `agent_name`. #### What does `old_price` mean? When an agent lowers (or changes) the asking price, Immoweb keeps the previous price and flags the listing as a new price. `old_price` carries that previous price; it is `null` for listings without a recent price change. #### Does it cover sold and rented properties? No. Immoweb search results only list what is currently for sale or for rent. `status` is `under_offer` for listings marked "under option"; with **Full details** it is also set to `sold` or `rented` when the page says so. #### Is it legal to scrape Immoweb? The Actor only collects publicly visible listings, the same data anyone can see on immoweb.be. Listings can contain personal data (for example the name or phone number of a private seller or agent), and rules such as GDPR may apply to how you store and use it. Check your use case with a lawyer. More background: [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/) #### Immoweb Listings Scraper not working? Feedback Open an issue on the **Issues** tab of this Actor with the run link and we will look at it. Feature ideas are welcome there too. #### Other scrapers by us | Actor | Covers | |---|---| | [Zimmo Listings Scraper](https://apify.com/carabain-digital/zimmo-listings) | Belgium: zimmo.be, houses and apartments for sale and rent, with the site's own price history | | [Immovlan Listings Scraper](https://apify.com/carabain-digital/immovlan-listings) | Belgium: immovlan.be | | [Huislijn Listings Scraper](https://apify.com/carabain-digital/huislijn-listings) | Netherlands: huislijn.nl | | [Pararius Listings Scraper](https://apify.com/carabain-digital/pararius-listings) | Netherlands: pararius.nl, rentals and sales | | [Belgium Real Estate Scraper](https://apify.com/carabain-digital/belgium-real-estate) | Zimmo, Immoweb and Immovlan in one run, merged and deduplicated | ⭐ **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, province or postcode. Several values separated by commas (all postcodes or all names). Example: `Gent`, `Antwerpen` or `9000, 9050`. Leave empty for all of Belgium. Ignored when you give search URLs. ## `listing_type` (type: `string`): `sale` for properties to buy, `rent` for rentals. Example: `rent`. ## `property_type` (type: `string`): Type of property. `any` = houses and apartments. Example: `apartment`. ## `min_price` (type: `integer`): Lowest price in euro (rent: per month). Example: `200000`, for rent `800`. ## `max_price` (type: `integer`): Highest price in euro (rent: per month). Example: `450000`, for rent `1500`. ## `min_rooms` (type: `integer`): Minimum number of bedrooms. Example: `2`. ## `min_living_area_m2` (type: `integer`): Minimum living area in square metres. Listings without a known area are left out when this is set. Example: `80`. ## `start_urls` (type: `array`): Search result pages copied from immoweb.be; they replace the filters above. Example: `https://www.immoweb.be/en/search/house/for-sale/gent/9000?minPrice=200000`. Filters in the URL (price, bedrooms, surface) are kept. Leave empty to use the filters above. ## `limit` (type: `integer`): Stop after this many listings (newest first). Example: `100`. Immoweb shows at most about 9,960 results per search (333 pages): use a postcode or price range to go deeper. ## `includeDetails` (type: `boolean`): Also open each listing's page: full description, construction year, bathrooms, publication date, agent phone and website, all photos and the exact status. Adds $1.00 per 1,000 listings on top of the base price. One extra request per listing, so runs take longer. ## `trackHistory` (type: `boolean`): Keep the price and status of every listing in a named store in your own Apify account and add first_seen_at, previous_price, price_change, price_change_pct, status_changed and price_history to each item. Run it on a schedule: the first run only starts the series. Adds $1.00 per 1,000 listings that already had history. Do not run two runs on the same store at once. ## `historyStoreName` (type: `string`): Name of the key-value store that holds the history (letters a-z, digits, dashes). All our real-estate Actors use `realestate-history` by default, so history is shared between them. Use another name to keep a separate series per search, e.g. `gent-apartments`. ## `proxyConfiguration` (type: `object`): Immoweb blocks datacenter IPs, so a Belgian residential proxy is needed. The default (Apify Residential, country BE) works; change it only to use your own proxy. ## Actor input object example ```json { "location": "Gent", "listing_type": "sale", "property_type": "any", "limit": 20, "includeDetails": false, "trackHistory": false, "historyStoreName": "realestate-history", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "BE" } } ``` # Actor output Schema ## `listings` (type: `string`): All scraped listings, one item per property. # 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", "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/immoweb-listings").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", "limit": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "BE", }, } # Run the Actor and wait for it to finish run = client.actor("carabain-digital/immoweb-listings").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", "limit": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "BE" } }' | apify call carabain-digital/immoweb-listings --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,carabain-digital/immoweb-listings" } } } ``` 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/QksMrInrOcEapUuxz/builds/qsazYDb1YvQXlmpGu/openapi.json