## Marktplaats Netherlands 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 Marktplaats.nl, the Netherlands' #1 marketplace (auto's) โ price, make, model, year, mileage (km), fuel, transmission, body type, drivetrain, seller (dealer/private), city, and photos. Export to JSON or CSV; optionally enrich each listing with its full Dutch description and colour.
seller_name + location.
- **Arbitrage / sourcing** โ find under-priced listings filtered by mileage, year, and body type.
### โ๏ธ 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 Marktplaats cars search/results URL with your filters already applied (e.g. https://www.marktplaats.nl/l/auto |
| `maxResults` | `integer` | no | 50 | Hard cap on dataset rows. Marktplaats serves 30 listings per page; the Actor walks pages until this cap or the last avai |
| `enrichDetails` | `boolean` | no | True | Fetch each listing's detail page for the full Dutch description and exterior colour. The search payload already carries |
| `proxyConfiguration` | `object` | no | {'useApifyProxy': True, 'apifyProxyGroups': ['RESIDENTIAL']} | Apify Proxy spec. Dutch residential exits are safest for Marktplaats. |
#### 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` | Marktplaats item ID (e.g. m2406042278). |
| `listing_url` | `string` | Absolute URL to the listing detail page. |
| `title` | `string` | Listing headline (make + model + trim). |
| `make` | `['string', 'null']` | Car manufacturer (e.g. BMW, Volkswagen, Skoda). |
| `model` | `['string', 'null']` | Model name (e.g. Octavia, Golf). |
| `year` | `['integer', 'null']` | Construction year (bouwjaar). |
| `price` | `['integer', 'null']` | Asking price as an integer in euros. |
| `currency` | `['string', 'null']` | ISO-4217 currency code โ always EUR for Marktplaats.nl. |
| `price_type` | `['string', 'null']` | Pricing mode (Te koop / Bieden / Gereserveerd). |
| `mileage_km` | `['integer', 'null']` | Odometer reading in kilometres (kilometerstand). |
| `fuel_type` | `['string', 'null']` | Fuel type (Benzine, Diesel, Hybride, Elektrisch). |
| `transmission` | `['string', 'null']` | Transmission (Handgeschakeld / Automaat). |
| `body_type` | `['string', 'null']` | Body type (Hatchback, SUV, Stationwagon, ...). |
| `drive_train` | `['string', 'null']` | Drivetrain (Voorwielaandrijving, ...). |
| `energy_label` | `['string', 'null']` | Energy label (AโG). |
| `color` | `['string', 'null']` | Exterior colour name (enrichment-only, e.g. Grijs). |
| `location` | `['string', 'null']` | City of the listing (woonplaats). |
| `region` | `['string', 'null']` | Country name (always Nederland). |
| `seller_type` | `['string', 'null']` | private or dealer. |
| `seller_name` | `['string', 'null']` | Seller / dealer display name. |
| `seller_id` | `['string', 'null']` | Marktplaats seller ID. |
| `photo_urls` | `array` | List of listing photo URLs (https, large size). |
| `description` | `['string', 'null']` | Full Dutch listing description (plain text). Enrichment-only. |
| `posted_date` | `['string', 'null']` | Listing date label as shown by Marktplaats (e.g. Vandaag). |
| `scraped_at` | `string` | ISO timestamp when this row was recorded. |
#### Example output
```json
{
"listing_id": "m2406042278",
"listing_url": "https://www.marktplaats.nl/v/auto-s/skoda/m2406042278-skoda-octavia-1-6-comfort",
"title": "Skoda Octavia 1.6 Comfort",
"make": "Skoda",
"model": "Octavia",
"year": 2001,
"price": 1150,
"currency": "EUR",
"price_type": "Te koop",
"mileage_km": 315844,
"fuel_type": "Benzine",
"transmission": "Handgeschakeld",
"body_type": "Hatchback",
"drive_train": "Voorwielaandrijving",
"energy_label": "B",
"color": "Grijs",
"location": "Lienden",
"region": "Nederland",
"seller_type": "dealer",
"seller_name": "MBSmart",
"seller_id": "56392587",
"photo_urls": [
"https://images.marktplaats.com/api/v1/hz-mp-pro-listing/images/4933080c-8de2-40e5-95e9-e9cc46631ef3?rule=ecg_mp_eps$_85.jpg"
],
"description": "Algemene informatie Aantal deuren: 5 Kleur: Grijs Technische informatie Vermogen: 75 kW (102 PK) ...",
"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
Marktplaats serves 30 listings per page and caps deep result sets at roughly page 167, so very large queries top out well before the full inventory. Exterior colour and the full description are only available via detail enrichment (one extra request per listing). The seller dealer/private split is inferred from Marktplaats' dealer-package signal and is occasionally ambiguous for semi-professional sellers. Sponsored 'Admarkt' ads (item IDs starting with `a`) are skipped. **Residential proxy is required** โ the Actor fails fast if the Apify Proxy RESIDENTIAL group is unavailable (upgrade your Apify plan if needed).
### โ FAQ
**Do I need a Marktplaats account or API key?**
No. Marktplaats offers no public API. This Actor scrapes the public cars category politely through Marktplaats' own search service โ see the ToS Notice in the README.
**How do I scrape a filtered search?**
Apply your filters on marktplaats.nl, copy the resulting URL from your browser, and paste it into searchUrl. We translate it to the internal search query and walk the result pages.
**Is the detail enrichment worth it?**
It adds the full Dutch description and the exterior colour 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 do some listings show 'Bieden' instead of a price?**
Those are bid-based (MIN\_BID) listings; we still surface the displayed amount as price and flag the mode in price\_type.
### ๐ฌ 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 Marktplaats cars search/results URL with your filters already applied (e.g. https://www.marktplaats.nl/l/auto-s/p/1/#f:10898,10898|q:bmw) or a category page like https://www.marktplaats.nl/l/auto-s/volkswagen/. Leave empty to scrape the default cars listing page.
## `maxResults` (type: `integer`):
Hard cap on dataset rows. Marktplaats serves 30 listings per page; the Actor walks pages until this cap or the last available page.
## `enrichDetails` (type: `boolean`):
Fetch each listing's detail page for the full Dutch description and exterior colour. The search payload already carries price, specs, seller, and photos โ turn this off to halve the request count.
## `proxyConfiguration` (type: `object`):
Apify Proxy spec. Dutch residential exits are safest for Marktplaats.
## 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/marktplaats-netherlands-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/marktplaats-netherlands-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/marktplaats-netherlands-cars --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=devilscrapes/marktplaats-netherlands-cars",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Marktplaats Netherlands Car Scraper",
"description": "Scrape used-car listings from Marktplaats.nl, the Netherlands' #1 marketplace (auto's) โ price, make, model, year, mileage (km), fuel, transmission, body type, drivetrain, seller (dealer/private), city, and photos. Export to JSON or CSV; optionally enrich with the full Dutch description.",
"version": "0.2",
"x-build-id": "DV995V3Z8UZFhrzML"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/devilscrapes~marktplaats-netherlands-cars/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-devilscrapes-marktplaats-netherlands-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~marktplaats-netherlands-cars/runs": {
"post": {
"operationId": "runs-sync-devilscrapes-marktplaats-netherlands-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~marktplaats-netherlands-cars/run-sync": {
"post": {
"operationId": "run-sync-devilscrapes-marktplaats-netherlands-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": "Marktplaats search URL",
"type": "string",
"description": "Full Marktplaats cars search/results URL with your filters already applied (e.g. https://www.marktplaats.nl/l/auto-s/p/1/#f:10898,10898|q:bmw) or a category page like https://www.marktplaats.nl/l/auto-s/volkswagen/. Leave empty to scrape the default cars listing page.",
"default": ""
},
"maxResults": {
"title": "Max results",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Hard cap on dataset rows. Marktplaats serves 30 listings per page; the Actor walks pages until this cap or the last available page.",
"default": 50
},
"enrichDetails": {
"title": "Enrich from detail page",
"type": "boolean",
"description": "Fetch each listing's detail page for the full Dutch description and exterior colour. 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. Dutch residential exits are safest for Marktplaats.",
"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
}
}
}
}
}
}
}
}
}
}
```