# Marktplaats Car Scraper Netherlands (`mrdoe/marktplaats-car-scraper-nl`) Actor
Extracts used car listings from Marktplaats.nl, the Netherlands' largest classifieds marketplace, including price, mileage, year, fuel type, and location, with real pagination.
- **URL**: https://apify.com/mrdoe/marktplaats-car-scraper-nl.md
- **Developed by:** [MrDoe](https://apify.com/mrdoe) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.00 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event
## What's an Apify Actor?
An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.
Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.
## 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.
Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.
For examples already wired to this Actor's own input schema, see the [API](#api) section below.
Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).
# README
**Turn Marktplaats' 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 Marktplaats.nl, the Netherlands' largest classifieds marketplace, paged through automatically.
### What does Marktplaats Car Scraper Netherlands do?
Marktplaats Car Scraper Netherlands collects used car listings from [Marktplaats.nl](https://www.marktplaats.nl), the Dutch equivalent of eBay Classifieds, 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 Marktplaats Car Scraper Netherlands?
- **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 Marktplaats Car Scraper Netherlands
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": "m2426519100",
"url": "https://www.marktplaats.nl/v/auto-s/bmw/m2426519100-bmw-1-serie-118i-introduction-edition-aut-virtual-sfeerver",
"title": "BMW 1-serie 118i Introduction Edition AUT. VIRTUAL SFEERVER.",
"make": "bmw",
"model": "1-Serie",
"year": "2023",
"price": 23950,
"currency": "EUR",
"priceType": "FIXED",
"mileageKm": 97775,
"fuelType": "Benzine",
"transmission": null,
"body": null,
"city": "Almere",
"sellerName": "Carline Automotive",
"image": "https://images.marktplaats.com/api/v1/hz-mp-pro-listing/images/...",
"scrapedAt": "2026-08-14T00:00:00.000Z"
}
```
#### Data table
| Field | Description |
| --- | --- |
| `id` / `url` | Marktplaats' 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 Marktplaats 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 Marktplaats.nl's Terms of Service and any applicable laws in your jurisdiction.
**Why does `make` sometimes show a category name instead of a brand?** Marktplaats 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 (e.g. `bestelauto-s` for vans), 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. bmw. 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": 5,
"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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"make": "bmw"
};
// Run the Actor and wait for it to finish
const run = await client.actor("mrdoe/marktplaats-car-scraper-nl").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 = { "make": "bmw" }
# Run the Actor and wait for it to finish
run = client.actor("mrdoe/marktplaats-car-scraper-nl").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 mrdoe/marktplaats-car-scraper-nl --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,mrdoe/marktplaats-car-scraper-nl"
}
}
}
```
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 ` 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/bxArZyZqrfbgKsiSI/builds/xXr8eTsBbjzfuHWGZ/openapi.json