# Immoweb Scraper — Belgium Property Listings & Prices, No Phones (`highbrow_fame/immoweb-properties`) Actor

Belgian property listings from Immoweb, for sale or to rent: price, bedrooms, living area, EPC, town and postcode, agency, and optionally the description and building details. No phones.

- **URL**: https://apify.com/highbrow\_fame/immoweb-properties.md
- **Developed by:** [yestrue](https://apify.com/highbrow_fame) (community)
- **Categories:** Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.00 / 1,000 property delivereds

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/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

## Immoweb Scraper — Belgium Property Listings & Prices, No Phones

Get property listings from Immoweb, Belgium's largest property portal: price, rent and monthly costs, bedrooms, living and land area, floor, EPC label, region, province, town and postcode, street and map point for agency listings, seller type and agency name, new-build project ranges, life-annuity terms — and, if you want, the full description and the building details (construction year, condition, facades, heating, energy use, kitchen, garden and terrace, parking, cadastral income, flood zone, availability, view count). For sale and to rent. Paste your Immoweb search links in English, French or Dutch — or just type a place.

**Why this one**

- 🔗 **Your search, as you set it up.** Set every filter you like on immoweb.be and paste the link — `/en/search/…`, `/fr/recherche/…` or `/nl/zoeken/…`, including pages like "3 bedrooms" or "cheap". Or type a place here — Gent, Anvers, 1050, "Liège (Province)" — and choose sale or rent, property type, price, bedrooms, living area, EPC label, "added or updated within" and the sort order below.
- ⚡ **Fast.** A live test run read four searches — houses for sale in Liège province up to €350,000, flats to rent in Antwerp, 3-bedroom houses to rent across Belgium, and €200,000–300,000 homes in Gent — 4,100 properties in 69 seconds.
- 📍 **Details when you need them.** Tick **Open every listing for its details** for the description and the building data. A live run read 300 listings with details in 33 seconds.
- 🛡️ **No silent surprises.** Immoweb quietly turns a link it does not understand into "all houses for sale in Belgium". This Actor notices and tells you instead. It also keeps your price range where Immoweb does not: a live run of €200,000–300,000 flats, cheapest first, left out 59 life-annuity sales that Immoweb showed with down payments below €200,000. New-build projects stay when their price range overlaps yours.
- 🔒 **No phone numbers, no names of private sellers.** Agencies, notaries and developers are named by their company; private sellers by nothing, and their street, house number and map point are left out — only the town and postcode stay. Phone numbers and e-mail addresses written into titles, streets and descriptions are replaced with `[phone removed]` / `[e-mail removed]`.
- 💸 **You pay only for properties delivered.** A link that is not an Immoweb search, a property type Immoweb does not know, or a place it does not know comes back as a free record with the reason.

### What you get

For every property:

| Field | What it is |
|---|---|
| `price`, `currency`, `priceText`, `priceType`, `oldPrice` | the asking price or monthly rent (EUR) as a number and as Immoweb shows it, the kind of price (sale, monthly rent, life annuity, auction, project range), and the price before a drop |
| `monthlyCosts`, `annuityMonthly`, `priceMin`, `priceMax` | the monthly charges on a rental, the monthly payment of a life-annuity sale, and a new-build project's price range |
| `transaction`, `propertyType`, `propertySubtype`, `title` | sale or rent; HOUSE, APARTMENT, APARTMENT\_GROUP / HOUSE\_GROUP (new-build projects), LAND, OFFICE, COMMERCIAL, INDUSTRY, GARAGE, OTHER; VILLA, PENTHOUSE, FLAT\_STUDIO, … |
| `bedrooms`, `livingAreaSqm`, `landAreaSqm`, `floor`, `bedroomRange`, `livingAreaRange` | size and layout (ranges for projects) |
| `region`, `province`, `district`, `locality`, `postalCode` | where it is |
| `street`, `houseNumber`, `latitude`, `longitude` | the address and map point — agency listings only |
| `epcScore` | the energy label, where the search shows it (about half of the listings; the details below fill in most of the rest) |
| `sellerType`, `agency` | private or professional, and the company name (none for private sellers) |
| `projectName`, `labels` | the new-build project's name; new, new\_price, under\_option, notary\_sale, biddit\_sale, new\_real\_estate\_project, … |
| `lastModified`, `hasVirtualTour`, `image`, `imageCount`, `url`, `listingId` | the listing |
| `input`, `place`, `position`, `scrapedAt`, `status`, `error` | which search it came from, and why a search gave nothing |

With **Open every listing for its details** also: `description`, `createdAt`, `constructionYear`, `condition`, `facadeCount`, `buildingFloors`, `bathrooms`, `toilets`, `kitchenType`, `hasGarden`, `gardenSqm`, `hasTerrace`, `terraceSqm`, `parkingIndoor`, `parkingOutdoor`, `hasLift`, `hasSwimmingPool`, `furnished`, `heatingType`, `primaryEnergyKwhPerSqm`, `cadastralIncome`, `floodZone`, `availableFrom`, `viewCount`, `bookmarkCount`, and `epcScore` when the search left it empty. The description is the English text when the ad has one, otherwise the ad's own Dutch or French text.

#### Example

A real record from a live run with details — flats to rent in Liège (4000) up to €900 a month, from a French search link, 25 September 2026:

```json
{
  "listingId": 21820594,
  "url": "https://www.immoweb.be/en/classified/21820594",
  "title": "Guillemins - Immeuble récent - Agréable terrasse ensoleillée",
  "transaction": "rent",
  "propertyType": "APARTMENT",
  "price": 900,
  "currency": "EUR",
  "priceText": "900 € (+ 200 €)",
  "priceType": "residential_monthly_rent",
  "monthlyCosts": 200,
  "bedrooms": 1,
  "livingAreaSqm": 58,
  "floor": 3,
  "region": "Wallonie",
  "province": "Liège",
  "locality": "Liège",
  "postalCode": "4000",
  "street": "Allée Konrad Adenauer",
  "latitude": 50.63507569999999,
  "longitude": 5.5628874,
  "epcScore": "A",
  "sellerType": "professional",
  "agency": "VICINITY",
  "description": "In the heart of Liège, right next to Guillemins station, discover this comfortable one-bedroom flat in a modern block of flats. …",
  "constructionYear": 2023,
  "condition": "AS_NEW",
  "kitchenType": "USA_INSTALLED",
  "hasTerrace": true,
  "terraceSqm": 6,
  "hasLift": true,
  "heatingType": "GAS",
  "primaryEnergyKwhPerSqm": 51,
  "floodZone": "NON_FLOOD_ZONE",
  "availableFrom": "2026-09-21",
  "viewCount": 1045,
  "status": "OK"
}
```

### How to use it

1. Paste **Search links** from immoweb.be, one per line — or type **Places** and choose the filters.
2. Set **Max listings per search**, and tick **Open every listing for its details** if you need the description and building data.
3. Press **Start**, and download the results from the **Output** tab as JSON, CSV or Excel.

To follow new listings in an area, save your input as a task with **Added or updated within (days)** set to 1 and schedule it daily.

You can also call it from the Apify API, from Make, Zapier or n8n, or from an AI agent through the Apify MCP server.

### Pricing

You are charged **per property delivered** — see the price on this page. Opening listings for their details costs nothing extra, only time. Links that are not Immoweb searches, and property types or places Immoweb does not know, are free.

### FAQ

**How many properties per search?** Immoweb shows at most about 9,990 listings for one search (333 pages of 30). A live run read 9,987 of the 51,026 houses for sale in Belgium from one link. For more, split the search — by province, by price band or by property type — and paste several links.

**Which places can I type?** A town means all of its postcodes ("Gent" is 9000, 9030, 9031 … 9052), a postcode means just that one, and "Liège (Province)" or "Leuven (District)" pick the wider areas. French and Dutch names work: Anvers, Gand, Bruxelles.

**Why is a listing's EPC label empty?** Immoweb's search pages leave it out for about half of the listings. Tick **Open every listing for its details** to get it from the listing page.

**Why no phone numbers or seller names?** They are personal data. Every listing has its `url`; buyers and tenants contact the seller on Immoweb.

**Is this affiliated with Immoweb?** No. This is an independent tool that reads public Immoweb listings.

**Like it?** A short review on the Store page helps other people find this Actor. Something missing or broken? Tell us on the Issues tab — we read every one.

# Actor input Schema

## `searchUrls` (type: `array`):

Set up a search on immoweb.be with all the filters you want and paste the address of the results page. One per line. English, French and Dutch links all work.

## `locations` (type: `array`):

Or search here without a link: towns, postcodes, provinces or districts — Gent, Anvers, 1050, "Liège (Province)", "Leuven (District)". A town means all of its postcodes. The filters below apply.

## `transaction` (type: `string`):

For the places above.

## `propertyType` (type: `string`):

For the places above.

## `minPrice` (type: `integer`):

Optional. For rent: per month.

## `maxPrice` (type: `integer`):

Optional. For rent: per month.

## `minBedrooms` (type: `integer`):

Optional.

## `minArea` (type: `integer`):

Optional.

## `maxArea` (type: `integer`):

Optional.

## `epcScores` (type: `array`):

Optional: only these energy labels (A includes A+ and A++).

## `modifiedWithinDays` (type: `integer`):

Optional: only listings added or changed in the last N days.

## `sortBy` (type: `string`):

For the places above.

## `maxListingsPerSearch` (type: `integer`):

Stops each search after this many listings. Immoweb shows up to about 9,990 per search.

## `includeDetails` (type: `boolean`):

Adds the full description, construction year, condition, facades, bathrooms, kitchen, garden and terrace, parking, heating, energy use, cadastral income, flood zone, availability and view count. One more page per listing, so slower.

## `maxConcurrency` (type: `integer`):

How many searches to work on at the same time.

## `proxyConfiguration` (type: `object`):

Used only when Immoweb turns a request down: the first try goes out directly.

## Actor input object example

```json
{
  "searchUrls": [
    "https://www.immoweb.be/en/search/apartment/for-sale/brussels-city/1000?countries=BE&maxPrice=400000"
  ],
  "transaction": "sale",
  "propertyType": "house-and-apartment",
  "sortBy": "relevance",
  "maxListingsPerSearch": 30,
  "includeDetails": false,
  "maxConcurrency": 3,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Every result as a JSON record, with a status for each input.

## `resultsCsv` (type: `string`):

The same records as CSV, for a spreadsheet.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchUrls": [
        "https://www.immoweb.be/en/search/apartment/for-sale/brussels-city/1000?countries=BE&maxPrice=400000"
    ],
    "maxListingsPerSearch": 30,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("highbrow_fame/immoweb-properties").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchUrls": ["https://www.immoweb.be/en/search/apartment/for-sale/brussels-city/1000?countries=BE&maxPrice=400000"],
    "maxListingsPerSearch": 30,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("highbrow_fame/immoweb-properties").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 '{
  "searchUrls": [
    "https://www.immoweb.be/en/search/apartment/for-sale/brussels-city/1000?countries=BE&maxPrice=400000"
  ],
  "maxListingsPerSearch": 30,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call highbrow_fame/immoweb-properties --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,highbrow_fame/immoweb-properties"
        }
    }
}
```

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 <APIFY_API_TOKEN>` 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/gqiJhMWJLD0l2spyd/builds/sFm79Te53ggZMHoYn/openapi.json