Marktplaats Scraper

Scrape Marktplaats — the Netherlands' largest online classifieds marketplace, part of eBay. Search listings by keyword or browse any of 19 top-level categories, and get titles, prices in euros, price type, item condition, seller name, city, category, listing photo, posting date, and the listing URL. Price range and condition filters narrow results in a single run. HTTP-only against marktplaats.nl. No auth, no proxy.

What this actor does

• Two modes: searchListings (keyword) and browseCategory (19 categories from Cars to Collectibles)
• Filters: minimum and maximum price in EUR, plus item condition (new / used / refurbished)
• Paginated sweep: walks result pages until maxItems is reached or listings run out
• Resilient extraction: falls back to reading listing data from the page when the structured feed is unavailable
• Empty fields are omitted

Output per listing

• listingId — Marktplaats advert ID
• title — advert title
• price — asking price as a number
• currency — usually EUR
• priceType — how the price is offered, e.g. fixed, bidding, free, on request
• condition — item condition as advertised
• category, categoryName — Marktplaats category
• location — seller's city
• sellerId, sellerName — seller account
• datePlaced — when the advert was posted
• imageUrl — main listing photo
• listingUrl — advert page on Marktplaats
• recordType: "listing", scrapedAt

Input

Field	Type	Default	Description
mode	string	searchListings	searchListings / browseCategory
query	string	laptop	Keyword to search for, e.g. fiets, iphone (mode=searchListings)
categoryId	string	–	Category slug — auto_s, electronica, boeken, fietsen_en_brommers, … (mode=browseCategory)
minPrice	number	–	Drop listings priced below this (EUR)
maxPrice	number	–	Drop listings priced above this (EUR)
condition	string	–	new / used / refurbished
maxItems	int	50	Hard cap (1–500)

Example: keyword search with a price ceiling

{
  "mode": "searchListings",
  "query": "laptop",
  "maxPrice": 500,
  "maxItems": 100
}

Example: browse a category

{
  "mode": "browseCategory",
  "categoryId": "fietsen_en_brommers",
  "maxItems": 200
}

Example: mid-range used phones

{
  "mode": "searchListings",
  "query": "iphone",
  "minPrice": 200,
  "maxPrice": 600,
  "condition": "used",
  "maxItems": 150
}

Example: cars within a budget

{
  "mode": "browseCategory",
  "categoryId": "auto_s",
  "minPrice": 2000,
  "maxPrice": 8000,
  "maxItems": 300
}

Use cases

• Resale and arbitrage — spot underpriced listings in a category against the going rate
• Price benchmarking — track the second-hand value of a product across the Dutch market
• Market research — measure supply and pricing by category and city
• Inventory sourcing — build lead lists of sellers offering stock you buy
• Competitor monitoring — watch how a rival's adverts are priced and how often they post
• Data journalism — analyse second-hand consumption patterns in the Netherlands

FAQ

What is Marktplaats? The Netherlands' dominant classifieds marketplace, owned by eBay — the Dutch equivalent of Craigslist or eBay Kleinanzeigen. See marktplaats.nl.

Is this affiliated with Marktplaats or eBay? No. This is a third-party actor reading their public listing pages.

Do I need an account? No. Only publicly visible listing data is collected — seller contact details behind Marktplaats' messaging system are not returned.

Is the site in Dutch? Yes, and so is the data. Titles, conditions, and category names come back in Dutch (zo goed als nieuw = as good as new, gebruikt = used). Search with Dutch keywords for the best coverage — fiets returns far more than bicycle.

Where do I find a category slug? It's the path segment in a Marktplaats category URL: marktplaats.nl/l/electronica/ gives electronica. The input dropdown lists the 19 top-level categories with English labels.

What does priceType mean? How the price is offered — a fixed asking price, an auction-style bid, free giveaway, or price on request. Listings with no fixed price have no price value, so price filters won't match them.

Why did the price filter return fewer items than expected? Filters are applied to each listing after it's read. Listings quoted as "bidding" or "on request" carry no numeric price and are excluded when you set a price bound.

Are seller details always available? sellerName is usually present; sellerId depends on how the listing was published. Private sellers often show only a display name.

Can I get the full listing description? Not from search and category results — those carry the title, price, and summary attributes. Open listingUrl for the full advert text.

How fresh is the data? Live at run time. Marktplaats listings turn over quickly, so re-running gives current availability and pricing.