docs / marktplaats

Marktplaats API

base /marktplaats/v14 endpoints

post/marktplaats/v1/search1 credit

Keyword or category search with filters, sort, location, offset pagination (limit=30).

Parameter		Allowed / range	Description
query	optional	—	Free-text keyword. (search needs query OR l1/l2_category_id.)
site = nl	optional	nl · be_nl · be_fr	Marketplace edition — each is a separate site/country.
l1_category_id	optional	—	Top-level category id (discover via the categories action).
l2_category_id	optional	—	Sub-category id under l1 (discover via the categories action).
sort_by	optional	OPTIMIZED · PRICE · DATE	Sort field. Common Adevinta keys shown; others accepted.
sort_order	optional	INCREASING · DECREASING	Sort direction.
price_from	optional	—	Minimum price IN CENTS (Marktplaats uses cents: 1000 = EUR 10).
price_to	optional	—	Maximum price IN CENTS (5000 = EUR 50).
postcode	optional	—	Postal code center for a distance search.
distance_meters	optional	—	Search radius in METERS around postcode (10000 = 10 km).
offset = 0	optional	0–	Pagination offset (skip N, page size 30). Page with meta.next_offset.

Try in playground →

post/marktplaats/v1/listing1 credit

Listing detail by item_id and/or vip_url; enriched with full product details (price, availability, specs).

Parameter		Allowed / range	Description
item_id	optional	—	Marktplaats item id, e.g. m2407996125. (listing needs item_id OR vip_url.)
vip_url	optional	—	Site-relative VIP page path (alternative to item_id).
site = nl	optional	nl · be_nl · be_fr	Marketplace edition — each is a separate site/country.

Try in playground →

post/marktplaats/v1/categories1 credit

Category tree from search facets, or browse a category (l1/l2) with listings.

Parameter		Allowed / range	Description
query	optional	—	Optional keyword to scope the category tree.
site = nl	optional	nl · be_nl · be_fr	Marketplace edition — each is a separate site/country.
l1_category_id	optional	—	Browse this top-level category's listings.
l2_category_id	optional	—	Browse this sub-category's listings.
offset = 0	optional	0–	Pagination offset (skip N, page size 30). Page with meta.next_offset.

Try in playground →

post/marktplaats/v1/seller_listings1 credit

Active listings for a seller; offset pagination via seller-name LRP search (name auto-resolved from profile when omitted).

Parameter		Allowed / range	Description
seller_id	required	—	Marktplaats seller id (from a listing's seller.seller_id).
seller_name	optional	—	Seller display name — speeds resolution; auto-resolved when omitted.
site = nl	optional	nl · be_nl · be_fr	Marketplace edition — each is a separate site/country.
offset = 0	optional	0–	Pagination offset (skip N, page size 30). Page with meta.next_offset.

Try in playground →

Example request · search

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"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}