Skip to main content
POST
/marktplaats/listings/search

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required
Required range: x >= 1
timeout
integer
default:300
Required range: 20 <= x <= 1500
domain
enum<string>
default:marktplaats.nl
Available options:
marktplaats.nl,
2dehands.be,
2ememain.be
keyword
string | null
Minimum string length: 1
category_id
integer | null
subcategory_id
integer | null
min_price
number | null
Required range: x >= 0
max_price
number | null
Required range: x >= 0
condition
enum<string>[] | null
Available options:
Nieuw,
Refurbished,
Zo goed als nieuw,
Gebruikt,
Niet werkend
delivery
enum<string>[] | null
Available options:
Ophalen,
Verzenden
advertiser
enum<string> | null
Available options:
Particulier,
Bedrijf
offered_since
enum<string> | null
Available options:
Vandaag,
Gisteren,
Een week,
Altijd
buy_now
boolean
default:false
urgent
boolean
default:false
postcode
string | null
distance_meters
integer | null
Required range: x >= 1000
min_construction_year
integer | null
Required range: x >= 1900
max_construction_year
integer | null
Required range: x >= 1900
min_mileage
integer | null
Required range: x >= 0
max_mileage
integer | null
Required range: x >= 0
attributes
object | null
attribute_ranges
object | null
sort
enum<string>
default:relevance
Available options:
relevance,
date_desc,
date_asc,
price_asc,
price_desc,
construction_year_desc,
construction_year_asc,
mileage_asc,
mileage_desc

Response

Successful Response

id
string
required
@type
string
default:MarktplaatsListingCard
url
string | null
listing_title
string | null
price
number | null
currency
string
default:EUR
price_type
string | null
city
string | null
country
string | null
country_code
string | null
latitude
number | null
longitude
number | null
created_at
integer | null
category_id
integer | null
verticals
string[]
attributes
object
traits
string[]
highlights
string[]
seller_id
integer | null
seller_name
string | null
is_verified_seller
boolean
default:false
is_promoted
boolean
default:false
is_reserved
boolean
default:false
has_video
boolean
default:false
has_nap_status
boolean
default:false
image
string | null
images
string[]