# Immoweb Scraper Cheap (`data_api/immoweb-scraper-cheap`) Actor Immoweb scraper that gathers property listings, prices, and locations from Immoweb.be. It lets real estate investors and analysts track housing market trends without clicking through pages manually. - **URL**: https://apify.com/data\_api/immoweb-scraper-cheap.md - **Developed by:** [Data API](https://apify.com/data_api) (community) - **Categories:** Real estate, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.99 / 1,000 results 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/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 Property Scraper ![Immoweb Property Scraper](cover.jpg) Keeping tabs on the Belgian housing market usually means opening immoweb.be listing after listing and copying the same details by hand: address, price, floor area, energy label, the agency behind it. This scraper does that part for you. Paste an immoweb.be search URL and every listing comes back as a tidy row, with price, location, size, and broker already split into fields and ready for a spreadsheet or a model. It runs fast, costs little, needs no code, and you pay only for what you scrape. ### What you get Each listing comes back as one row covering three kinds of data: - **Location** — `cityName`, `postalCode`, `geoLat`, `geoLng`, plus the `listingUrl` and `listingId` - **Price and size** — `priceValue`, `livingAreaSqm`, `plotAreaSqm`, `bedroomTotal`, `bathroomTotal`, `builtYear`, `buildState`, `energyRating`, `propertyKind`, `propertyStyle` - **Listing and broker** — `listingTitle`, `brokerName`, `brokerPhone`, `imageLinks`, `collectedAt` ### Quick start 1. Open immoweb.be, set your filters (region, price, property type), and copy the URL from the address bar. A direct classified link works too. 2. Hit **Try for free** and paste that link into **Immoweb URLs**. 3. Set a **Results limit** to control how many listings you pull from each URL. 4. Press **Start**, then export the rows as JSON, CSV, Excel, or XML. ![How it works](how-it-works.jpg) ### Use cases - **Price tracking** — follow asking prices across a city or postcode and catch reductions early - **Region comparison** — line up price per m², bedroom counts, and energy labels between areas - **Investment research** — assemble a dataset of for-sale or rental stock to score against your own criteria - **Broker analysis** — see which agencies list what, where, and at what price - **Market dashboards** — pipe live immoweb.be data into your own sheet, BI tool, or app ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `listingUrls` | array of strings | Yes | immoweb.be search pages or direct listing links to scrape; search pages are walked page by page. Prefilled with a Belgian houses-for-sale search. | | `resultsLimit` | integer | No | How many listings to pull from each URL. Default `25`. | | `timeoutSeconds` | integer | No | Seconds to wait on each request before it times out. Default `45`. | #### Example input ```json { "listingUrls": [ "https://www.immoweb.be/en/search/house/for-sale?countries=BE&page=1" ], "resultsLimit": 25, "timeoutSeconds": 45 } ```` ### Output Every listing on the search results turns into one row, paginated automatically up to your limit. Fields that immoweb.be does not publish for a given property come back absent rather than guessed, and search-result rows carry less detail than direct classified links (for example bathrooms and build year show up mainly on single-listing pages). #### Example output ```json { "listingId": "12345678", "listingUrl": "https://www.immoweb.be/en/classified/villa/for-sale/gent/9000/12345678", "listingTitle": "Spacious villa with garden near the centre of Gent", "propertyKind": "house", "propertyStyle": "villa", "priceValue": 575000, "bedroomTotal": 4, "bathroomTotal": 2, "livingAreaSqm": 210, "plotAreaSqm": 640, "builtYear": 1998, "buildState": "GOOD", "energyRating": "B", "cityName": "Gent", "postalCode": "9000", "geoLat": 51.0543, "geoLng": 3.7174, "brokerName": "Vandaele Vastgoed", "brokerPhone": "+32 9 123 45 67", "imageLinks": [ "https://static.immoweb.be/listings/12345678/large-1.jpg", "https://static.immoweb.be/listings/12345678/large-2.jpg" ], "collectedAt": "2026-06-29T12:00:00.000000+00:00" } ``` #### Output fields | Field | Type | Description | |-------|------|-------------| | `listingId` | string | Immoweb identifier for the listing | | `listingUrl` | string | Direct link to the listing on immoweb.be | | `listingTitle` | string | Headline shown on the listing | | `propertyKind` | string | Broad category, such as house or apartment | | `propertyStyle` | string | More specific style, e.g. villa, penthouse, loft | | `priceValue` | integer | Listed price in euros as a whole number | | `bedroomTotal` | integer | Number of bedrooms | | `bathroomTotal` | integer | Number of bathrooms | | `livingAreaSqm` | integer | Habitable floor space in m² | | `plotAreaSqm` | integer | Land or plot size in m²; mainly for houses | | `builtYear` | integer | Year the property was built | | `buildState` | string | Reported condition of the building | | `energyRating` | string | EPC grade, e.g. A through F | | `cityName` | string | Town or municipality | | `postalCode` | string | Belgian postal code | | `geoLat` | number | Latitude coordinate | | `geoLng` | number | Longitude coordinate | | `brokerName` | string | Estate agency or broker handling the listing | | `brokerPhone` | string | Phone contact for the listing agency | | `imageLinks` | array | Photo URLs gathered from the listing | | `collectedAt` | string | ISO 8601 timestamp of when the row was captured | | `errorMessage` | string | Reason a direct listing could not be read; absent on rows that succeeded | ### Tips for best results - **Filter on immoweb.be first.** A tighter search URL (region, price band, property type) gives you a cleaner, more relevant dataset. - **Use `resultsLimit` for test runs.** Start with 25 to confirm the output fits your pipeline, then raise it for the full pull. - **Search pages and direct links both work.** Drop in a search URL to walk every page, or paste a single classified link to grab one property in detail. - **Detail pages carry more.** `bathroomTotal`, `builtYear`, `buildState`, and `brokerPhone` show up mainly on direct classified links; search-result rows fill in what the card exposes. - **Raise `timeoutSeconds`** if you start seeing timeouts on large result sets. ### How can I use Immoweb property data? **How can I use the Immoweb Property Scraper to track Belgian house prices?** Paste an immoweb.be search URL for your target region and run it on a schedule. Each row carries `priceValue`, `cityName`, `postalCode`, and `collectedAt`, so you can chart asking prices over time and flag reductions soon after they appear. **How can I compare Belgian regions on immoweb.be by price per m²?** Pull listings for several areas, then divide `priceValue` by `livingAreaSqm` per row. With `cityName`, `bedroomTotal`, and `energyRating` alongside, you get a clean side-by-side read on where the value sits. **How can I build a Belgian real estate dataset for investment research?** Feed in one or more search URLs, set `resultsLimit` to the volume you need, and export to CSV or Excel. The result is a structured property database — address, price, size, energy label, broker — you can score against your own buy criteria. **How do I export immoweb.be listings to a spreadsheet?** Run the scraper, then download the dataset as CSV, Excel, JSON, or XML. Every listing is already split into fields like `listingTitle`, `priceValue`, and `livingAreaSqm`, so it drops straight into a sheet without cleanup. ### Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses or private contact information. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). ### Support Questions, feature requests, or a field you'd like added? Reach out at and we'll get back to you. # Actor input Schema ## `listingUrls` (type: `array`): Paste one or more immoweb.be search result pages or single listing links. Search pages are walked through page by page; single links are read one at a time. ## `resultsLimit` (type: `integer`): How many listings to pull from each URL you supply. ## `timeoutSeconds` (type: `integer`): Seconds to wait on each request to the site before it times out. ## Actor input object example ```json { "listingUrls": [ "https://www.immoweb.be/en/classified/villa/for-sale/gent/9000/12345678" ], "resultsLimit": 25, "timeoutSeconds": 45 } ``` # 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 = { "listingUrls": [ "https://www.immoweb.be/en/search/house/for-sale?countries=BE&page=1" ] }; // Run the Actor and wait for it to finish const run = await client.actor("data_api/immoweb-scraper-cheap").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 = { "listingUrls": ["https://www.immoweb.be/en/search/house/for-sale?countries=BE&page=1"] } # Run the Actor and wait for it to finish run = client.actor("data_api/immoweb-scraper-cheap").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 '{ "listingUrls": [ "https://www.immoweb.be/en/search/house/for-sale?countries=BE&page=1" ] }' | apify call data_api/immoweb-scraper-cheap --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=data_api/immoweb-scraper-cheap", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Immoweb Scraper Cheap", "description": "Immoweb scraper that gathers property listings, prices, and locations from Immoweb.be. It lets real estate investors and analysts track housing market trends without clicking through pages manually.", "version": "0.0", "x-build-id": "q1AIPo6YwOZO62LAf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_api~immoweb-scraper-cheap/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_api-immoweb-scraper-cheap", "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/data_api~immoweb-scraper-cheap/runs": { "post": { "operationId": "runs-sync-data_api-immoweb-scraper-cheap", "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/data_api~immoweb-scraper-cheap/run-sync": { "post": { "operationId": "run-sync-data_api-immoweb-scraper-cheap", "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", "required": [ "listingUrls" ], "properties": { "listingUrls": { "title": "Immoweb URLs", "type": "array", "description": "Paste one or more immoweb.be search result pages or single listing links. Search pages are walked through page by page; single links are read one at a time.", "items": { "type": "string" } }, "resultsLimit": { "title": "Results limit", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many listings to pull from each URL you supply.", "default": 25 }, "timeoutSeconds": { "title": "Timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Seconds to wait on each request to the site before it times out.", "default": 45 } } }, "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 } } } } } } } } } } ```