Spotto Scraper — Belgian Commercial Property with Zoning Data

Scrape commercial property listings from Spotto.be, the government-backed property platform for Flanders (Belgium). Offices, retail, horeca, industrial buildings and land, for rent and for sale, as clean structured JSON.

What sets Spotto apart from every other Belgian portal is the Flemish urban-planning disclosure on its listings. This actor captures all of it:

• Zoning designation (bestemmingsplan): the official zoning code (Wg = Woongebied, Igb = Industriegebied voor bedrijven, Ag = Agrarisch gebied, ...) plus the Dutch label as Spotto displays it
• Permit status: urban-planning permit (stedenbouwkundige vergunning), subdivision permit (verkavelingsvergunning), registered construction offenses and subpoenas
• Flood risk (watertoets): flood-prone classification plus the Flemish P-score (parcel) and G-score (building)
• Preemption rights (voorkooprecht) and the soil certificate (bodemattest) result

For site selection, due diligence or land sourcing, this is data you would otherwise dig out of Flemish government geoportals parcel by parcel.

What you get per listing

Address down to street and house number, NIS municipality code, coordinates, price with currency and unit, monthly charges, floor and plot surface, EPC label and score, construction and renovation year, full Dutch description, agency name, photo URL, publication date and the listing URL. Plus the zoning and permit block described above.

Prices on request are normal in commercial property. When a seller hides the price, the price field is null — the actor never fakes a number.

How to scrape Spotto data

1. Pick a location: a municipality name ("Gent", "Leuven", "Antwerpen") or a 4-digit postal code ("9000"). Leave empty for all of Belgium.
2. Pick a segment: office (kantoor), retail (winkel), horeca, industrial (industrie), land (grond), or all commercial property at once.
3. Pick a listing type: for rent (te huur), for sale (te koop), or both.
4. Set maxResults and run.

Example input:

{
    "searchQuery": "Gent",
    "segment": "office",
    "listingType": "rent",
    "maxResults": 100
}

Example output record:

{
    "title": "Kantoren te huur in voormalige directeurswoning in Gent",
    "segment": "office",
    "subtype": "office",
    "listingType": "rent",
    "price": 2000,
    "currency": "EUR",
    "priceUnit": "EUR/month",
    "surface": 240,
    "street": "Wondelgemkaai",
    "houseNumber": "8",
    "postalCode": "9000",
    "locality": "Gent",
    "municipalityCode": "44021",
    "latitude": 51.0892,
    "longitude": 3.7267,
    "epcLabel": "B",
    "zoningCode": "Wg",
    "zoningLabel": "Woongebied",
    "permitStatus": "PermitAvailable",
    "floodProneType": "notFloodProne",
    "agencyName": "Oranjeberg Vastgoed",
    "url": "https://www.spotto.be/nl/p/te-huur/9000-gent/kantoor-wondelgemkaai-8---v0/Nx5OaBzReUo7nwje-TrmlQ",
    "source": "spotto.be"
}

Segments

Segment	Dutch	Covers
office	kantoor	Offices and business centers
retail	winkel	Shops, commercial spaces, trading premises
horeca	horeca	Cafes, restaurants, hotels
industrial	industrie	Industrial buildings, warehouses, logistics
land	grond	Commercial land and building plots
all-commercial	bedrijfsvastgoed	All of the above in one run

The land segment includes generic building plots, because Spotto lists most plots under its generic land type rather than the commercial-land type. Every record carries both the normalized segment and Spotto's own propertyType, so you can filter either way.

Locations

Location filtering is municipality-level (the merged fusiegemeente). A sub-municipality like Kessel-Lo resolves to Leuven, and Sint-Amandsberg to Gent. Both Dutch names and postal codes work. Spotto is strongest in Flanders — that is its mandate — but also carries listings in Brussels and Wallonia.

The zoning fields, briefly

Flemish sellers must disclose urban-planning information when advertising property. On Spotto that disclosure is structured, and this actor passes it through:

Field	Meaning
zoningCode / zoningLabel	Zoning designation from the regional land-use plan, e.g. Wg / Woongebied (residential), Igb / Industriegebied voor bedrijven (industrial)
permitStatus	Whether an urban-planning permit is available, requested, or unavailable
subdivisionPermit	Subdivision (verkaveling) permit status, when the plot is part of one
constructionOffense	Registered construction offense, if any
floodProneType	Watertoets classification: not flood prone, possibly, or effectively flood prone
floodScoreParcel / floodScoreBuilding	The Flemish P-score and G-score (A to D)
hasPreemptionRights	Whether a legal preemption right applies
soilCertificate	Soil certificate result type

Disclosure completeness varies by seller. In practice roughly 60-70% of listings carry a zoning code and flood data; the rest return null because the seller left the field empty at the source. The actor reports exactly what Spotto exposes.

Cost

The zoning block lives on each listing's detail endpoint, so with Fetch zoning and detail data enabled (the default) the actor makes roughly one request per listing, plus one per unique agency for the agency name. A 100-listing run is therefore on the order of 100-150 requests. With the toggle off, the actor only reads search pages — one request per 200 listings — and the zoning, description, EPC-score and agency fields stay null.

Pricing is per result. Note that a run's usage cost only settles after the run reports SUCCEEDED — reading the cost mid-run undercounts it.

Typical uses

• Site selection: find retail or horeca space in a specific municipality with the zoning to match
• Land sourcing: building plots with subdivision-permit status and flood scores included
• Due diligence: pull the urban-planning disclosure for a market segment in one run instead of parcel-by-parcel geoportal lookups
• Market monitoring: track new commercial supply and asking prices per municipality
• Lead generation: listings carry the agency name, so you know who markets what where

Input reference

Field	Type	Default	Notes
searchQuery	string	empty (all of Belgium)	Municipality name or 4-digit postal code
segment	string	all-commercial	office, retail, horeca, industrial, land, all-commercial
listingType	string	all	rent, sale, all
fetchZoningDetails	boolean	true	Off = list-level fields only, far fewer requests, no zoning block
maxResults	integer	100	Hard cap on returned listings, maximum 50,000
proxyConfiguration	object	BE residential	Spotto served plain requests without blocks during testing

Data quality notes

• surface (indoor floor area) is empty on most commercial listings at the source; landSurface is filled more often. This mirrors Spotto itself.
• Long runs are migration-safe: progress is checkpointed, and a resumed run continues where it left off without duplicating listings.
• If Spotto ever ignores a location or segment filter (an API change), the actor fails loudly instead of returning country-wide data as if it were filtered.

Related actors

• Immoweb Commercial Scraper — commercial listings on Belgium's largest portal, same output field names
• Ideal together: Immoweb for national coverage and volume, Spotto for the zoning and permit data no other portal has