Biddit Scraper

Get structured data from Biddit.be — the official platform where Belgian notaries run online property auctions. This is the only place in Belgium where notarial public sales happen digitally.

If you've ever tried to monitor Biddit manually, you know the pain: no export button, no RSS feed, listings spread across paginated search results. This actor pulls everything into clean JSON.

What it scrapes

The actor hits two Biddit API endpoints:

1. Search API (/api/eco/search-service/lot/_search) — paginated listing data with property basics, auction status, and current bids
2. Detail API (/api/eco/biddit-bff/lot/{ref}) — full descriptions, all photos, notary contact info, estimated prices, cadastral income

Both are plain HTTP, no browser needed.

Input

Field	Type	Description
province	String	Province code: VAN (Antwerpen), VOV (Oost-Vlaanderen), VWV (West-Vlaanderen), VBR (Vlaams-Brabant), VLI (Limburg), BRU (Brussels), WBR (Brabant Wallon), WHT (Hainaut), WLG (Liege), WLX (Luxembourg), WNA (Namur)
propertyType	String	HOUSE, APARTMENT, GROUND, GARAGE, OFFICE, INDUSTRY, COMMERCIAL, OTHER
handlingMethod	String	ONLINE_PUBLIC_SALE (standard auction), PRIVATE_SALE, ANNUITY_SALE (viager/lijfrente)
includeClosedSales	Boolean	Include already-sold properties with their final selling price. Default: false
scrapeDetails	Boolean	Fetch the detail page for each listing (descriptions, all images, notary info). Default: true
maxResults	Integer	Limit (default: 100). There are usually ~1,000-1,200 active listings on Biddit at any time
language	String	nl or fr — property titles and descriptions are bilingual
proxyConfiguration	Object	Optional

Output

With scrapeDetails: true (default), each listing looks something like this:

{
    "title": "Eengezinswoning met tuin en garage",
    "price": 195000,
    "currency": "EUR",
    "listingType": "auction",
    "reference": "294512",
    "propertyType": "house",
    "address": "Dorpstraat 17",
    "city": "Aalst",
    "postalCode": "9300",
    "latitude": 50.9387,
    "longitude": 4.0367,
    "bedrooms": 3,
    "bathrooms": 1,
    "surface": 165,
    "landSurface": 420,
    "buildYear": 1972,
    "numberOfFacades": 3,
    "epcScore": "E",
    "startingPrice": 160000,
    "currentPrice": 195000,
    "estimatedPrice": 220000,
    "biddingStartDate": "2026-03-10T10:00:00",
    "biddingEndDate": "2026-03-17T10:00:00",
    "auctionStatus": "CURRENT",
    "biddingPace": 1000,
    "notaryName": "Marc Janssens",
    "notaryPhone": "+32 53 12 34 56",
    "notaryEmail": "info@notaris-janssens.be",
    "landIncome": 1485,
    "description": "Ruime gezinswoning met 3 slaapkamers, ingerichte keuken, living met open haard, onderhouden tuin en garage voor 2 wagens...",
    "imageUrl": "https://www.biddit.be/stg/eco/images/294512/m/001.jpeg",
    "imageUrls": [
        "https://www.biddit.be/stg/eco/images/294512/l/001.jpeg",
        "https://www.biddit.be/stg/eco/images/294512/l/002.jpeg",
        "https://www.biddit.be/stg/eco/images/294512/l/003.jpeg"
    ],
    "agencyName": "Notary Marc Janssens",
    "url": "https://www.biddit.be/nl/catalog/detail/294512",
    "language": "nl",
    "scrapedAt": "2026-03-16T10:00:00.000Z"
}

Interesting fields

• estimatedPrice — The official notary valuation. Compare it against currentPrice to gauge if a property is going above or below estimate.
• biddingPace — Minimum bid increment in EUR (usually 500 or 1000).
• landIncome — Kadastraal inkomen / revenu cadastral. Determines property taxes in Belgium.
• sellingPrice — Only appears for closed sales (includeClosedSales: true). The actual final hammer price.
• epcScore — Energy performance certificate. Biddit shows the regional variant (RF for Flanders, RW for Wallonia, RBC for Brussels); the actor normalizes this into a single field.
• numberOfFacades — Open-bebouwing (4), half-open (3), gesloten (2). Important for Belgian real estate.

Speed vs. detail

Set scrapeDetails: false for a quick overview — the actor skips the per-listing detail API calls and returns just the search data. You still get address, price, auction dates, and property basics. Runs about 5x faster.

With scrapeDetails: true, it makes one extra HTTP request per listing with a 200ms delay between them. A full scrape of ~1,100 active listings takes about 4 minutes.

Cost

All HTTP, no browser. A full scrape of every active listing with details: ~0.05 CU (~$0.025). With closed sales included (doubling the count), still under $0.10.

Things to know

• Biddit is exclusively Belgian. Every listing is a notarial sale governed by Belgian law.
• Bid history (individual bid amounts per listing) is not exposed by the API.
• The province filter uses Biddit's own codes (not ISO). See the input table above for the full mapping.
• Some freshly posted listings might be missing descriptions or photos if the notary hasn't uploaded them yet.
• The estimatedPrice, biddingPace, notary contact, and full description only come from the detail endpoint — you need scrapeDetails: true to get them.