/autoscout24/listings/search

curl --request POST \
  --url https://api.anysite.io/api/autoscout24/listings/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "make": "<string>",
  "model": "<string>",
  "article_type": "C",
  "countries": [],
  "zip": "<string>",
  "radius_km": 2,
  "conditions": [],
  "body_types": [],
  "fuel_types": [],
  "transmissions": [],
  "drivetrains": [],
  "price_from": 1,
  "price_to": 1,
  "registration_year_from": 1901,
  "registration_year_to": 1901,
  "mileage_from": 1,
  "mileage_to": 1,
  "power_unit": "kw",
  "power_from": 1,
  "power_to": 1,
  "seats_from": 2,
  "seats_to": 2,
  "doors_from": 2,
  "doors_to": 2,
  "equipment": [],
  "conditions_equipment": [],
  "exterior_colors": [],
  "interior_colors": [],
  "paint_types": [],
  "upholstery_types": [],
  "emission_class_from": 3,
  "online_since_days": 2,
  "previous_owners_to": 2,
  "keyword": "<string>",
  "sort": "standard",
  "descending": false
}
'

[
  {
    "id": "<string>",
    "@type": "AutoScout24Listing",
    "url": "<string>",
    "make": "<string>",
    "model": "<string>",
    "model_group": "<string>",
    "variant": "<string>",
    "model_version": "<string>",
    "price": 123,
    "mileage_km": 123,
    "first_registration": "<string>",
    "power_kw": 123,
    "power_hp": 123,
    "fuel": "<string>",
    "transmission": "<string>",
    "body_type": "<string>",
    "displacement_cc": 123,
    "offer_type": "<string>",
    "is_new": false,
    "is_damaged": false,
    "image": "<string>",
    "images": [],
    "location": {
      "@type": "AutoScout24Location",
      "country_code": "<string>",
      "zip": "<string>",
      "city": "<string>",
      "street": "<string>",
      "latitude": 123,
      "longitude": 123
    },
    "seller": {
      "@type": "AutoScout24Seller",
      "id": "<string>",
      "type": "<string>",
      "is_dealer": false,
      "company_name": "<string>",
      "contact_name": "<string>",
      "image": "<string>",
      "alias": "<string>",
      "info_url": "<string>",
      "culture": "<string>",
      "phones": []
    }
  }
]

/autoscout24

/autoscout24/listings/search

Search AutoScout24 car listings with the full filter set: make/model, article type, seller countries, postal code and radius, condition (new/used/demo/…), body type, fuel type, transmission, drivetrain, price range and price type, registration year range, mileage range, power range, seller type, seats and doors, cylinders, equipment, condition requirements, exterior and interior colors, paint and upholstery, emission class, online-since, previous owners and free-text keyword. Sort by best match, price, registration, mileage or power. Returns listing cards with price, vehicle summary, location and seller.

Price: 20 credits per 20 results

💡 AI Hint: Search AutoScout24 car listings. make/model are slugs (e.g. make=‘bmw’, model=‘x5’). Filter by countries (DE/AT/IT/BE/NL/ES/FR/LU), zip+radius_km, conditions, body_types, fuel_types, transmissions, drivetrains, price_from/price_to (EUR), registration_year_from/to, mileage_from/to (km), power_from/to (with power_unit kw or hp), seller_type, seats/doors, cylinders, equipment, exterior/interior colors, paint/upholstery, emission_class_from, online_since_days, previous_owners_to, keyword. Sort by best/price/first_registration/mileage/power with descending flag. count is required.

POST

api

autoscout24

listings

/autoscout24/listings/search

curl --request POST \
  --url https://api.anysite.io/api/autoscout24/listings/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "make": "<string>",
  "model": "<string>",
  "article_type": "C",
  "countries": [],
  "zip": "<string>",
  "radius_km": 2,
  "conditions": [],
  "body_types": [],
  "fuel_types": [],
  "transmissions": [],
  "drivetrains": [],
  "price_from": 1,
  "price_to": 1,
  "registration_year_from": 1901,
  "registration_year_to": 1901,
  "mileage_from": 1,
  "mileage_to": 1,
  "power_unit": "kw",
  "power_from": 1,
  "power_to": 1,
  "seats_from": 2,
  "seats_to": 2,
  "doors_from": 2,
  "doors_to": 2,
  "equipment": [],
  "conditions_equipment": [],
  "exterior_colors": [],
  "interior_colors": [],
  "paint_types": [],
  "upholstery_types": [],
  "emission_class_from": 3,
  "online_since_days": 2,
  "previous_owners_to": 2,
  "keyword": "<string>",
  "sort": "standard",
  "descending": false
}
'

[
  {
    "id": "<string>",
    "@type": "AutoScout24Listing",
    "url": "<string>",
    "make": "<string>",
    "model": "<string>",
    "model_group": "<string>",
    "variant": "<string>",
    "model_version": "<string>",
    "price": 123,
    "mileage_km": 123,
    "first_registration": "<string>",
    "power_kw": 123,
    "power_hp": 123,
    "fuel": "<string>",
    "transmission": "<string>",
    "body_type": "<string>",
    "displacement_cc": 123,
    "offer_type": "<string>",
    "is_new": false,
    "is_damaged": false,
    "image": "<string>",
    "images": [],
    "location": {
      "@type": "AutoScout24Location",
      "country_code": "<string>",
      "zip": "<string>",
      "city": "<string>",
      "street": "<string>",
      "latitude": 123,
      "longitude": 123
    },
    "seller": {
      "@type": "AutoScout24Seller",
      "id": "<string>",
      "type": "<string>",
      "is_dealer": false,
      "company_name": "<string>",
      "contact_name": "<string>",
      "image": "<string>",
      "alias": "<string>",
      "info_url": "<string>",
      "culture": "<string>",
      "phones": []
    }
  }
]

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

count

integer

required

Max number of results to return

Required range: x >= 1

timeout

integer

default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

make

string | null

Make slug (e.g. 'bmw', 'audi', 'mercedes-benz')

Minimum string length: 1

model

string | null

Model slug (e.g. 'a4', 'x5'); requires make to be set

Minimum string length: 1

article_type

enum<string>

default:C

Vehicle article type

Available options:

C,

B,

N,

X,

L

countries

enum<string>[]

Seller countries (empty = all of Europe)

Available options:

A,

B,

D,

E,

F,

I,

L,

NL

zip

string | null

Postal code to search around

Minimum string length: 1

radius_km

integer | null

Search radius around the postal code, in km

Required range: x >= 1

conditions

enum<string>[]

Vehicle conditions (new, used, demo, ...)

Available options:

N,

U,

J,

O,

D,

S

body_types

enum<integer>[]

Body types to include

Available options:

1,

2,

3,

4,

5,

6,

7,

12,

13

fuel_types

enum<string>[]

Fuel types to include

Available options:

2,

3,

B,

C,

D,

E,

H,

L,

M,

O

transmissions

enum<string>[]

Transmission types to include

Available options:

A,

M,

S

drivetrains

enum<string>[]

Drivetrain types to include

Available options:

4,

F,

R

price_from

integer | null

Minimum price (EUR)

Required range: x >= 0

price_to

integer | null

Maximum price (EUR)

Required range: x >= 0

price_type

enum<string> | null

Whether price is private or dealer price

Available options:

private,

dealer

registration_year_from

integer | null

Minimum first registration year

Required range: x >= 1900

registration_year_to

integer | null

Maximum first registration year

Required range: x >= 1900

mileage_from

integer | null

Minimum mileage (km)

Required range: x >= 0

mileage_to

integer | null

Maximum mileage (km)

Required range: x >= 0

power_unit

enum<string>

default:kw

Unit for power_from/power_to

Available options:

hp,

kw

power_from

integer | null

Minimum engine power (in power_unit)

Required range: x >= 0

power_to

integer | null

Maximum engine power (in power_unit)

Required range: x >= 0

seller_type

enum<string> | null

Seller type (dealer or private)

Available options:

D,

P

seats_from

integer | null

Minimum number of seats

Required range: x >= 1

seats_to

integer | null

Maximum number of seats

Required range: x >= 1

doors_from

integer | null

Minimum number of doors

Required range: x >= 1

doors_to

integer | null

Maximum number of doors

Required range: x >= 1

cylinders

enum<string> | null

Number of cylinders

Available options:

3,

4,

6,

8,

10plus

equipment

enum<integer>[]

Required equipment/options

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>[]

Condition requirements (guarantee, full service history, ...)

Available options:

37,

49,

53,

110,

120

exterior_colors

enum<integer>[]

Exterior colors to include

Available options:

1,

2,

3,

4,

5,

6,

7,

10,

11,

12,

13,

14,

15,

16

interior_colors

enum<integer>[]

Interior colors to include

Available options:

1,

2,

3,

4,

5,

6,

7,

8,

9,

10,

11

paint_types

enum<string>[]

Paint types to include

Available options:

M,

O,

P,

S,

U

upholstery_types

enum<string>[]

Upholstery types to include

Available options:

AL,

CL,

FL,

OT,

PL,

VL

emission_class_from

integer | null

Minimum Euro emission class (1-6)

Required range: 1 <= x <= 6

emission_sticker_min

enum<integer> | null

Minimum environmental (emission) sticker

Available options:

1,

2,

3,

4,

5

online_since_days

integer | null

Only listings online within the last N days

Required range: x >= 1

previous_owners_to

integer | null

Maximum number of previous owners

Required range: x >= 1

keyword

string | null

Free-text keyword search in the listing

Minimum string length: 1

sort

enum<string>

default:standard

Sort order

Available options:

standard,

price,

financerate,

leasing_rate,

make,

year,

mileage,

power,

age,

distance

descending

boolean

default:false

Sort descending instead of ascending

Response

Successful Response

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

Show child attributes

seller

object

Show child attributes

/autoscout24/listings /autoscout24/makes