2dehands.be Car Listings Scraper

Overview

2dehands.be Car Listings Scraper collects structured data from vehicle listings on 2dehands.be. It is built for automotive search pages and turns filtered 2dehands.be car results into clean, usable records for research, monitoring, analytics, and internal data workflows.

The actor starts from a normal 2dehands.be car search URL, follows the search pagination, opens each vehicle detail page, and extracts the listing data available in the page payload. This includes pricing, seller details, car specifications, images, listing statistics, and grouped vehicle attributes.

The results are saved to an Apify dataset and can be exported in formats such as JSON, JSONL, CSV, Excel, XML, or accessed directly through the Apify API.

Hosted Apify actor ID:

smtc/2dehands-be-car-scraper

What information does the scraper collect?

The actor can collect fields such as:

🚗 Vehicle title
🆔 Listing ID
🔗 Listing URL
📝 Description
💰 Price in cents
💱 Currency
🏷️ Price type
👤 Seller name and ID
🏢 Seller type
📍 Seller city and country
🌐 Seller profile URL
🖼️ Listing images
📊 View and favorite counts
🚘 Brand and model
📅 Construction year
🛣️ Mileage
⛽ Fuel type
⚙️ Transmission
🌱 Environmental details
🧾 Vehicle history
✅ Options and equipment
📦 Optional raw source data

Common use cases

This scraper is useful for anyone who needs reliable Belgian used-car market data. You can use it to:

Monitor vehicle prices on 2dehands.be
Track available inventory by brand, model, mileage, year, or fuel type
Analyze dealer and private-seller activity
Build used-car pricing datasets
Compare supply trends over time
Feed automotive dashboards or valuation tools
Support sourcing, trade-in, and resale decisions
Create market intelligence reports for the Belgian car market

Input

The actor accepts a filtered 2dehands.be car search URL and processes listings from that result set.

{
  "startUrl": "https://www.2dehands.be/l/auto-s/bmw/f/gebruikt/14049/#f:10899|Language:all-languages|offeredSince:Een%20week|PriceCentsFrom:500000|constructionYearFrom:2021|mileageFrom:5001|mileageTo:125001",
  "maxListings": 300,
  "includeContactFields": false,
  "includeSellerProfile": true,
  "includeImages": true,
  "includeRaw": false,
  "requestDelayMs": 500,
  "detailMaxAttempts": 3,
  "maxConsecutiveBlockedDetails": 5,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Input fields

startUrl
Required. A 2dehands.be car search-results URL, including any selected filters.

maxListings
Maximum number of vehicle detail pages to process. Default: 300.

includeContactFields
Includes contact-related fields when available, such as phone number or seller website. Default: false.

includeSellerProfile
Fetches additional seller profile metadata. Default: true.

includeImages
Includes listing image URLs in the output. Default: true.

includeRaw
Adds sanitized raw search and detail payloads for debugging or advanced processing. Default: true.

requestDelayMs
Delay between detail-page requests. Default: 500.

detailMaxAttempts
Maximum attempts for each detail page when the page cannot be fetched or does not contain a parseable listing payload. Default: 3.

maxConsecutiveBlockedDetails
Stops the run after this many consecutive detail pages return a 2dehands block page. Default: 5.

proxyConfiguration
Optional proxy settings. For larger runs, enable Apify Proxy if 2dehands starts returning 403 block pages.

Recommended larger-run settings:

{
  "requestDelayMs": 2500,
  "detailMaxAttempts": 2,
  "maxConsecutiveBlockedDetails": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Output

Each dataset item represents one vehicle listing.

{
  "source": "2dehands",
  "scrapedAt": "2026-05-19T10:00:00.000Z",
  "itemId": "m2401319955",
  "url": "https://www.2dehands.be/v/auto-s/bmw/m2401319955-2ctb960-bmw-1-hatch",
  "title": "(2CTB960) BMW 1 HATCH",
  "description": "Vehicle description...",
  "price": {
    "priceCents": 1849000,
    "currency": "EUR",
    "priceType": "FIXED"
  },
  "seller": {
    "id": 123456,
    "name": "Seller name",
    "type": "TRADER",
    "city": "Aartselaar",
    "country": "BE",
    "pageUrl": "https://www.2dehands.be/u/seller-name/123456/"
  },
  "carDetails": {
    "brand": "BMW",
    "model": "1",
    "constructionYear": "2022",
    "condition": "NEW"
  },
  "flatAttributes": {
    "mileage": "44.656 km",
    "fuel": "Benzine",
    "transmission": "Handgeschakeld"
  },
  "images": [
    "https://images.2dehands.com/api/v1/..."
  ],
  "stats": {
    "viewCount": 23,
    "favoritedCount": 1
  }
}

Notes

This actor is focused on car listings from 2dehands.be search-result pages.

It uses the site's search data and listing detail payloads. If 2dehands.be changes its page or API structure, the actor may require updates.

For larger result sets, 2dehands may start returning temporary 403 block pages on detail requests. The actor detects this, skips blocked detail pages, and stops early after repeated consecutive blocks to avoid wasting run time. Enable Apify Proxy and increase requestDelayMs for larger jobs.

Without a proxy, recent Apify cloud runs against the BMW search started receiving block pages after roughly 55-65 detail pages. With the circuit breaker enabled, the actor stops cleanly and reports stoppedReason: too_many_consecutive_blocked_detail_pages instead of retrying every remaining listing.

The actor defines Apify output metadata in .actor/output_schema.json; the results output points to the default dataset items URL.

Contact fields are excluded by default. Enable them only when they are needed for your use case and when your usage complies with applicable rules.

Please make sure your use of the data follows the 2dehands.be terms of service and relevant data protection regulations.

Custom Development and Support

SMTC is a software development company specializing in web platforms, data extraction, and analytics applications. We help teams turn marketplace data into practical tools, from custom Apify actors and API integrations to dashboards, reporting workflows, and internal business applications.

If you need a tailored scraper, additional data fields, automation, or integration with your existing systems, contact us with your requirements. We can help design, build, and maintain a solution that fits your project.