Marktplaats Scraper: Dutch & Belgian Classifieds

Unofficial. This Actor is not affiliated with, authorised by, endorsed by, or in any way officially connected to Marktplaats, 2dehands or 2ememain. The names are trademarks of their respective owners and are used here only to describe what this tool reads. It reads the same public search pages a browser does.

Marktplaats Scraper reads classified ads from marktplaats.nl (Netherlands), 2dehands.be (Belgium, Dutch) and 2ememain.be (Belgium, French). One input, country, picks the site; the output fields are the same on all three.

Supported sites

country	Site	Market	Language of text fields	countryCode
nl	marktplaats.nl	Netherlands	Dutch	NL
be-nl	2dehands.be	Belgium	Dutch	BE
be-fr	2ememain.be	Belgium	French	BE

The two Belgian sites are one inventory shown in two languages: a search for the same term returns largely the same ads, with category names, condition and delivery in the site's language. Pick the one whose language you want. Category ids are the same on all three sites; category paths are not (see "Things to know").

What data can you extract?

For every listing the search pages show: title, a short text snippet, price and price type, the placement date as the site words it, city and coordinates, up to four image URLs, seller name and id, category ids, condition and delivery, the site's other attributes (storage, colour and so on, per category), and flags for promoted and reserved listings.

How it works

• Keyword or category. Give searchQueries (one search per term) and/or categoryPaths (the part of a category address after /l/, for example telecommunicatie/mobiele-telefoons-apple-iphone).
• Filters run after fetching. This Actor applies price range, seller kind, promoted/reserved exclusion and the optional keyword check after fetching. There is no sort option: the order is the site's own.
• 30 listings per page. The sites stop serving results after a certain page (167 at most, sometimes fewer). The run ends on the first empty page.
• No proxy required by default. An optional proxy setting is available if needed.

Things to know

• Dates are the site's own words ("Vandaag", "Gisteren", "Aujourd'hui", or a short date), with no time of day. The Actor does not invent an ISO date.
• sellerTypeInferred is inferred. The sites do not label private and business sellers; a listing with the business-profile traits counts as business.
• price is null for FAST_BID listings (the site gives no amount) and for SEE_DESCRIPTION listings. MIN_BID prices are a starting bid.
• The text is a snippet of about 200 characters. Phone numbers and e-mail addresses are not in search results and are not fetched.
• Sponsored placements above the results are left out. Paid "top of the day" listings repeat across pages; each id is returned once and flagged isPromoted.
• The two Belgian sites carry the same ads in two languages.
• Category paths are language-specific. On be-fr (2ememain.be) the slugs are French, for example telecoms/telephonie-mobile-apple-iphone; the Dutch slug telecommunicatie/mobiele-telefoons-apple-iphone answers 404 there and the run fails with a message saying so. Copy the path from the site you search.
• countryCode is the site's own value when a listing carries one; the sites do not send it in search results, so it is NL for nl and BE for be-nl and be-fr.

Input

Field	Meaning
country	nl, be-nl or be-fr
searchQueries, categoryPaths	what to search; at least one is required
minPrice, maxPrice	euro bounds, inclusive, applied after fetching
sellers	any, private or business (inferred)
excludePromoted, excludeReserved	drop those listings
requireKeywordMatch	every query word must be in the title or snippet
maxItems, maxPages	caps (30 listings per page)
proxyConfiguration	optional; off by default

Example output

One row, from a platform run on 2026-11-11 (keyword iphone, country nl; the description snippet is shortened and the image list cut to 2 entries). All 36 fields are shown; a field the site gives no value for is null:

{
  "id": "m2463299456",
  "url": "https://www.marktplaats.nl/v/telecommunicatie/mobiele-telefoons-apple-iphone/m2463299456-iphone-16-pro-128gb-zwart-zo-goed-als-nieuw",
  "title": "iPhone 16 Pro 128GB Zwart - Zo goed als nieuw",
  "descriptionSnippet": "Iphone 16 pro 128 gb - zwart te koop! Batterijconditie is 89%, en altijd hoesje en screenp...",
  "price": 600,
  "priceType": "MIN_BID",
  "currency": "EUR",
  "dateText": "Vandaag",
  "city": "Enschede",
  "country": "Nederland",
  "countryCode": "NL",
  "latitude": 52.216171164603,
  "longitude": 6.8516277982403,
  "abroad": false,
  "imageUrls": [
    "https://images.marktplaats.com/api/v1/hz-mp-pro-listing/images/b2267465-d9df-4adc-8a34-5eabd356e11c?rule=ecg_mp_eps$_82.jpg",
    "https://images.marktplaats.com/api/v1/hz-mp-pro-listing/images/df3a4468-3b67-4ac2-951d-7d6c436a7466?rule=ecg_mp_eps$_82.jpg"
  ],
  "sellerId": 23257313,
  "sellerName": "Isabelle",
  "sellerVerified": false,
  "sellerWebsiteUrl": null,
  "sellerTypeInferred": "private",
  "categoryId": 1953,
  "parentCategoryId": 820,
  "verticals": [
    "mobile_phones_apple_iphone",
    "telecommunication"
  ],
  "condition": "Zo goed als nieuw",
  "delivery": "Ophalen",
  "attributes": {
    "condition": "Zo goed als nieuw",
    "delivery": "Ophalen",
    "storage": "128 GB",
    "battery health": "89 %",
    "color": "Zwart"
  },
  "traits": [
    "DAG_TOPPER",
    "PACKAGE_FREE"
  ],
  "priorityProduct": "DAGTOPPER",
  "isPromoted": true,
  "isReserved": false,
  "hasPhoneFlag": false,
  "searchCountry": "nl",
  "searchQuery": "iphone",
  "categoryPath": null,
  "searchUrl": "https://www.marktplaats.nl/q/iphone/",
  "scrapedAt": "2026-11-11T06:32:21.482807+00:00"
}

Pricing

The current price is on the Actor's Pricing tab.