# 2dehands Car Scraper Belgium🇧🇪 (`jordan-byte/2dehands-car-scraper-be`) Actor

Scrape used car listings from 2dehands, one of Belgium's major online marketplaces. Collect vehicle details such as make, model, price, mileage, year, fuel type, transmission, location, seller information, images, and listing URLs for automotive research and market analysis.

- **URL**: https://apify.com/jordan-byte/2dehands-car-scraper-be.md
- **Developed by:** [Jordan Byte](https://apify.com/jordan-byte) (community)
- **Categories:** Automation, E-commerce, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 1,000 results

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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

**Turn 2dehands' car listings into structured data in minutes** - no coding, no manual copy-pasting. Get price, mileage, year, fuel type, and location for used cars listed on 2dehands.be, Belgium's largest classifieds marketplace, paged through automatically.

### What does 2dehands Car Scraper Belgium do?

2dehands Car Scraper Belgium collects used car listings from [2dehands.be](https://www.2dehands.be), the Belgian equivalent of eBay Classifieds (and Marktplaats.nl's Belgian sibling site), covering both dealers and private sellers nationwide. Optionally filter by make and it pages through the results automatically, extracting every listing it finds.

### Why use 2dehands Car Scraper Belgium?

- **Sourcing** - build a shortlist of cars matching your criteria from both private sellers and dealers.
- **Market research** - track pricing, mileage, and fuel-type trends by make, including private-sale prices you won't find on dealer-only sites.
- **Lead generation** - find private sellers or dealers in a specific area for trade buying.
- **Data enrichment** - pull structured listing data into your own spreadsheet, CRM, or valuation tool.

### How to use 2dehands Car Scraper Belgium

1. Go to the **Input** tab.
2. Optionally set **Make** to filter by a specific brand (e.g. `bmw`), or leave empty for all cars.
3. Set **Max items** and **Max pages** to control how much to collect.
4. Click **Start** and wait for the run to finish.
5. Open the **Dataset** tab to preview, filter, and export your results.

### Input

| Field | Type | Description |
| --- | --- | --- |
| `make` | String | Car make to filter by, e.g. `bmw` (optional - leave empty for all cars). |
| `maxItems` | Integer | Maximum number of listings to scrape (default: 100). |
| `maxPages` | Integer | Safety cap on how many pages to page through (default: 20). |

Example input:

```json
{
    "make": "bmw",
    "maxItems": 100,
    "maxPages": 10
}
```

### Output

Each listing is saved as one item in the dataset, for example:

```json
{
    "id": "m2430511934",
    "url": "https://www.2dehands.be/v/auto-s/bmw/m2430511934-bmw-530d-full-option-10-2019",
    "title": "bmw 530D Full Option 10/2019",
    "make": "bmw",
    "model": "5 Reeks",
    "year": "2019",
    "price": 29500,
    "currency": "EUR",
    "priceType": "MIN_BID",
    "mileageKm": 130000,
    "fuelType": "Diesel",
    "transmission": null,
    "body": null,
    "city": "Ekeren",
    "sellerName": "Chris",
    "image": "https://images.2dehands.com/api/v1/hz-twh-pro-listing/images/...",
    "scrapedAt": "2026-08-14T00:00:00.000Z"
}
```

#### Data table

| Field | Description |
| --- | --- |
| `id` / `url` | 2dehands' ad ID and its own listing page |
| `title`, `make`, `model` | Vehicle identification |
| `year` | Construction year, as listed |
| `price`, `currency`, `priceType` | Asking price, and whether it's a fixed price (`FIXED`) or a minimum/starting bid (`MIN_BID`, `FAST_BID`) |
| `mileageKm`, `fuelType`, `transmission`, `body` | Core spec, where the seller provides it |
| `city` | Seller's listed location |
| `sellerName` | Seller's display name |
| `image` | Listing photo URL |
| `scrapedAt` | ISO timestamp when the item was scraped |

### Pricing / Cost estimation

How much does it cost to scrape 2dehands listings? Pricing depends on your Apify plan's compute unit rate and how many listings you request. Each page of results is a single fast request.

### Tips for better runs

- Set **Make** for a focused pull instead of scraping the entire cars category.
- Keep **Max items**/**Max pages** modest for daily monitoring runs to control cost and run time.
- Use the Apify **Schedule** feature to re-run this Actor periodically and track new listings over time.

### FAQ

**Is this legal?** This Actor only collects publicly visible listing data. You are responsible for using the data in accordance with 2dehands.be's Terms of Service and any applicable laws in your jurisdiction.

**Why does `make` sometimes show a category name instead of a brand?** 2dehands doesn't expose "make" as its own data field - this Actor reads it from the listing's own URL path, which normally is the brand (e.g. `/v/auto-s/bmw/...`). Vans, campers, and trucks are occasionally filed under a sub-category slug there instead, so those specific listings will show that sub-category name in `make` rather than the actual brand.

**Why did some fields come back empty?** Not every listing includes every field (e.g. some sellers omit transmission or body type). The Actor returns `null` for anything that isn't available for a given car.

**Found a bug or have a feature request?** Please use the Issues tab on this Actor's page - feedback directly shapes future updates.

# Actor input Schema

## `make` (type: `string`):

Car make to filter by, e.g. <code>bmw</code>. Leave empty to scrape all cars.

## `maxItems` (type: `integer`):

Maximum number of listings to scrape, paging through the search results (30 per page) until this limit or the last page is reached.

## `maxPages` (type: `integer`):

Safety cap on how many pages of results to page through.

## Actor input object example

```json
{
  "make": "bmw",
  "maxItems": 100,
  "maxPages": 20
}
```

# Actor output Schema

## `listings` (type: `string`):

No description

# 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 = {
    "make": "bmw"
};

// Run the Actor and wait for it to finish
const run = await client.actor("jordan-byte/2dehands-car-scraper-be").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 = { "make": "bmw" }

# Run the Actor and wait for it to finish
run = client.actor("jordan-byte/2dehands-car-scraper-be").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 '{
  "make": "bmw"
}' |
apify call jordan-byte/2dehands-car-scraper-be --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,jordan-byte/2dehands-car-scraper-be"
        }
    }
}

```

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/yaI9boMajGLigk1fh/builds/lEkidsdCLN03h4nj8/openapi.json