🛒 Marktplaats.nl Scraper

Extract classified listings from Marktplaats.nl — the Netherlands' largest classifieds platform with 10M+ active listings and 8M+ monthly visitors. Also supports 2dehands.be (Belgium Flemish) and 2ememain.be (Belgium French) — all three share the same backend.

---

⚡ What It Does

Calls Marktplaats's internal JSON API directly for fast, structured data. No browser overhead, no HTML parsing — pure API calls returning clean JSON. Returns price, seller info, condition, location, images and category-specific attributes.

Default run (prefill input): Searches "iphone" on Marktplaats.nl, completes in under 1 minute, and produces a non-empty dataset.

---

🔧 How It Works

Marktplaats exposes an internal search API at /lrp/api/search. This actor calls it directly:

GET https://www.marktplaats.nl/lrp/api/search?query=iphone&limit=30&offset=0
→ JSON: { listings: [...], totalResultCount: 41595 }

Pagination via offset increments. No authentication required. ~200+ listings per minute.

---

🚀 Quick Start

Default Input (works out of the box)

{
  "query": "iphone",
  "maxListings": 50
}

🔍 Advanced Search

{
  "platform": "marktplaats.nl",
  "query": "bmw 320",
  "categoryId": "91",
  "postcode": "1012AB",
  "distanceMeters": 50000,
  "minPrice": 500000,
  "maxPrice": 2000000,
  "sortBy": "PRICE",
  "sortOrder": "INCREASING",
  "scrapeDetails": true,
  "maxListings": 200,
  "requestDelay": 500
}

---

📋 Input Parameters

Parameter	Type	Default	Description
platform	string	marktplaats.nl	🇳🇱 marktplaats.nl, 🇧🇪 2dehands.be or 🇧🇪 2ememain.be
query	string	"iphone"	🔎 Search keywords
categoryId	string	""	📂 L1 category ID (see list below)
subcategoryId	string	""	📁 L2 subcategory ID
postcode	string	""	📍 Dutch/Belgian postcode for location search
distanceMeters	integer	0	📏 Radius from postcode (meters)
minPrice	integer	0	💰 Min price in cents (50000 = €500)
maxPrice	integer	0	💰 Max price in cents (200000 = €2000)
sortBy	string	SORT_INDEX	📊 SORT_INDEX (newest), PRICE, OPTIMIZED (relevance)
sortOrder	string	DECREASING	⬆️ DECREASING or INCREASING
scrapeDetails	boolean	false	📄 Fetch detail pages for full description
maxListings	integer	50	🔢 Total listings cap (max ~5000 per query)
proxyConfiguration	object	Apify auto	🔒 Proxy settings
requestDelay	integer (ms)	500	⏱️ Delay between API calls

---

🌍 Platforms

Platform	Domain	Country	Language
🇳🇱 marktplaats.nl	marktplaats.nl	Netherlands	Dutch
🇧🇪 2dehands.be	2dehands.be	Belgium	Flemish Dutch
🇧🇪 2ememain.be	2ememain.be	Belgium	French

All three platforms share the same backend API — same query parameters, same response format. One actor, three countries.

---

📂 Category IDs

ID	🇳🇱 Category (Dutch)	🇬🇧 Category (English)
91	Auto's	🚗 Cars
31	Telecommunicatie	📱 Telecom / Phones
504	Computers en Software	💻 Computers
322	Huis en Inrichting	🏠 Home & Furniture
621	Kleding - Dames	👗 Women's Clothing
728	Sport en Fitness	⚽ Sports
1032	Fietsen en Brommers	🚲 Bicycles & Mopeds
378	Muziek en Instrumenten	🎸 Music
482	Tuin en Terras	🌿 Garden
820	Elektronica en Domotica	🔌 Electronics
239	Doe-het-zelf en Verbouw	🔨 DIY & Construction
1085	Kinderen en Baby's	👶 Kids & Baby
1098	Dieren en Toebehoren	🐕 Animals & Pets
428	Spelcomputers en Games	🎮 Gaming

---

📦 Output

Search Mode (scrapeDetails: false)

{
  "listingId": "m2045678901",
  "platform": "marktplaats.nl",
  "title": "iPhone 15 Pro 256GB Zwart Titanium",
  "price": 899,
  "priceType": "fixed",
  "priceTypeOriginal": "Vaste prijs",
  "currency": "EUR",
  "condition": "like_new",
  "conditionOriginal": "Zo goed als nieuw",
  "category": "Mobiele telefoons",
  "sellerName": "TechShop Amsterdam",
  "sellerId": "12345678",
  "sellerType": "business",
  "location": "Amsterdam",
  "date": "2026-05-01T14:23:00Z",
  "description": "Te koop: een zo goed als nieuwe Apple iPhone 15 Pro...",
  "shippingAvailable": true,
  "images": ["https://images.marktplaats.com/..."],
  "url": "https://www.marktplaats.nl/v/telecommunicatie/mobiele-telefoons/m2045678901-iphone-15-pro",
  "scrapedAt": "2026-05-04T09:00:00Z"
}

---

🇳🇱 Dutch → English Translation

💰 Price Types

🇳🇱 Dutch	🇬🇧 English	Description
Vaste prijs	fixed	Fixed price, no negotiation
Bieden	bidding	Make an offer
Gratis	free	Free item
Vraagprijs	asking	Asking price (negotiable)
Ruilen	trade	Trade / exchange
Zie omschrijving	see_description	Check the listing description

📋 Conditions

🇳🇱 Dutch	🇬🇧 English
Nieuw	new
Zo goed als nieuw	like_new
Gebruikt	used

Both original Dutch and translated English values are provided in every record (priceType + priceTypeOriginal, condition + conditionOriginal).

---

🎯 Use Cases

• 🛍️ E-commerce arbitrage — find underpriced items for resale
• 🚗 Used car market analysis — price trends, inventory monitoring
• 📊 Market research — consumer pricing, category demand analysis
• 🏦 Insurance — second-hand item valuation reference data
• 📈 Price monitoring — track specific products or categories over time
• 🏢 Competitive analysis — monitor competitor listings and pricing

---

⚙️ Technical Notes

Feature	Detail
🔗 Engine	Direct internal JSON API — no browser, no HTML parsing
🔓 Auth	None required — public API endpoint
📄 Pagination	Offset-based, 30 results per page
⚠️ 5000 Limit	Marktplaats caps at ~5000 results per query. Split by price range for more.
💰 Prices	API returns cents → output converts to EUR
🌐 Proxy	Works from datacenter IPs (no residential needed)
🔄 Rate Limiting	Moderate. Default 500ms delay is safe.

---

💸 Cost & Performance

Mode	Speed	CU per 100 listings	Cost estimate
🚀 Search only	~200+/min	~0.002	Almost free
📄 With details	~10-20/min	~0.01	Very cheap

Pure API calls with no browser = fastest and cheapest classifieds scraper on Apify Store.

---

📜 Changelog

Version	Date	Notes
1.0.0	2026-05-04	🎉 Initial release — direct API, 3 platforms, Dutch↔English translation, price/condition mapping