# Immoweb.be Real Estate Scraper (`santamaria-automations/immoweb-be-scraper`) Actor Scrape property listings from Immoweb.be, Belgium's #1 real estate portal. Extract prices, addresses, photos, property details, PEB energy ratings, and agent contact info for sale and rent. Multi-language support (EN/FR/NL). - **URL**: https://apify.com/santamaria-automations/immoweb-be-scraper.md - **Developed by:** [Alessandro Santamaria](https://apify.com/santamaria-automations) (community) - **Categories:** Real estate, Automation, Other - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 property listing scrapeds 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 ## Immoweb.be Scraper — Belgian Real Estate Data Scrape every property on **[Immoweb.be](https://www.immoweb.be)**, Belgium's #1 real estate portal covering **300,000+ active listings** across Flanders, Wallonia, and Brussels — houses, apartments, new-build projects, for sale and for rent. Pay only for what you scrape. No monthly rental, no seat fees. Just clean, structured property data ready for your pipeline. ### Features - **Paste any search URL** — works with any Immoweb.be search page you build in the browser - **Or use filter mode** — choose property type, transaction type, city, and language - **Complete listing data** — price, full address, GPS coordinates, bedrooms, bathrooms, living area, plot size, PEB energy rating, heating type, construction year, all photos - **Real agency contacts** — agency name, phone number, email, website - **Belgian-specific fields** — PEB (Performance Énergétique des Bâtiments) energy label, 4-digit postal codes, region (Flanders / Wallonia / Brussels) - **Multi-language support** — English, French, Dutch interface - **Automatic pagination** — crawls all result pages in order, deduplicates sponsored listings - **Rich amenity detection** — garden, terrace, balcony, swimming pool, lift, air conditioning, basement, attic, photovoltaic panels, heat pump - **Pay-per-result pricing** — start $0.001, SERP result $0.003, full detail $0.008 ### Example Output ```json { "id": "21482860", "title": "VILLA 4F - 3CH - GRENIER - VERANDA - JARDIN - PISCINE", "url": "https://www.immoweb.be/en/classified/house/for-sale/lantin/4450/21482860", "transaction_type": "for-sale", "property_type": "House", "price": 549000, "price_currency": "EUR", "address": "Rue des Acacias 15, 4450 LANTIN, Belgium", "street": "Rue des Acacias 15", "city": "LANTIN", "postal_code": "4450", "region": "Wallonie", "country": "BE", "latitude": 50.69393549999999, "longitude": 5.530208099999999, "bedrooms": 3, "bathrooms": 1, "living_area_m2": 174, "plot_size_m2": 845, "year_built": 2000, "energy_label": "C", "heating_type": "Fueloil", "construction_type": "Good", "description": "Magnificent 4-facade villa built in 2000 with 3 bedrooms, attic, veranda, garden and swimming pool located in Juprelle...", "features": ["Garden", "Terrace", "Basement", "Attic", "Double glazing", "Kitchen: Installed"], "photos": [ "https://media-resize.immowebstatic.be/classifieds/.../2560x1440/efbfb2c6....jpg", "... 26 more full-resolution photos ..." ], "agent_name": "Roufosse Immo", "agency_name": "Roufosse Immo", "agent_phone": "+3242342110", "agent_email": "roufousse-kfaah9@omniwebsites.be", "agent_url": "https://www.roufosse-immo.be", "listed_since": "2026-04-09T13:42:06.252Z", "source_platform": "immoweb.be", "scraped_at": "2026-04-10T10:12:03Z" } ```` ### Input Parameters | Parameter | Type | Description | Default | |-----------|------|-------------|---------| | `searchUrls` | string\[] | Direct Immoweb.be search URLs — paste any search page from the browser | `house/for-sale?countries=BE` | | `propertyType` | string | `house`, `apartment`, `new-real-estate`, or `house-and-apartment` | `house` | | `transactionType` | string | `for-sale` or `for-rent` | `for-sale` | | `city` | string | Optional city or locality filter (e.g. `brussels`, `antwerp`, `ghent`) | — | | `language` | string | Interface language: `en`, `fr`, `nl` | `en` | | `maxResults` | number | Maximum listings to return | 100 | | `includeDetails` | boolean | Fetch detail pages for full description, all photos, PEB rating, heating, agent contacts | `true` | | `proxyConfiguration` | object | Apify proxy (see note below) | Auto | **Proxy note**: The default Apify proxy works fine for most runs. If you hit rate limits on large jobs, switch to `RESIDENTIAL` with `countryCode: "BE"` as a fallback — but you usually won't need to. ### Output Fields Every result includes: | Field | Type | Description | |-------|------|-------------| | `id` | string | Immoweb classified ID | | `title` | string | Listing title | | `url` | string | Full URL to the Immoweb listing | | `transaction_type` | string | `for-sale` or `for-rent` | | `property_type` | string | House, apartment, new-build project, etc. | | `price` | number | Asking price or monthly rent | | `price_currency` | string | Always `EUR` | | `price_per_m2` | number | Price per square meter (when provided) | | `address` | string | Full formatted address | | `street` | string | Street name and house number | | `city` | string | Locality | | `postal_code` | string | 4-digit Belgian postal code | | `region` | string | Flanders, Wallonia, or Brussels | | `country` | string | Always `BE` | | `latitude` / `longitude` | number | GPS coordinates | | `bedrooms` | number | Bedroom count | | `bathrooms` | number | Bathroom count | | `living_area_m2` | number | Net habitable surface in m² | | `plot_size_m2` | number | Land surface (houses) in m² | | `year_built` | number | Construction year | | `energy_label` | string | Belgian PEB rating (A++ → G) | | `heating_type` | string | Heating fuel (gas, oil, electric, ...) | | `construction_type` | string | Condition (new, good, to renovate, ...) | | `description` | string | Full listing description | | `features` | string\[] | Amenity list (garden, pool, terrace, solar, ...) | | `photos` | string\[] | All listing photos at full resolution | | `agent_name` | string | Contact person | | `agent_phone` | string | Agency phone | | `agent_email` | string | Agency email | | `agent_url` | string | Agency website | | `agency_name` | string | Listing agency | | `listed_since` | string | Publication date (ISO-8601) | | `property_image_url` | string | Main photo (shown as image in the Apify dataset view) | | `source_url` | string | Original Immoweb URL | | `source_platform` | string | Always `immoweb.be` | | `scraped_at` | string | ISO-8601 UTC timestamp | ### Use Cases - **Belgian real estate market analysis** — track inventory, median prices, and days-on-market across regions - **Investment research** — compare rental yields between Brussels, Antwerp, Ghent, Liège and Charleroi - **PropTech data pipelines** — feed your valuation model with live market data - **Lead generation for agencies** — build prospect lists of competing listings with full agency contacts - **Historical price tracking** — daily snapshots let you build sold/delisted and price-change datasets - **Relocation & buying tools** — power a consumer app with filtered listings - **Academic research** — housing affordability, energy-efficiency (PEB), urban density studies - **Portfolio enrichment** — augment your own database with photos, descriptions, coordinates and PEB ratings ### Pricing | Event | Price | |-------|-------| | Actor start | $0.001 | | Search result (SERP listing) | $0.003 / result | | Full detail (with description, all photos, PEB, agent contacts) | $0.008 / result | 100 fully-enriched listings cost **≈ $0.80**. No monthly subscription, no minimum spend. ### Why This Scraper - **HTTP-only architecture** — no headless browser, faster and cheaper than Puppeteer-based alternatives - **Pay per result** — no $30/month flat rental fee that you pay even on weeks you don't run the scraper - **Multi-language output** — English, French, or Dutch depending on which audience you serve - **Belgian PEB energy ratings included** — critical for any valuation or sustainability model - **Full agency contacts** — most scrapers return `agency_name` only; this one returns phone, email and website too - **Real coordinates** — every listing with latitude/longitude for mapping and geo-analysis - **Deduplication built in** — sponsored listings that repeat across pages are collapsed automatically - **Works with any search URL** — Immoweb's faceted search filters are preserved — paste a complex filtered URL and it just works ### Issues & Feedback Facing an issue, missing a feature, or need an extra data field? [Open an issue on the Issues tab](https://console.apify.com/actors/L170pAvt9BaaTC81q/issues) — we respond quickly and ship fixes fast. *** ### Related Actors If you scrape European real estate, you may also want: - [Funda.nl Scraper](https://apify.com/santamaria-automations/funda-nl-scraper) — Netherlands' #1 real estate portal - [Homegate.ch Scraper](https://apify.com/santamaria-automations/homegate-scraper) — Switzerland's leading real estate portal - [ImmobilienScout24 Scraper](https://apify.com/santamaria-automations/immobilienscout24-scraper) — Germany's #1 real estate portal - [Immowelt.de Scraper](https://apify.com/santamaria-automations/immowelt-de-scraper) — Germany's #2 real estate portal - [AutoScout24 Scraper](https://apify.com/santamaria-automations/autoscout24-scraper) — European used car marketplace - [Google Maps Scraper](https://apify.com/santamaria-automations/google-maps-scraper) — Local business intelligence - [Website Contact Extractor](https://apify.com/santamaria-automations/website-contact-extractor) — Enrich any website with contact data Or browse all [santamaria-automations actors](https://apify.com/santamaria-automations) for the full DACH + European scraping suite. # Actor input Schema ## `searchUrls` (type: `array`): Direct Immoweb.be search URLs to scrape. Paste any search result page from immoweb.be. When provided, overrides propertyType/transactionType/city/language filters. ## `propertyType` (type: `string`): Type of property to search for. Used when no searchUrls are provided. ## `transactionType` (type: `string`): Sale or rent listings. Used when no searchUrls are provided. ## `city` (type: `string`): Optional city or locality to filter by (e.g., 'brussels', 'antwerp', 'liege'). Used when no searchUrls are provided. ## `language` (type: `string`): Immoweb interface language: English, French, or Dutch. ## `maxResults` (type: `integer`): Maximum number of listings to scrape. ## `includeDetails` (type: `boolean`): Fetch detail pages for full description, all photos, PEB energy rating, heating type, construction year, and agent contact details. Slower but much richer data. ## `proxyConfiguration` (type: `object`): Apify proxy settings. Default auto proxy works fine; use RESIDENTIAL (country BE) only as a fallback if you hit rate limits. ## Actor input object example ```json { "searchUrls": [ "https://www.immoweb.be/en/search/house/for-sale?countries=BE" ], "propertyType": "house", "transactionType": "for-sale", "language": "en", "maxResults": 20, "includeDetails": true, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `listings` (type: `string`): Dataset containing scraped property listings # 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 = { "searchUrls": [ "https://www.immoweb.be/en/search/house/for-sale?countries=BE" ], "maxResults": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("santamaria-automations/immoweb-be-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 = { "searchUrls": ["https://www.immoweb.be/en/search/house/for-sale?countries=BE"], "maxResults": 20, } # Run the Actor and wait for it to finish run = client.actor("santamaria-automations/immoweb-be-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 '{ "searchUrls": [ "https://www.immoweb.be/en/search/house/for-sale?countries=BE" ], "maxResults": 20 }' | apify call santamaria-automations/immoweb-be-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=santamaria-automations/immoweb-be-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Immoweb.be Real Estate Scraper", "description": "Scrape property listings from Immoweb.be, Belgium's #1 real estate portal. Extract prices, addresses, photos, property details, PEB energy ratings, and agent contact info for sale and rent. Multi-language support (EN/FR/NL).", "version": "1.0", "x-build-id": "XSjIQyEVh7hsO0e4d" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/santamaria-automations~immoweb-be-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-santamaria-automations-immoweb-be-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/santamaria-automations~immoweb-be-scraper/runs": { "post": { "operationId": "runs-sync-santamaria-automations-immoweb-be-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/santamaria-automations~immoweb-be-scraper/run-sync": { "post": { "operationId": "run-sync-santamaria-automations-immoweb-be-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": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "Direct Immoweb.be search URLs to scrape. Paste any search result page from immoweb.be. When provided, overrides propertyType/transactionType/city/language filters.", "items": { "type": "string" } }, "propertyType": { "title": "Property Type", "enum": [ "house", "apartment", "new-real-estate", "house-and-apartment" ], "type": "string", "description": "Type of property to search for. Used when no searchUrls are provided.", "default": "house" }, "transactionType": { "title": "Transaction Type", "enum": [ "for-sale", "for-rent" ], "type": "string", "description": "Sale or rent listings. Used when no searchUrls are provided.", "default": "for-sale" }, "city": { "title": "City", "type": "string", "description": "Optional city or locality to filter by (e.g., 'brussels', 'antwerp', 'liege'). Used when no searchUrls are provided." }, "language": { "title": "Language", "enum": [ "en", "fr", "nl" ], "type": "string", "description": "Immoweb interface language: English, French, or Dutch.", "default": "en" }, "maxResults": { "title": "Maximum Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of listings to scrape.", "default": 100 }, "includeDetails": { "title": "Include Full Details", "type": "boolean", "description": "Fetch detail pages for full description, all photos, PEB energy rating, heating type, construction year, and agent contact details. Slower but much richer data.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy settings. Default auto proxy works fine; use RESIDENTIAL (country BE) only as a fallback if you hit rate limits.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```