docs / autoscout24

AutoScout24 API

base /autoscout24/v17 endpoints

post/autoscout24/v1/search1 credit

Paginated car search by make (+ model/filters) across EU TLDs; deal signals priceEvaluation+superDeal

Parameter		Allowed / range	Description
make	optional	—	Vehicle make/brand slug (e.g. bmw, audi, volkswagen). Empty = all makes.
model	optional	—	Model slug within the make (discover via the models action).
model_group	optional	—	Model-group/line slug (broader than model).
country = de	optional	de · it · fr · nl · es · at · be · ch · pl · ro · hr · lu	AutoScout24 country edition (TLD) — each is a separate marketplace.
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.
sort	optional	price · age · mileage · power	Sort field. Common AS24 keys shown; others accepted.
desc	optional	—	Sort descending (true) instead of ascending.
price_min	optional	—	Minimum price (local currency).
price_max	optional	—	Maximum price (local currency).
year_min	optional	—	Earliest first-registration year.
year_max	optional	—	Latest first-registration year.
mileage_min	optional	—	Minimum mileage (km).
mileage_max	optional	—	Maximum mileage (km).
fuel	optional	B · D · E · 2 · 3	Fuel type (AS24 code). B=petrol, D=diesel, E=electric, 2=LPG, 3=CNG.
transmission	optional	A · M	Gearbox. A=automatic, M=manual.
body_type	optional	—	Body type (AS24 code — discover via filter_options).
zip	optional	—	Postal code center for a radius search.
radius	optional	—	Search radius (km) around zip.
power_min	optional	—	Minimum engine power (kW).
power_max	optional	—	Maximum engine power (kW).
super_deal	optional	—	Only listings flagged superDeal (priced well below market).
seller_type	optional	D · P	Seller type. D=dealer, P=private.
offer_type	optional	—	Offer type (AS24 code, e.g. U=used, N=new, J=annual car).

Try in playground →

post/autoscout24/v1/listing1 credit

Full listing detail by url/path or id (description, prices, vehicle, images, seller, leasing, warranty)

Parameter		Allowed / range	Description
url	optional	—	Full AS24 listing URL or site-relative path (from a search result's url/path).
path	optional	—	Site-relative listing path (alternative to url).
id	optional	—	AS24 listing id (alternative to url/path).
country = de	optional	de · it · fr · nl · es · at · be · ch · pl · ro · hr · lu	AutoScout24 country edition (TLD) — each is a separate marketplace.

Try in playground →

post/autoscout24/v1/makes1 credit

Vehicle makes taxonomy from search hub page

Parameter		Allowed / range	Description
country = de	optional	de · it · fr · nl · es · at · be · ch · pl · ro · hr · lu	AutoScout24 country edition (TLD) — each is a separate marketplace.

Try in playground →

post/autoscout24/v1/models1 credit

Models taxonomy for a make (query-param filters — path-segment /lst/make/model returns 404)

Parameter		Allowed / range	Description
make	required	—	Vehicle make/brand slug to list models for (e.g. bmw).
country = de	optional	de · it · fr · nl · es · at · be · ch · pl · ro · hr · lu	AutoScout24 country edition (TLD) — each is a separate marketplace.

Try in playground →

post/autoscout24/v1/filter_options1 credit

Available filter dimensions (fuel, body, transmission, etc.) from taxonomy blob

Parameter		Allowed / range	Description
make	optional	—	Optional make to scope the filter options to.
country = de	optional	de · it · fr · nl · es · at · be · ch · pl · ro · hr · lu	AutoScout24 country edition (TLD) — each is a separate marketplace.

Try in playground →

post/autoscout24/v1/seller_listings1 credit

Listings for a dealer/private seller by customer id (cid)

Parameter		Allowed / range	Description
cid	required	—	AS24 dealer/seller customer id (cid) — from a listing's seller block.
country = de	optional	de · it · fr · nl · es · at · be · ch · pl · ro · hr · lu	AutoScout24 country edition (TLD) — each is a separate marketplace.
page = 1	optional	1–	Result page (1-based). Page forward with meta.next_page.
seller_id	optional	—	Alias for cid (accepted interchangeably).

Try in playground →

post/autoscout24/v1/browse_links1 credit

SEO browse graph: cities, body types, model lines, top models (interlinking from search page)

Parameter		Allowed / range	Description
make	optional	—	Optional make to scope the browse graph to.
country = de	optional	de · it · fr · nl · es · at · be · ch · pl · ro · hr · lu	AutoScout24 country edition (TLD) — each is a separate marketplace.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/autoscout24/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"make":"bmw","country":"de"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}