# Marktplaats Scraper (`solidcode/marktplaats-scraper`) Actor \[💰 $1.0 / 1K] Scrape Marktplaats listings at scale. - **URL**: https://apify.com/solidcode/marktplaats-scraper.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (community) - **Categories:** Developer tools, Automation, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN 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. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ## Marktplaats Scraper Extract complete listing data from Marktplaats — the Netherlands' largest classifieds marketplace with millions of active listings across cars, electronics, furniture, clothing, real estate, jobs, and more. Search by keyword or paste any Marktplaats URL to collect prices, seller details, images, location, and 30+ structured fields per listing. ### Why This Scraper? - **Netherlands' #1 classifieds site** — access millions of listings across every major category from cars and property to toys and collectibles - **Search by keyword or URL** — enter plain search terms like "iPhone 15" or paste any Marktplaats search/category URL you already filtered in your browser - **Rich listing data** — price, condition, seller profile, location coordinates, images, shipping options, buyer protection status, and engagement metrics - **Price filtering built in** — set a minimum and/or maximum price in euros to skip irrelevant listings immediately - **Sort by what matters** — newest first, lowest price, highest price, or most relevant - **Vehicle details extracted** — brand, model, year, mileage, fuel type, transmission, and colour for car listings - **No compute charges** — you only pay per result returned ### Use Cases **Market Research & Price Monitoring** - Track market prices for a product category over time - Compare asking prices across sellers for the same model - Spot pricing anomalies and arbitrage opportunities - Monitor how quickly certain items sell and at what price **Lead Generation & Sales** - Find private sellers of goods you want to buy in bulk - Identify businesses selling on Marktplaats for B2B outreach - Build targeted contact lists of sellers in a specific region or category **Competitive Intelligence** - Monitor competitor listings and pricing on Marktplaats - Track inventory levels and stock changes of known sellers - Analyse listing frequency and seasonal trends **Inventory & Data Enrichment** - Populate internal databases with used-goods market data - Enrich product catalogues with real-world resale valuations - Build price-comparison tools for second-hand marketplaces **Research & Journalism** - Study the Dutch second-hand goods market at scale - Analyse regional supply and demand patterns - Investigate pricing practices or category-level trends ### Getting Started #### Keyword Search The simplest way to start — just enter what you are looking for: ```json { "searchQueries": ["iPhone 15 Pro", "laptop gaming"], "maxResults": 100 } ```` #### Search with Price Range Narrow results to a specific budget: ```json { "searchQueries": ["racefiets"], "minPrice": 200, "maxPrice": 800, "sortBy": "price_asc", "maxResults": 200 } ``` #### Category or Search URL Paste a URL you already filtered and sorted in your browser: ```json { "searchUrls": [ "https://www.marktplaats.nl/l/auto-s/bmw/", "https://www.marktplaats.nl/l/computers-en-software/laptops/" ], "maxResults": 500 } ``` #### Combined: URLs and Queries Together Mix both input types — results from all sources are combined: ```json { "searchUrls": ["https://www.marktplaats.nl/l/antiek-en-kunst/"], "searchQueries": ["vintage lamp", "retro klok"], "minPrice": 50, "sortBy": "date_down", "maxResults": 1000 } ``` ### Input Reference | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `searchUrls` | string\[] | `[]` | Marktplaats search or category URLs copied from your browser | | `searchQueries` | string\[] | `[]` | Plain-text search terms (e.g. "iPhone 15 Pro") | | `maxResults` | integer | `100` | Maximum listings to collect across all sources. Set to `0` for no limit | | `sortBy` | string | `"date_down"` (Newest First) | Sort order: `date_down` (Newest First), `price_asc` (Price: Low to High), `price_desc` (Price: High to Low), or `relevance` (Most Relevant) | | `minPrice` | integer | — | Only include listings priced at or above this amount in euros | | `maxPrice` | integer | — | Only include listings priced at or below this amount in euros | ### Output Each listing is saved as one row in your dataset. Here is a representative example: ```json { "listingId": "m2134567890", "title": "BMW 3 Serie 320i Executive — 2018, lage km", "url": "https://www.marktplaats.nl/v/auto-s/bmw/m2134567890-bmw-3-serie-320i-executive", "description": "Nette BMW 3 serie, goed onderhouden, nap, 2 sleutels aanwezig...", "price": 18950.00, "priceType": "FIXED", "currency": "EUR", "condition": null, "categoryId": 91, "categoryName": null, "parentCategoryName": null, "imageUrls": [ "https://images.marktplaats.com/api/v1/listing-mp-p/images/ab/ab123456-0000-0000-0000-000000000000?rule=ecg_mp_eps$_84.jpg" ], "postedAt": "Vandaag", "favoritesCount": 12, "viewCount": 438, "sellerName": "AutoDeal Rotterdam", "sellerId": "55123456", "sellerUrl": "https://www.marktplaats.nl/s/55123456", "sellerType": "BUSINESS", "sellerCity": "Rotterdam", "sellerRegion": "NL", "sellerLat": 51.9225, "sellerLon": 4.4792, "shippingCost": null, "shippingMethod": null, "shippingCarrier": null, "hasBuyerProtection": true, "isFreeAd": false, "urgencyFeatureActive": false, "vehicleBrand": "BMW", "vehicleModel": "3 Serie", "vehicleYear": 2018, "vehicleMileage": 87000, "vehicleFuelType": "Benzine", "vehicleTransmission": "Automaat", "vehiclePower": null, "vehicleColor": "Zwart", "vehicleCondition": null, "attributes": { "brand": "BMW", "model": "3 Serie", "constructionYear": "2018", "mileage": "87000", "fuel": "Benzine", "transmission": "Automaat", "color": "Zwart" }, "searchQuery": "https://www.marktplaats.nl/l/auto-s/bmw/" } ``` #### Field Reference | Field | Type | Description | |-------|------|-------------| | `listingId` | string | Unique Marktplaats listing identifier | | `title` | string | Listing title as shown on Marktplaats | | `url` | string | Direct URL to the listing page | | `description` | string | Listing description text | | `price` | number | Asking price in euros (null for free or "see description" listings) | | `priceType` | string | Price type: `FIXED`, `NEGOTIABLE`, `FREE`, `SEE_DESCRIPTION`, etc. | | `currency` | string | Always `"EUR"` | | `condition` | string | Item condition (available on detail pages) | | `categoryId` | integer | Marktplaats internal category ID | | `categoryName` | string | Category name | | `parentCategoryName` | string | Parent (top-level) category name | | `imageUrls` | string\[] | All listing image URLs | | `postedAt` | string | When the listing was posted (Dutch localised: "Vandaag", "Gisteren", or a date) | | `favoritesCount` | integer | Number of times the listing has been saved as favourite | | `viewCount` | integer | Number of listing views | | `sellerName` | string | Seller display name | | `sellerId` | string | Seller account identifier | | `sellerUrl` | string | Link to the seller's Marktplaats profile | | `sellerType` | string | `PRIVATE` or `BUSINESS` | | `sellerCity` | string | Seller's city | | `sellerRegion` | string | Seller's country/region code | | `sellerLat` | number | Seller location latitude | | `sellerLon` | number | Seller location longitude | | `shippingCost` | number | Shipping cost in euros (when available) | | `shippingMethod` | string | Shipping method description | | `shippingCarrier` | string | Carrier name (e.g. PostNL) | | `hasBuyerProtection` | boolean | `true` if Marktplaats Buyer Protection is available on this listing | | `isFreeAd` | boolean | `true` if the item is offered for free | | `urgencyFeatureActive` | boolean | `true` if the seller has paid for urgency highlighting | | `vehicleBrand` | string | Vehicle brand (cars only) | | `vehicleModel` | string | Vehicle model (cars only) | | `vehicleYear` | integer | Year of manufacture (cars only) | | `vehicleMileage` | integer | Odometer reading in kilometres (cars only) | | `vehicleFuelType` | string | Fuel type in Dutch (e.g. "Benzine", "Diesel") | | `vehicleTransmission` | string | Gearbox type (e.g. "Automaat", "Handgeschakeld") | | `vehiclePower` | integer | Engine power in kW (when available) | | `vehicleColor` | string | Exterior colour in Dutch | | `vehicleCondition` | string | Vehicle condition description | | `attributes` | object | All raw listing attributes as key-value pairs | | `searchQuery` | string | The search query or URL that produced this result | ### Tips for Best Results #### Getting More Results - Marktplaats limits access to approximately 5,000 listings per search (167 pages × 30). For broad categories, split into smaller queries with price ranges or more specific keywords to access more of the catalogue. - Combine `searchUrls` with subcategory URLs for maximum coverage within a category. #### Using URLs from Your Browser - Apply all your filters on Marktplaats.nl first (category, location, distance, etc.) then copy the URL from your browser's address bar and paste it into `searchUrls`. The scraper will honour those filters. #### Dutch Language - Marktplaats is a Dutch marketplace — search terms in Dutch return more results. For example, use "fiets" instead of "bike", or "bank" instead of "sofa". - Category slugs in URLs are also in Dutch (e.g. `/l/computers-en-software/laptops/`). #### Price Filtering - Use `minPrice` and `maxPrice` to avoid wading through free items or high-end listings you are not interested in. Prices are in whole euros. #### Sorting Strategy - Use **Newest First** when monitoring new listings as they appear. - Use **Price: Low to High** to find the best deals at the top of your results. - Use **Most Relevant** for exploratory keyword searches where you are not sure what to expect. ### Pricing **No compute charges — you only pay per result returned.** | Results | Estimated Cost | |---------|----------------| | 100 | $0.10 | | 1,000 | $1.00 | | 10,000 | $10.00 | ### Integrations Export your data in JSON, CSV, Excel, XML, or RSS format. Connect to 1,500+ tools via: - **Zapier** / **Make** / **n8n** — Trigger workflows automatically when new listings appear - **Google Sheets** — Export results directly to a spreadsheet for analysis - **Slack** / **Email** — Get notified when new matching listings are found - **Webhooks** — Push data to your own systems in real time - **Apify API** — Full programmatic access, schedule runs, and automate data pipelines ### Legal & Ethical Use This actor is designed for legitimate business intelligence, market research, price monitoring, and lead generation. Users are responsible for complying with applicable laws and Marktplaats's Terms of Service. Do not use collected data for spam, harassment, or any unlawful purpose. # Actor input Schema ## `searchUrls` (type: `array`): Paste one or more Marktplaats search or category URLs. For example: https://www.marktplaats.nl/l/auto-s/bmw/ or a URL you copied from the Marktplaats website after applying filters. ## `searchQueries` (type: `array`): Plain-text search terms — for example 'iPhone 15 Pro' or 'LEGO City set'. The scraper will search Marktplaats and return matching listings. ## `maxResults` (type: `integer`): Maximum total number of listings to collect across all URLs and queries. Set to 0 for no limit. ## `sortBy` (type: `string`): Choose the order in which listings are collected from Marktplaats. ## `minPrice` (type: `integer`): Only include listings priced at or above this amount in euros. Leave empty for no minimum. ## `maxPrice` (type: `integer`): Only include listings priced at or below this amount in euros. Leave empty for no maximum. ## Actor input object example ```json { "searchUrls": [ "https://www.marktplaats.nl/l/auto-s/bmw/" ], "searchQueries": [], "maxResults": 100, "sortBy": "date_down" } ``` # Actor output Schema ## `overview` (type: `string`): Table of scraped listings with key fields. ## `details` (type: `string`): All fields including seller info, shipping, and vehicle attributes. # 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 = { "searchUrls": [ "https://www.marktplaats.nl/l/auto-s/bmw/" ], "searchQueries": [], "maxResults": 100, "sortBy": "date_down" }; // Run the Actor and wait for it to finish const run = await client.actor("solidcode/marktplaats-scraper").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 = { "searchUrls": ["https://www.marktplaats.nl/l/auto-s/bmw/"], "searchQueries": [], "maxResults": 100, "sortBy": "date_down", } # Run the Actor and wait for it to finish run = client.actor("solidcode/marktplaats-scraper").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 '{ "searchUrls": [ "https://www.marktplaats.nl/l/auto-s/bmw/" ], "searchQueries": [], "maxResults": 100, "sortBy": "date_down" }' | apify call solidcode/marktplaats-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solidcode/marktplaats-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Marktplaats Scraper", "description": "[💰 $1.0 / 1K] Scrape Marktplaats listings at scale.", "version": "1.0", "x-build-id": "flQkTrnja2y662r9K" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~marktplaats-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-marktplaats-scraper", "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/solidcode~marktplaats-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-marktplaats-scraper", "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/solidcode~marktplaats-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-marktplaats-scraper", "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": { "searchUrls": { "title": "Search or Category URLs", "type": "array", "description": "Paste one or more Marktplaats search or category URLs. For example: https://www.marktplaats.nl/l/auto-s/bmw/ or a URL you copied from the Marktplaats website after applying filters.", "items": { "type": "string" } }, "searchQueries": { "title": "Search Queries", "type": "array", "description": "Plain-text search terms — for example 'iPhone 15 Pro' or 'LEGO City set'. The scraper will search Marktplaats and return matching listings.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum total number of listings to collect across all URLs and queries. Set to 0 for no limit.", "default": 100 }, "sortBy": { "title": "Sort Results By", "enum": [ "date_down", "price_asc", "price_desc", "relevance" ], "type": "string", "description": "Choose the order in which listings are collected from Marktplaats.", "default": "date_down" }, "minPrice": { "title": "Minimum Price (€)", "minimum": 0, "type": "integer", "description": "Only include listings priced at or above this amount in euros. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum Price (€)", "minimum": 0, "type": "integer", "description": "Only include listings priced at or below this amount in euros. Leave empty for no maximum." } } }, "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 } } } } } } } } } } ```