Immoweb & Belgium Real Estate Scraper — Immo Belgique 🇧🇪🏠 (MCP)

Scrape Immoweb, Belgium's #1 property portal — ≈51 000 live listings: apartments, houses, villas, offices and land, for sale and for rent, across all 43 Belgian districts. The data comes from Immoweb's own public JSON search endpoint (undocumented, no browser, no proxy, no login).

This Actor does one job: turn Immoweb into a clean, deduplicated, contact-rich feed of Belgian property — and, when scheduled, into an automatic watch service that reports only what is new, what changed, and what is gone.

Three hard problems, solved for you

1. The ~10 000-result API cap. Immoweb returns 30 listings per page and cuts every single query at page 333. A naive scraper silently loses 80 % of the Belgian market. This Actor detects the cap and automatically splits the market by district (43 district slugs, all verified against the live API) — so "every apartment for sale in Belgium" is actually complete, not just the first 10 000.

2. Agency contacts — the data nobody else gives you. The search grid does not expose them. With fetchDetails the Actor opens each listing page and extracts the agency e-mail, phone, mobile and website, plus the full description, EPC reference, heating type and lift / pool / flood-zone flags. Perfect for agencies, investors and lead generation.

3. Change detection that does not lie. monitor mode stores every listing it has seen (price + last modification + title fingerprint) in the Apify key-value store and returns only:

• isNew: true — a listing never seen before,
• isUpdated: true — price change or edit of a listing you already had,
• changeType: "closed" — a listing that disappeared from the portal (sold, rented, withdrawn), returned once and then forgotten.

Closed-detection runs only when the scan was complete and error-free — it never guesses. Price drops are the money signal: oldPrice + price give you the drop directly.

What you get

Field	Example
immowebId / immowebUrl	21895839 / direct link
title / propertyType / propertySubtype	"…charming house" / HOUSE / HOUSE
transactionType / price / oldPrice / priceDisplay	FOR_SALE / 650000 / … / €650,000
bedrooms / rooms / livingSurface / landSurface	4 / 4 / 168 m² / 41 m²
locality / postalCode / street / houseNumber / latitude / longitude	Watermael-Boitsfort / 1170 / RUE DE LA VÉNERIE / 21 / GPS
province / region / district / country	Brussels / Brussels / Brussels / Belgium
epcLabel / epcReference / heatingType	G / 20260701-… / gas
agencyName / agencyLogo	VICTOIRE JUNOT - Uccle Vente
agencyEmail / agencyPhone / agencyMobile / agencyWebsite	venteuccle@apilead.be / +32 2 375 10 10 / … / victoire.be
description / hasLift / hasSwimmingPool / floodZoneType	full text / false / false / flood zone
flag / hasVirtualTour / has360Tour / hasVideo / pictures	new / … / up to 15 hi-res URLs
lastModificationDate	2026-10-07T09:30:47Z
isNew / isUpdated / changeType / firstSeenAt / closedAt	monitor flags

Filters

Property type (house / apartment / villa / office / land) · sale or rent · 43 districts (brussels, antwerp, gent, liege, brugge, charleroi, leuven, namur, hasselt, kortrijk, oostende…) · price range (minPrice / maxPrice) · site language (EN / FR / NL — Belgium is bilingual).

Automation recipes (no code required)

• Daily market watch — save as a task with a daily schedule, mode: monitor + onlyChanges: every run returns only new, price-changed and removed listings. A Brussels-wide watch costs a few cents a day.
• One task per search — "apartments Brussels under €400k", "houses Gent for rent": each task keeps its own watch history (state key derived from the scope).
• Price-drop hunting — watch a district with monitor and read oldPrice vs price.
• Push it anywhere — add a webhook (Apify Console → Integrations) to send each run to Slack, Google Sheets, n8n, Make or Zapier, or to your own CRM for lead follow-up.

Use from AI agents (MCP)

This Actor is exposed as a tool through Apify's MCP server — any MCP client (Claude, Cursor, VS Code / Copilot, Codex, custom agents) can discover and run it without code:

{
  "mcpServers": {
    "apify": { "url": "https://mcp.apify.com?tools=amygraphics/belgium-immoweb-scraper" }
  }
}

Then simply ask: "Use amygraphics/belgium-immoweb-scraper to list apartments for sale in Brussels under €400 000 with the agency e-mail."

Agents can also pay autonomously — this Actor is whitelisted for agentic payments (Direct x402 / Apify AGI prepaid token), so a run does not require an Apify account.

Pricing

Pay-per-event: a small start fee plus $4 per 1 000 listings extracted. In monitor mode you only pay for listings that are new, changed or closed — a daily watch costs a few cents.

Notes & limitations

• Source: Immoweb's public search JSON + listing pages. Data reused as published.
• Immoweb caps each single query at ~10 000 results (30/page × 333 pages); the automatic district split removes that limit, at the cost of more requests.
• District slugs are validated against a verified list of 43 Belgian districts; unknown slugs are ignored with a warning (the Actor never guesses).
• Some listings are sold by private owners — then agencyEmail/agencyPhone are empty, which is itself a useful signal.

---

Français — Scrapez Immoweb, le portail immobilier n°1 en Belgique (≈51 000 annonces : appartements, maisons, villas, bureaux, terrains — vente et location, 43 arrondissements). Le plafond de ~10 000 résultats par requête est contourné automatiquement par découpage par arrondissement ; l'enrichissement fetchDetails ajoute e-mail, téléphone et site de l'agence, description complète, référence PEB, chauffage, ascenseur/piscine/zone inondable. Le mode monitor ne renvoie que les annonces nouvelles, modifiées (baisse de prix) ou disparues (changeType: "closed"). Tarif : 4 $ les 1 000 annonces, démarrage $0.001.

Agents IA (MCP) : cet Actor est exposé comme outil du serveur MCP d'Apify — branchez https://mcp.apify.com?tools=amygraphics/belgium-immoweb-scraper dans Claude, Cursor, VS Code ou Codex. Les agents peuvent payer seuls (x402 / AGI) : l'Actor est whitelisted pour les paiements agentiques.