## 2dehands Belgium Car Scraper
**๐ฐ $2.05 / 1 000 results** ยท pay only for results ยท no credit card to try
_We do the dirty work so your dataset stays clean._ ๐
Scrape used-car listings from 2dehands.be, Belgium's #1 marketplace (Auto's) โ price, make, model, year, mileage, fuel, transmission, engine power, body type, colour, seller (dealer/private), location, and photos. Export to JSON or CSV; optionally enrich each listing with its full Dutch description from the detail page.
seller_name + location.
- **Arbitrage / sourcing** โ find under-priced listings filtered by mileage, year, and power.
### โ๏ธ How to use it
1. Click **Try for free** at the top of the page.
2. Fill in the input form โ most fields have sensible defaults.
3. Click **Start**. Output streams into the run's dataset.
4. Export from **Storage โ Dataset** as JSON, CSV, or Excel โ or fetch via the API.
### ๐ฅ Input
| Field | Type | Required | Default | Notes |
|---|---|:--:|---|---|
| `searchUrl` | `string` | no | '' | Full 2dehands Auto's search/results URL with your filters already applied (e.g. https://www.2dehands.be/l/auto-s/b |
| `maxResults` | `integer` | no | 50 | Hard cap on dataset rows. 2dehands paginates 30 listings per page; the Actor walks pages until this cap or the last page |
| `enrichDetails` | `boolean` | no | True | Fetch each listing's detail page for the full Dutch description and a clean make/model. The search payload already carri |
| `proxyConfiguration` | `object` | no | {'useApifyProxy': True, 'apifyProxyGroups': ['RESIDENTIAL']} | Apify Proxy spec. Belgian residential exits are safest. |
#### Example input
```json
{
"searchUrl": "",
"maxResults": 5,
"enrichDetails": true,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
````
### ๐ค Output
Every row is one dataset item.
| Field | Type | Notes |
|---|---|---|
| `listing_id` | `string` | 2dehands listing ID (itemId, e.g. m2405879188). |
| `listing_url` | `string` | Absolute URL to the listing detail page. |
| `title` | `string` | Listing headline. |
| `make` | `['string', 'null']` | Car manufacturer (e.g. BMW, Volkswagen, Audi). |
| `model` | `['string', 'null']` | Model name (e.g. Golf, 3 Reeks). |
| `year` | `['integer', 'null']` | Construction year (Bouwjaar). |
| `price` | `['integer', 'null']` | Asking price as an integer in EUR (null when 'on request' / bidding). |
| `currency` | `['string', 'null']` | ISO-4217 currency code โ always EUR for 2dehands.be. |
| `mileage_km` | `['integer', 'null']` | Odometer reading in kilometres (Kilometerstand). |
| `fuel_type` | `['string', 'null']` | Fuel type (Benzine, Diesel, Elektrisch, Hybride). |
| `transmission` | `['string', 'null']` | Transmission (Handgeschakeld / Automaat). |
| `engine_power_hp` | `['integer', 'null']` | Engine power in metric horsepower (PK), derived from kW. |
| `engine_power_kw` | `['integer', 'null']` | Engine power in kilowatts. |
| `engine_size_cc` | `['integer', 'null']` | Engine displacement in cubic centimetres. |
| `body_type` | `['string', 'null']` | Body / car type (e.g. Cabriolet, SUV, Stationwagen). |
| `color` | `['string', 'null']` | Exterior colour. |
| `first_registration` | `['string', 'null']` | Construction year as a string. |
| `location` | `['string', 'null']` | City / municipality of the listing. |
| `region` | `['string', 'null']` | Country name (Belgiรซ) as reported by the listing. |
| `seller_type` | `['string', 'null']` | private or dealer. |
| `seller_name` | `['string', 'null']` | Seller / dealer name. |
| `photo_urls` | `array` | List of listing photo URLs (https). |
| `description` | `['string', 'null']` | Listing description (plain text). Full text on enrichment, else the search teaser. |
| `posted_date` | `['string', 'null']` | Posting date label as shown on 2dehands (e.g. Vandaag, Gisteren, a date). |
| `scraped_at` | `string` | ISO timestamp when this row was recorded. |
#### Example output
```json
{
"listing_id": "m2405222556",
"listing_url": "https://www.2dehands.be/v/auto-s/mini/m2405222556-mini-cooper-cabrio-1-6i-122pk-lci-highgate",
"title": "Mini Cooper Cabrio 1.6i 122pk LCI Highgate",
"make": "Mini",
"model": "Cabrio",
"year": 2013,
"price": 8990,
"currency": "EUR",
"mileage_km": 124600,
"fuel_type": "Benzine",
"transmission": "Handgeschakeld",
"engine_power_hp": null,
"engine_power_kw": null,
"engine_size_cc": null,
"body_type": "Cabriolet",
"color": null,
"first_registration": "2013",
"location": "Geel",
"region": "Belgi\u00eb",
"seller_type": "private",
"seller_name": "jo",
"photo_urls": [
"https://images.2dehands.com/api/v1/hz-twh-pro-listing/images/c40a8319-34f2-493d-928a-1248413f3dfd?rule=ecg_mp_eps$_82.jpg"
],
"description": "Mooie, exclusieve Mini Cooper Cabrio 1.6i 122pk in Iced Chocolate Metallic, Silvertouched bruin dak met Dark Truffle leder interieur.",
"posted_date": "Vandaag",
"scraped_at": "2026-06-02T00:00:00+00:00"
}
```
### ๐ฐ Pricing
Pay-Per-Event โ you pay only when these events fire:
| Event | USD | What it is |
|---|---:|---|
| `actor-start` | $0.05 | One-off warm-up charge per run |
| `result-row` | $0.002 | PPE event |
Example: 1 000 results at the rates above โ **$2.05**. No subscription, no minimum, no card to start โ Apify gives every new account $5 of free credit.
### ๐ง Limitations
2dehands paginates 30 listings per page and very deep result sets eventually stop returning new pages โ large queries cap out well before the full 100k+ inventory. The search payload's make/brand field is sparse, so make is derived from the listing URL slug and refined on detail enrichment. Bidding and 'on request' listings have no fixed price (null). Detail enrichment adds one request per listing and roughly doubles run time.
### โ FAQ
**Do I need a 2dehands account or API key?**
No. 2dehands offers no public API. This Actor scrapes the public Auto's category politely โ see the ToS Notice in the README.
**How do I scrape a filtered search?**
Apply your filters on 2dehands.be, copy the resulting URL from your browser, and paste it into searchUrl. We walk the result pages from there.
**Is the detail enrichment worth it?**
It adds the full Dutch description plus a clean make/model per listing at the cost of one extra request each. Price, specs, seller, location, and photos all come from the search payload โ set enrichDetails to false to halve requests.
**What currency are prices in?**
Always EUR. price is an integer in euros; mileage is always in kilometres.
**Why is price sometimes null?**
Some listings use bidding (Bieden) or 'on request' instead of a fixed price; we leave price null in those cases rather than guessing.
### ๐ฌ Your feedback
Spotted a bug, hit a weird edge case, or need a new field? Open an
issue on the Actor's **Issues** tab on Apify Console โ we ship
fixes weekly and we read every report.
***
Built by **[Devil Scrapes](https://apify.com/DevilScrapes)** ๐ โ a small fleet of
opinionated public-data Actors. Honest pricing, real engineering, zero fine print.
# Actor input Schema
## `searchUrl` (type: `string`):
Full 2dehands Auto's search/results URL with your filters already applied (e.g. https://www.2dehands.be/l/auto-s/bmw/). Leave empty to scrape the default used-car listing page.
## `maxResults` (type: `integer`):
Hard cap on dataset rows. 2dehands paginates 30 listings per page; the Actor walks pages until this cap or the last page.
## `enrichDetails` (type: `boolean`):
Fetch each listing's detail page for the full Dutch description and a clean make/model. The search payload already carries price, specs, seller, and photos โ turn this off to halve the request count.
## `proxyConfiguration` (type: `object`):
Apify Proxy spec. Belgian residential exits are safest.
## Actor input object example
```json
{
"searchUrl": "",
"maxResults": 50,
"enrichDetails": true,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
```
# Actor output Schema
## `datasetItems` (type: `string`):
All dataset items as JSON.
## `datasetItemsCsv` (type: `string`):
Same data exported to CSV.
## `datasetView` (type: `string`):
Open the run dataset in the Console.
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("devilscrapes/2dehands-belgium-cars").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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
} }
# Run the Actor and wait for it to finish
run = client.actor("devilscrapes/2dehands-belgium-cars").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("๐พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# ๐ Want to learn more ๐? Go to โ https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}' |
apify call devilscrapes/2dehands-belgium-cars --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=devilscrapes/2dehands-belgium-cars",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "2dehands Belgium Car Scraper",
"description": "Scrape used-car listings from 2dehands.be, Belgium's #1 marketplace (Auto's) โ price, make, model, year, mileage, fuel, transmission, body type, colour, seller (dealer/private), location, and photos. Export to JSON or CSV; optionally enrich each listing with its full Dutch description.",
"version": "0.1",
"x-build-id": "S6ifDNxDD3ev1k9eu"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/devilscrapes~2dehands-belgium-cars/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-devilscrapes-2dehands-belgium-cars",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/devilscrapes~2dehands-belgium-cars/runs": {
"post": {
"operationId": "runs-sync-devilscrapes-2dehands-belgium-cars",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/devilscrapes~2dehands-belgium-cars/run-sync": {
"post": {
"operationId": "run-sync-devilscrapes-2dehands-belgium-cars",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"searchUrl": {
"title": "2dehands search URL",
"type": "string",
"description": "Full 2dehands Auto's search/results URL with your filters already applied (e.g. https://www.2dehands.be/l/auto-s/bmw/). Leave empty to scrape the default used-car listing page.",
"default": ""
},
"maxResults": {
"title": "Max results",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Hard cap on dataset rows. 2dehands paginates 30 listings per page; the Actor walks pages until this cap or the last page.",
"default": 50
},
"enrichDetails": {
"title": "Enrich from detail page",
"type": "boolean",
"description": "Fetch each listing's detail page for the full Dutch description and a clean make/model. The search payload already carries price, specs, seller, and photos โ turn this off to halve the request count.",
"default": true
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Apify Proxy spec. Belgian residential exits are safest.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```