Skip to main content
POST
/autoscout24/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
​
make
string | null
Minimum string length: 1
​
model
string | null
Minimum string length: 1
​
article_type
enum<string>
default:C
Available options:
C,
B,
N,
X,
L
​
countries
enum<string>[]
Available options:
A,
B,
D,
E,
F,
I,
L,
NL
​
zip
string | null
Minimum string length: 1
​
radius_km
integer | null
Required range: x >= 1
​
conditions
enum<string>[]
Available options:
N,
U,
J,
O,
D,
S
​
body_types
enum<integer>[]
Available options:
1,
2,
3,
4,
5,
6,
7,
12,
13
​
fuel_types
enum<string>[]
Available options:
2,
3,
B,
C,
D,
E,
H,
L,
M,
O
​
transmissions
enum<string>[]
Available options:
A,
M,
S
​
drivetrains
enum<string>[]
Available options:
4,
F,
R
​
price_from
integer | null
Required range: x >= 0
​
price_to
integer | null
Required range: x >= 0
​
price_type
enum<string> | null
Available options:
private,
dealer
​
registration_year_from
integer | null
Required range: x >= 1900
​
registration_year_to
integer | null
Required range: x >= 1900
​
mileage_from
integer | null
Required range: x >= 0
​
mileage_to
integer | null
Required range: x >= 0
​
power_unit
enum<string>
default:kw
Available options:
hp,
kw
​
power_from
integer | null
Required range: x >= 0
​
power_to
integer | null
Required range: x >= 0
​
seller_type
enum<string> | null
Available options:
D,
P
​
seats_from
integer | null
Required range: x >= 1
​
seats_to
integer | null
Required range: x >= 1
​
doors_from
integer | null
Required range: x >= 1
​
doors_to
integer | null
Required range: x >= 1
​
cylinders
enum<string> | null
Available options:
3,
4,
6,
8,
10plus
​
equipment
enum<integer>[]
Available options:
1,
2,
3,
4,
5,
6,
10,
11,
12,
13,
15,
16,
17,
18,
19,
20,
21,
23,
25,
26,
27,
28,
29,
30,
31,
32,
34,
36,
38,
39,
40,
41,
42,
43,
44,
45,
46,
47,
48,
50,
52,
54,
111,
112,
113,
114,
115,
116,
117,
118,
119,
121,
122,
123,
124,
125,
126,
127,
128,
129,
130,
131,
132,
133,
134,
135,
136,
137,
138,
139,
140,
141,
142,
143,
144,
145,
146,
147,
148,
149,
150,
151,
152,
153,
154,
155,
156,
157,
158,
159,
160,
161,
162,
170,
173,
174,
187,
189,
190,
210,
211,
212,
213,
214,
215,
216,
217,
218,
219,
220,
221,
222,
223,
224,
225,
226,
227,
228,
229,
230,
231,
232,
233,
237,
238,
239,
240,
241,
242,
243,
244,
245,
248,
249,
250,
251
​
conditions_equipment
enum<integer>[]
Available options:
37,
49,
53,
110,
120
​
exterior_colors
enum<integer>[]
Available options:
1,
2,
3,
4,
5,
6,
7,
10,
11,
12,
13,
14,
15,
16
​
interior_colors
enum<integer>[]
Available options:
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11
​
paint_types
enum<string>[]
Available options:
M,
O,
P,
S,
U
​
upholstery_types
enum<string>[]
Available options:
AL,
CL,
FL,
OT,
PL,
VL
​
emission_class_from
integer | null
Required range: 1 <= x <= 6
​
emission_sticker_min
enum<integer> | null
Available options:
1,
2,
3,
4,
5
​
online_since_days
integer | null
Required range: x >= 1
​
previous_owners_to
integer | null
Required range: x >= 1
​
keyword
string | null
Minimum string length: 1
​
sort
enum<string>
default:standard
Available options:
standard,
price,
financerate,
leasing_rate,
make,
year,
mileage,
power,
age,
distance
​
descending
boolean
default:false

Response

Successful Response

​
id
string
required
​
@type
string
default:AutoScout24Listing
​
url
string | null
​
make
string | null
​
model
string | null
​
model_group
string | null
​
variant
string | null
​
model_version
string | null
​
price
number | null
​
mileage_km
integer | null
​
first_registration
string | null
​
power_kw
integer | null
​
power_hp
integer | null
​
fuel
string | null
​
transmission
string | null
​
body_type
string | null
​
displacement_cc
integer | null
​
offer_type
string | null
​
is_new
boolean
default:false
​
is_damaged
boolean
default:false
​
image
string | null
​
images
string[]
​
location
object | null
​
seller
object | null