Skip to content
Gridlode
Docs · Reference

AutoScout24 Car Listings

GET /v1/classifieds/autoscout242 credits / listingcache 360 min

Car listings from an AutoScout24 search (autoscout24.com, .de, .it, .fr, .nl, .be, .at or .es) by make and model, or from any AutoScout24 results URL you copy from the browser: make, model, version, price and currency, mileage, first registration, fuel, transmission, power in kW and hp, new or used, city, postal code and country, dealer name, listing URL and photos, 20 per page and up to 400 per call, with price, year, mileage, fuel, gearbox and country filters. Private sellers' names and every phone number are never collected. Collected as a signed-out visitor; bot-check pages are detected, never bypassed, and never charged. Billed per listing returned.

Query parameters

url
string
An AutoScout24 results URL copied from the browser (…/lst/…). Overrides make, model and filters.
Default: null
site
string
AutoScout24 site to search: com (international, English), de, it, fr, nl, be, at or es.
Default: "com"
Allowed: com, de, it, fr, nl, be, at, es
make
string
Make as it appears in AutoScout24 URLs, e.g. 'bmw', 'volkswagen', 'mercedes-benz'.
Default: null
model
string
Model as it appears in AutoScout24 URLs, e.g. '3-series' (.com) or '3er-(alle)' (.de).
Default: null
countries
array
Seller countries: D Germany, A Austria, B Belgium, E Spain, F France, I Italy, L Luxembourg, NL Netherlands.
Allowed: D, A, B, E, F, I, L, NL
price_from
string
Minimum price.
Default: null
price_to
string
Maximum price.
Default: null
year_from
string
Earliest first-registration year.
Default: null
year_to
string
Latest first-registration year.
Default: null
km_to
string
Maximum mileage in km.
Default: null
fuel
string
Fuel type.
Default: null
gear
string
Transmission.
Default: null
condition
string
New, used or all cars.
Default: "all"
Allowed: all, used, new
sort
string
Result order.
Default: "standard"
Allowed: standard, price_asc, price_desc, year_desc, year_asc, mileage_asc, newest
page
integer
Results page to start from (20 per page).
Default: 1
limit
integer
Maximum listings to return (1-400).
Default: 20
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/classifieds/autoscout24?make=bmw&model=3-series&limit=20" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the AutoScout24 Car Listings API page.