Marktplaats API API
The Marktplaats API returns listings from the leading Dutch and Belgian classifieds marketplace as clean JSON.
4 actionsLive JSON1,000 free creditsMCP-ready
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary search endpoint returns listings with price, condition, location, seller and images, plus facets and pagination, and you can pull a listing, the category tree and a seller's listings. It is built for price intelligence, resale tools and market analytics that need Benelux classifieds data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.
Live example
Real request and response JSON
Captured from the indexed primary action, search, on .
Captured request
{
"method": "POST",
"url": "https://api.reefapi.com/marktplaats/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "iphone",
"site": "nl"
}
}Captured response
{
"ok": true,
"meta": {
"api": "marktplaats",
"endpoint": "search",
"mode": "live",
"latency_ms": 2367.6,
"record_count": 30,
"bytes": 174195,
"cache_hit": false,
"method": "lrp_json_api",
"site": "nl",
"url": "https://www.marktplaats.nl/lrp/api/search",
"offset": 0,
"has_more": true,
"limit": 30,
"total": 40693,
"next_offset": 30
},
"data": {
"listings": [
{
"item_id": "m[redacted-phone]",
"title": "Iphone 16 nieuw",
"description": "Ligt in de kast ivm zakelijk nieuw abonnement en nieuw toestel. Toestel wordt niet naar het buitenland verzonden en voorkeur gaat naar ophalen zodat u hem ook kunt testen.",
"category_id": 1953,
"condition": "like_new",
"condition_original": "Zo goed als nieuw",
"delivery": "Ophalen of Verzenden",
"shipping_available": true,
"reserved": false,
"attributes": [
{
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"values": "[trimmed-depth]"
}
],
"extended_attributes": [
{
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"values": "[trimmed-depth]"
}
],
"verticals": [
"mobile_phones_apple_iphone",
"telecommunication",
"barcode-supported"
],
"location": {
"city": "Noordwolde",
"country": "Nederland",
"postcode": null,
"distance_meters": -1000,
"latitude": 52.8772899437,
"longitude": 6.1501214113093
},
"date": "Vandaag",
"images": [
"https://images.marktplaats.com/api/v1/hz-mp-pro-listing/images/5322a883-10a1-42f5-ab70-7fe39a54750d?rule=ecg_mp_eps$_82.jpg"
],
"image_count": 1,
"seller": {
"seller_id": 3676621,
"seller_name": "j&l",
"seller_type": "private",
"is_verified": false,
"show_soi_url": true,
"show_website_url": false
},
"other_seller_listings": null,
"vip_url": "/v/telecommunicatie/mobiele-telefoons-apple-iphone/m[redacted-phone]-iphone-16-nieuw",
"url": "https://www.marktplaats.nl/v/telecommunicatie/mobiele-telefoons-apple-iphone/m[redacted-phone]-iphone-16-nieuw",
"price_cents": 0,
"price": 0,
"price_type": "FAST_BID",
"price_label": null,
"currency": "EUR"
},
{
"item_id": "m[redacted-phone]",
"title": "Apple iPhone 13 Zwart 128GB - Zo goed als nieuw",
"description": "Te koop: een zo goed als nieuwe apple iphone 13 in het zwart met 128gb opslagcapaciteit. De telefoon verkeert in uitstekende staat en heeft een batterijconditie van 100%. Geheel schadevrij.",
"category_id": 1953,
"condition": "like_new",
"condition_original": "Zo goed als nieuw",
"delivery": "Ophalen of Verzenden",
"shipping_available": true,
"reserved": false,
"attributes": [
{
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"values": "[trimmed-depth]"
}
],
"extended_attributes": [
{
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"values": "[trimmed-depth]"
}
],
"verticals": [
"mobile_phones_apple_iphone",
"telecommunication",
"barcode-supported"
],
"location": {
"city": "Purmerend",
"country": "Nederland",
"postcode": null,
"distance_meters": -1000,
"latitude": 52.504258982909,
"longitude": 4.9375732044233
},
"date": "Vandaag",
"images": [
"https://images.marktplaats.com/api/v1/hz-mp-pro-listing/images/4a459ee3-413d-4fb1-b67e-77d85b1b1127?rule=ecg_mp_eps$_82.jpg"
],
"image_count": 1,
"seller": {
"seller_id": 725332,
"seller_name": "AK",
"seller_type": "private",
"is_verified": false,
"show_soi_url": true,
"show_website_url": false
},
"other_seller_listings": null,
"vip_url": "/v/telecommunicatie/mobiele-telefoons-apple-iphone/m[redacted-phone]-apple-iphone-13-zwart-128gb-zo-goed-als-nieuw",
"url": "https://www.marktplaats.nl/v/telecommunicatie/mobiele-telefoons-apple-iphone/m[redacted-phone]-apple-iphone-13-zwart-128gb-zo-goed-als-nieuw",
"price_cents": 25000,
"price": 250,
"price_type": "MIN_BID",
"price_label": null,
"currency": "EUR"
},
{
"item_id": "a[redacted-phone]",
"title": "iPhone 13 Pro 128GB | 4 Gratis Accessoires – Accu tot 100%",
"description": "Ben je op zoek naar een betrouwbare iphone voor de beste prijs? Bij mobisite.nl krijg je altijd zekerheid, kwaliteit én extra voordelen: nu tijdelijk 4 gratis accessoires (t.w.v. €45): hoesje, sc",
"category_id": 1953,
"condition": "like_new",
"condition_original": "Zo goed als nieuw",
"delivery": "Verzenden",
"shipping_available": true,
"reserved": false,
"attributes": [
{
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"values": "[trimmed-depth]"
}
],
"extended_attributes": [
{
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"key": "[trimmed-depth]",
"value": "[trimmed-depth]",
"values": "[trimmed-depth]"
}
],
"verticals": [
"mobile_phones_apple_iphone",
"telecommunication",
"barcode-supported"
],
"location": {
"city": null,
"country": null,
"postcode": null,
"distance_meters": -1000,
"latitude": 0,
"longitude": 0
},
"date": "Vandaag",
"images": [
"https://admarkt-cdn.marktplaats.com/api/v1/icas-mp-pro-admarkt/images/dc/dca7457a-6a98-4156-a846-6c335cf09754?rule=eps_82.JPG",
"https://admarkt-cdn.marktplaats.com/api/v1/icas-mp-pro-admarkt/images/ca/ca3bc56b-b140-4fd2-9495-d2c10d7f29e2?rule=eps_82.JPG",
"https://admarkt-cdn.marktplaats.com/api/v1/icas-mp-pro-admarkt/images/54/54b3d56e-4e03-416b-9878-e66c2c347160?rule=eps_82.JPG"
],
"image_count": 3,
"seller": {
"seller_id": 57429132,
"seller_name": "Mobisite.nl",
"seller_type": "business",
"is_verified": false,
"show_soi_url": true,
"show_website_url": true
},
"other_seller_listings": null,
"vip_url": "/v/telecommunicatie/mobiele-telefoons-apple-iphone/a[redacted-phone]-iphone-13-pro-128gb-4-gratis-accessoires-accu-tot-100",
"url": "https://www.marktplaats.nl/v/telecommunicatie/mobiele-telefoons-apple-iphone/a[redacted-phone]-iphone-13-pro-128gb-4-gratis-accessoires-accu-tot-100",
"price_cents": 34900,
"price": 349,
"price_type": "FIXED",
"price_label": null,
"currency": "EUR"
}
],
"facets": [
{
"key": "PriceCents",
"type": "AttributeRangeFacet"
},
{
"key": "RelevantCategories",
"type": "CategoryTreeFacet",
"categories": [
{
"id": "[trimmed-depth]",
"selected": "[trimmed-depth]",
"isValuableForSeo": "[trimmed-depth]",
"dominant": "[trimmed-depth]",
"label": "[trimmed-depth]",
"key": "[trimmed-depth]",
"parentId": "[trimmed-depth]",
"parentKey": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"histogramCount": "[trimmed-depth]",
"selected": "[trimmed-depth]",
"isValuableForSeo": "[trimmed-depth]",
"dominant": "[trimmed-depth]",
"label": "[trimmed-depth]",
"key": "[trimmed-depth]",
"parentId": "[trimmed-depth]",
"parentKey": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"histogramCount": "[trimmed-depth]",
"selected": "[trimmed-depth]",
"isValuableForSeo": "[trimmed-depth]",
"dominant": "[trimmed-depth]",
"label": "[trimmed-depth]",
"key": "[trimmed-depth]",
"parentId": "[trimmed-depth]",
"parentKey": "[trimmed-depth]"
}
]
},
{
"id": 2947,
"key": "buyitnow",
"type": "AttributeGroupFacet",
"label": "Direct Kopen",
"attributeGroup": [
{
"attributeValueKey": "[trimmed-depth]",
"attributeValueId": "[trimmed-depth]",
"attributeValueLabel": "[trimmed-depth]",
"histogramCount": "[trimmed-depth]",
"selected": "[trimmed-depth]",
"isValuableForSeo": "[trimmed-depth]"
}
],
"singleSelect": false,
"categoryId": 0
}
],
"offset": 0,
"has_more": true,
"limit": 30,
"total": 40693,
"next_offset": 30
}
}Actions
What the Marktplaats API API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Keyword or category search with filters, sort, location, offset pagination (limit=30). | Ops teams call search to get keyword or category search with filters, sort, location, offset pagination (limit=30).. | query, site, l1_category_id, l2_category_id, sort_by, ... |
| listing | Listing detail by item_id and/or vip_url; enriched with full product details (price, availability, specs). | Developer tools call listing to get listing detail by item_id and/or vip_url; enriched with full product details (price, availabi…. | item_id, vip_url, site |
| categories | Category tree from search facets, or browse a category (l1/l2) with listings. | Validation workflows call categories to get category tree from search facets, or browse a category (l1/l2) with listings.. | query, site, l1_category_id, l2_category_id, offset |
| seller_listings | Active listings for a seller; offset pagination via seller-name LRP search (name auto-resolved from profile when omitted). | Data-quality teams call seller_listings to get active listings for a seller; offset pagination via seller-name LRP search (name auto-resolve…. | seller_id, seller_name, site, offset |
Code samples
Call search from your stack
curl -X POST https://api.reefapi.com/marktplaats/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone","site":"nl"}'import requests
r = requests.post(
"https://api.reefapi.com/marktplaats/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "iphone",
"site": "nl"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/marktplaats/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "iphone",
"site": "nl"
}),
});
const { ok, data, meta, error } = await res.json();MCP one-liner
Ask your MCP-connected assistant: call reefapi.marktplaats.search with {"query":"iphone","site":"nl"}.Use cases
Who uses this API and why
- Price-intelligence teams call search to track second-hand prices across Marktplaats categories.
- Resale tools use seller_listings to monitor a specific seller's active inventory.
- Market analysts use facets and categories to size supply for a product in the Benelux market.
FAQ
Questions developers ask before integrating
What is the Marktplaats API API?
Marktplaats API API is a ReefAPI endpoint group for marktplaats api It returns live JSON through POST requests under /marktplaats/v1.
Is the Marktplaats API API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Marktplaats API calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Marktplaats API login or account?
No login to Marktplaats API is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Marktplaats API data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Marktplaats API API use?
Marktplaats API actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Marktplaats API from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call marktplaats actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Marktplaats API API a Marktplaats API scraper?
It is the managed alternative to a DIY Marktplaats API scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same marktplaats api back as clean JSON.
Why does my Marktplaats API scraper keep getting blocked?
Most Marktplaats API scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.