Skip to main content
GET
Search vehicles
Credits: 5 per successful request. Genuine empty searches and failures cost zero credits. Use native make/model slugs, such as volkswagen / golf, bmw, or mercedes-benz. A model requires a make. Unknown make/model pages return 404; they are not widened into an unrestricted search. Price ranges are in EUR, mileage in kilometres, power in kW, and year ranges apply to first registration. Minimum values must not exceed maximum values. radius requires zip and is measured in kilometres. Unsupported enum values and malformed ranges return 422. sort_by supports best_match, price_asc, price_desc, mileage_asc, mileage_desc, registration_asc, registration_desc, power_asc, power_desc and newest.

Response fields

results[] contains listing IDs and URLs, title/images, price/currency/evaluation flags, make/model/variant/version, mileage, registration month/year, power, displacement, fuel, transmission, damaged state, availability, location and seller information. Public seller fields include company/contact name, profile and imprint links, phone numbers and rating/count where present. vehicle_details and wltp_values retain the labels shown on the card; vehicle retains additional native vehicle attributes. Public optional fields also include leasing offers, delivery/video/360 indicators, original-price labels, seller-rating state, quality seals and online-purchase seller information. These fields reflect what the search card exposes and are absent when the source omits them. filters contains current native options. applied_filters records the source’s applied query. source_url identifies the fetched search. total_results, total_pages, page, has_next_page, next_page and pagination_cap describe pagination. Source ordering can place promoted listings ahead of the selected sort. Promoted placement and changing inventory can repeat IDs; use result_type, result_section, ad_tier and position to interpret source rank and deduplicate IDs when collecting pages. Follow next_page; up to 200 pages are browsable per query. Narrow filters to cover deeper inventory. Full listing detail is not included.

Authorizations

X-API-Key
string
header
required

Query Parameters

market
enum<string>
default:de
Available options:
de,
at,
be,
es,
fr,
it,
lu,
nl
make
string | null

Native make slug, e.g. volkswagen or bmw.

model
string | null

Native model slug, e.g. golf. Requires make.

price_min
integer | null
Required range: x >= 0
price_max
integer | null
Required range: x >= 0
mileage_min
integer | null

Kilometres.

Required range: x >= 0
mileage_max
integer | null
Required range: x >= 0
year_min
integer | null
Required range: 1900 <= x <= 2100
year_max
integer | null
Required range: 1900 <= x <= 2100
power_min
integer | null

Engine power in kW.

Required range: x >= 0
power_max
integer | null
Required range: x >= 0
fuel_type
enum<string> | null
Available options:
petrol,
diesel,
electric,
hybrid_petrol,
hybrid_diesel,
cng,
hydrogen,
lpg,
ethanol,
other
transmission
enum<string> | null
Available options:
automatic,
manual,
semi_automatic
body_type
enum<string> | null
Available options:
compact,
convertible,
coupe,
suv,
station_wagon,
sedan,
van,
transporter,
other
seller_type
enum<string> | null
Available options:
dealer,
private
condition
enum<string> | null
Available options:
new,
used,
annual,
classic,
demo,
day_registration
zip
string | null

Postal code in the requested market.

Maximum string length: 10
radius
integer | null

Kilometres; requires zip.

Required range: 1 <= x <= 400
sort_by
enum<string>
default:best_match
Available options:
best_match,
price_asc,
price_desc,
mileage_asc,
mileage_desc,
registration_asc,
registration_desc,
power_asc,
power_desc,
newest
page
integer
default:1
Required range: 1 <= x <= 200

Response

Successful Response

market
string
required
source_url
string
required
total_results
integer
required
total_pages
integer
required
page
integer
required
has_next_page
boolean
required
next_page
integer | null
required
results
AutoScout24Listing · object[]
required
filters
Filters · object
required
applied_filters
Applied Filters · object
required
latency_ms
integer
required
page_size
integer
default:20
pagination_cap
integer
default:200