# AutoScout24 Car Listings Scraper — EU Used & New Cars (`yadroo/autoscout24-cars`) Actor AutoScout24 car listings for dealers, importers, pricing analysts and AI agents: 293 makes in 8 EU countries, filters for price, year, mileage, power, fuel, gearbox, body, owners, equipment, seller and postcode radius. Price rating, price per km, optional full vehicle pages. - **URL**: https://apify.com/yadroo/autoscout24-cars.md - **Developed by:** [Samat Makatov](https://apify.com/yadroo) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 result items This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## AutoScout24 Car Listings Scraper — EU Used & New Cars Structured car listings from **autoscout24.com**, Europe's largest car marketplace, across Germany, Austria, Belgium, Spain, France, Italy, Luxembourg and the Netherlands. Search by any of 293 makes and their models with every major site filter — price, first registration, mileage, power, fuel, gearbox, body, colour, emission class, previous owners, equipment, dealer or private seller, postcode radius — and get price, autoscout24's price rating, **price per 1 000 km**, specs, location and the seller with phone numbers. `detail: true` adds the description, full equipment list, drivetrain, weight, emission class, CO₂ and consumption, previous owners and coordinates. Built for car dealers and importers, leasing and remarketing, price analysts and AI agents. No proxies, no browser, no API key — reads the JSON embedded in the public pages. ### Use cases - **Import sourcing** — cheapest 2019+ automatic Golf under €20 000 in DE/AT/NL, only "top/good price" ratings, sorted by price. - **Dealer lead generation** — the **Sellers** view lists dealers with phones, ratings and dealer pages for a make/region. - **Residual value & pricing analytics** — pull 1 000+ listings of a model and regress `price` on `year`, `mileageKm`, `powerKw`; `pricePer1000Km` and `priceLabel` help spot outliers. - **Stock monitoring** — `sort: "age"` (latest offers first) scheduled hourly for a narrow search to catch new cars before competitors. - **Local market scan** — `zip` + `radiusKm` + `sort: "distance"` around your showroom. - **Spec-level research** — `detail: true` for equipment, emission class and consumption for EV/hybrid comparisons. ### Input All fields are optional. | Field | Type | Default | Allowed values / notes | |---|---|---|---| | `make` | string | – (prefill `bmw`) | Slug, name or id (`mercedes-benz`, `Volkswagen`, `Lynk & Co`, `13`). Empty = all makes. **Reference → Makes**. | | `model` | string | – | Model or series slug from the site URL (`x5`, `golf`, `3-series`, `c-class`, `id-4`). Unrecognised → run fails listing the valid slugs. | | `country` | string | `D` | `A`, `B`, `D`, `E`, `F`, `I`, `L`, `NL`, `""` = all Europe | | `countries` | string\[] | `[]` | Several countries; overrides `country`. | | `zip`, `radiusKm` | string, integer | – | Postcode search inside the selected country. | | `condition` | string | `all` | `all`, `used`, `new` | | `offerTypes` | string\[] | `[]` | `N`, `U`, `J` employee car, `O` classic, `D` demo, `S` pre-registered | | `priceFrom` / `priceTo` | integer | – | EUR | | `yearFrom` / `yearTo` | integer | – | First registration year | | `mileageFrom` / `mileageTo` | integer | – | km | | `powerFrom` / `powerTo`, `powerUnit` | integer, string | –, `kw` | `kw` or `hp` | | `fuel` | string\[] | `[]` | `B`, `D`, `E`, `2`, `3`, `L`, `C`, `H`, `M`, `O` (codes or names) | | `gear` | string\[] | `[]` | `A`, `M`, `S` | | `body` | string\[] | `[]` | `1`–`7`, `12`, `13` (codes or names) | | `sellerType` | string | `all` | `all`, `dealer`, `private` | | `bodyColors` | string\[] | `[]` | Colour ids or names | | `emissionClass` | string | `""` | Minimum Euro class | | `maxPreviousOwners` | string | `""` | `1`, `2`, `3`, `4` (4+) | | `doorsFrom`/`doorsTo`, `seatsFrom`/`seatsTo` | integer | – | | | `equipment` | string\[] | `[]` | Equipment ids or names, all required (e.g. `Navigation system`, `37` Guarantee) | | `priceLabels` | string\[] | `[]` | Client-side: `top-price`, `good-price`, `fair-price`, `increased-price`, `high-price`, `toolow-price`, `no-rating` | | `extraParams` | object | `{}` | Any other `/lst` URL parameter copied from the site | | `sort` | string | `standard` | `standard`, `price`, `age`, `mileage`, `year`, `power`, `make`, `distance` | | `sortDescending` | boolean | auto | Default ascending; `age` defaults to newest first | | `maxItems` | integer | `40` | 1–4000 (20 per page) | | `maxPages` | integer | `20` | 1–200 (autoscout24 serves at most 200 pages per search) | | `detail` | boolean | `false` | +1 request per car | | `dedupe` | boolean | `true` | | autoscout24 silently shows *all* cars when it does not understand a make or model; this actor checks what the site actually applied and fails with a clear message instead. Unknown filter values are logged as warnings. Legacy inputs (`make`, `model`, `country`, `priceFrom`, `priceTo`, `yearFrom`, `sort`, `maxItems`) keep working. ### Reference #### Countries (`country`, `countries`) | Code | Country | |---|---| | `A` | Austria (AT) | | `B` | Belgium (BE) | | `D` | Germany (DE) | | `E` | Spain (ES) | | `F` | France (FR) | | `I` | Italy (IT) | | `L` | Luxembourg (LU) | | `NL` | Netherlands (NL) | | `""` | All of Europe | #### Makes (`make`) 293 makes. Pass the slug, the name or the id.
All makes (name → slug · id) 9ff `9ff` · 51539
Abarth `abarth` · 16396
AC `ac` · 14979
ACM `acm` · 16429
Acura `acura` · 16356
Aerfal `aerfal` · 52055
Aiways `aiways` · 51872
Aixam `aixam` · 16352
Alba Mobility `alba-mobility` · 51917
Alfa Romeo `alfa-romeo` · 6
Alpina `alpina` · 14
Alpine `alpine` · 51796
Amphicar `amphicar` · 51545
Angelelli Automobili `angelelli-automobili` · 51918
ARI `ari` · 53196
Ariel Motor `ariel-motor` · 16419
Artega `artega` · 16427
Aspark `aspark` · 51948
Aspid `aspid` · 16431
Aston Martin `aston-martin` · 8
Audi `audi` · 9
Aurus `aurus` · 51929
Austin `austin` · 15643
Austin-Healey `austin-healey` · 51901
Autobianchi `autobianchi` · 15644
BAIC `baic` · 51774
BAW `baw` · 52050
Bedford `bedford` · 16400
Bellier `bellier` · 16416
Bentley `bentley` · 11
Bertone `bertone` · 52045
Bestune `bestune` · 52007
BMW `bmw` · 13
Boldmen `boldmen` · 51900
Bolloré `bollore` · 16418
Borgward `borgward` · 16424
Bovensiepen `bovensiepen` · 53448
Brilliance `brilliance` · 16367
Bristol `bristol` · 51895
Brute `brute` · 51986
Bugatti `bugatti` · 15
Buick `buick` · 16
BYD `byd` · 16379
Cadillac `cadillac` · 17
Caravans-Wohnm `caravans-wohnm` · 15672
Carver `carver` · 51912
Casalini `casalini` · 16407
Caterham `caterham` · 16335
Cenntro `cenntro` · 51936
Chamonix `chamonix` · 52064
Changan `changan` · 52058
Changhe `changhe` · 16401
Chatenet `chatenet` · 16357
Chery `chery` · 16384
Chevrolet `chevrolet` · 19
Chrysler `chrysler` · 20
Cirelli `cirelli` · 51971
Citroen `citroen` · 21
CityEL `cityel` · 16411
Corvette `corvette` · 16380
CUPRA `cupra` · 51802
Dacia `dacia` · 16360
Daewoo `daewoo` · 22
DAF `daf` · 16333
Daihatsu `daihatsu` · 23
Daimler `daimler` · 16397
Dallara `dallara` · 51947
Dangel `dangel` · 16434
De la Chapelle `de-la-chapelle` · 16423
De Tomaso `de-tomaso` · 51779
Delorean `delorean` · 51859
Denza `denza` · 52054
Devalliet `devalliet` · 53447
Devinci Cars `devinci-cars` · 51920
DFM `dfm` · 53182
DFSK `dfsk` · 51773
Dodge `dodge` · 2152
Dongfeng `dongfeng` · 52016
Donkervoort `donkervoort` · 16339
DR Automobiles `dr-automobiles` · 16383
DS Automobiles `ds-automobiles` · 16415
Dutton `dutton` · 51552
e.GO `e-go` · 51794
Ebro `ebro` · 52008
Econelo `econelo` · 51835
Edran `edran` · 51905
Elaris `elaris` · 51880
Embuggy `embuggy` · 51874
EMC `emc` · 51924
Estrima `estrima` · 16436
Evetta `evetta` · 51919
EVO `evo` · 51831
Farizon `farizon` · 52033
Ferrari `ferrari` · 27
Fiat `fiat` · 28
firefly `firefly` · 53185
Fisker `fisker` · 51543
Ford `ford` · 29
Forthing `forthing` · 51987
Foton `foton` · 51973
Gac Gonow `gac-gonow` · 51542
Galloper `galloper` · 16337
Gappy `gappy` · 51907
GAZ `gaz` · 16386
Geely `geely` · 52060
GEM `gem` · 16403
GEMBALLA `gemballa` · 51540
Genesis `genesis` · 51885
Giana `giana` · 51837
Gillet `gillet` · 51791
Giotti Victoria `giotti-victoria` · 16421
GMC `gmc` · 2153
Goupil `goupil` · 51813
Great Wall `great-wall` · 16382
Grecav `grecav` · 16409
GTA `gta` · 51926
GWM `gwm` · 51981
Haima `haima` · 51512
Hamann `hamann` · 51534
Haval `haval` · 51816
Hiphi `hiphi` · 51977
Holden `holden` · 51881
Honda `honda` · 31
Hongqi `hongqi` · 51988
HUMMER `hummer` · 15674
Hurtan `hurtan` · 51767
Hyundai `hyundai` · 33
ICH-X `ich-x` · 51992
Ineos `ineos` · 51925
Infiniti `infiniti` · 16355
Innocenti `innocenti` · 15629
Invicta `invicta` · 52006
Iso Rivolta `iso-rivolta` · 16402
Isuzu `isuzu` · 35
Iveco `iveco` · 14882
IZH `izh` · 16387
JAC `jac` · 51849
Jaecoo `jaecoo` · 51999
Jaguar `jaguar` · 37
Jeep `jeep` · 38
Jensen `jensen` · 51910
Jetour `jetour` · 53446
Karma `karma` · 51875
KGM `kgm` · 51975
Kia `kia` · 39
Koenigsegg `koenigsegg` · 51781
KTM `ktm` · 50060
Lada `lada` · 40
Lamborghini `lamborghini` · 41
Lancia `lancia` · 42
Land Rover `land-rover` · 15641
LDV `ldv` · 16426
Leapmotor `leapmotor` · 52000
Lee Group `lee-group` · 52061
LEVC `levc` · 51854
Lexus `lexus` · 43
Li `li` · 52046
Lifan `lifan` · 16393
Ligier `ligier` · 16353
Lincoln `lincoln` · 14890
Linktour `linktour` · 53439
Linzda `linzda` · 51883
Livan `livan` · 52003
Lorinser `lorinser` · 51908
Lotus `lotus` · 44
Lucid `lucid` · 51921
Lynk & Co `lynk-co` · 51914
Mahindra `mahindra` · 16359
MAN `man` · 51780
Mansory `mansory` · 16435
Martin `martin` · 51906
Martin Motors `martin-motors` · 16410
Maserati `maserati` · 45
Matra `matra` · 51955
Maxus `maxus` · 51803
Maybach `maybach` · 16348
Mazda `mazda` · 46
McLaren `mclaren` · 51519
Mega `mega` · 51902
Melex `melex` · 16399
Mercedes-Benz `mercedes-benz` · 47
Mercury `mercury` · 51834
MG `mg` · 48
MHERO `mhero` · 53441
Micro `micro` · 51965
Microcar `microcar` · 16361
Militem `militem` · 51897
Minari `minari` · 51903
Minauto `minauto` · 51766
MINI `mini` · 16338
Mitsubishi `mitsubishi` · 50
Mitsuoka `mitsuoka` · 51782
Mobilize `mobilize` · 52004
Morgan `morgan` · 51
Moskvich `moskvich` · 16388
MP Lafer `mp-lafer` · 51554
MPM Motors `mpm-motors` · 51788
NIO `nio` · 51928
Nissan `nissan` · 52
NSU `nsu` · 50111
Oldsmobile `oldsmobile` · 53
Oldtimer `oldtimer` · 15670
Omoda `omoda` · 51991
Opel `opel` · 54
Ora `ora` · 51934
Others `others` · 16328
Pagani `pagani` · 16341
Panther Westwinds `panther-westwinds` · 51553
Peugeot `peugeot` · 55
PGO `pgo` · 50083
Piaggio `piaggio` · 16350
Plymouth `plymouth` · 51770
Polestar `polestar` · 51817
Pontiac `pontiac` · 56
Porsche `porsche` · 57
Proton `proton` · 15636
Puch `puch` · 15646
RAM `ram` · 51793
Regis `regis` · 51812
Reliant `reliant` · 16398
Renault `renault` · 60
Rimac `rimac` · 53191
Rivian `rivian` · 52013
Rolls-Royce `rolls-royce` · 61
Rover `rover` · 62
Ruf `ruf` · 51536
Saab `saab` · 63
Santana `santana` · 16369
SEAT `seat` · 64
Segway `segway` · 51866
Selvo `selvo` · 51839
Seres `seres` · 51861
Sevic `sevic` · 51827
SGS `sgs` · 51913
Shelby `shelby` · 51896
Shuanghuan `shuanghuan` · 51800
Silence `silence` · 51853
Simplici `simplici` · 52039
Singer `singer` · 51909
Skoda `skoda` · 65
Skywell `skywell` · 51959
smart `smart` · 15525
SpeedArt `speedart` · 51538
Sportequipe `sportequipe` · 51949
Spyker `spyker` · 16377
SsangYong `ssangyong` · 66
Stormborn `stormborn` · 51974
StreetScooter `streetscooter` · 51795
Studebaker `studebaker` · 51833
Subaru `subaru` · 67
Suzuki `suzuki` · 68
SWM `swm` · 51749
Talbot `talbot` · 51551
Tasso `tasso` · 16404
Tata `tata` · 16327
Tazzari EV `tazzari-ev` · 51557
TECHART `techart` · 51535
Tesla `tesla` · 51520
Tiger `tiger` · 52038
Togg `togg` · 51950
Town Life `town-life` · 16420
Toyota `toyota` · 70
Trabant `trabant` · 15633
Trailer-Anhänger `trailer-anhanger` · 16326
Triumph `triumph` · 2120
Trucks-Lkw `trucks-lkw` · 16253
TVR `tvr` · 71
TYN-e `tyn-e` · 53192
UAZ `uaz` · 16389
Vanden Plas `vanden-plas` · 51836
Vanderhall `vanderhall` · 51809
VAZ `vaz` · 16385
VEM `vem` · 16422
Venucia `venucia` · 53440
VinFast `vinfast` · 51915
Volkswagen `volkswagen` · 74
Volvo `volvo` · 73
Voyah `voyah` · 51993
Wartburg `wartburg` · 16336
Weltmeister `weltmeister` · 51873
Wenckstern `wenckstern` · 51852
Westfield `westfield` · 51513
Wey `wey` · 51935
Wiesmann `wiesmann` · 16351
XBus `xbus` · 51869
XEV `xev` · 51860
Xiaomi `xiaomi` · 52031
Xpeng `xpeng` · 51940
Zastava `zastava` · 16408
ZAZ `zaz` · 16394
Zeekr `zeekr` · 51964
Zhidou `zhidou` · 51798
Zotye `zotye` · 51807
**Models** — use the slug from the site URL `/lst//`. Both single models (`x5`, `golf`, `a4`, `c-220`, `id-4`) and series / model lines (`3-series`, `c-class`, `range-rover-sport`) work. A wrong model fails the run and lists the valid slugs for that make. #### Fuel (`fuel`) | Code | Meaning | |---|---| | `2` | Electric/Gasoline | | `3` | Electric/Diesel | | `B` | Gasoline | | `C` | CNG | | `D` | Diesel | | `E` | Electric | | `H` | Hydrogen | | `L` | LPG | | `M` | Ethanol | | `O` | Others | #### Gearbox (`gear`) | Code | Meaning | |---|---| | `A` | Automatic | | `M` | Manual | | `S` | Semi-automatic | #### Body type (`body`) | Code | Meaning | |---|---| | `1` | Compact | | `2` | Convertible | | `3` | Coupe | | `4` | SUV/Off-Road/Pick-Up | | `5` | Station Wagon | | `6` | Sedan | | `7` | Other | | `12` | Van | | `13` | Transporter | #### Offer type (`offerTypes`) | Code | Meaning | |---|---| | `N` | New | | `U` | Used | | `J` | Employee's car | | `O` | Antique / Classic | | `D` | Demonstration | | `S` | Pre-registered | #### Seller (`sellerType`) | Value | autoscout24 `custtype` | |---|---| | `all` | – | | `dealer` | `D` | | `private` | `P` | #### Body colour (`bodyColors`) | Code | Meaning | |---|---| | `1` | Beige | | `2` | Blue | | `3` | Brown | | `4` | Bronze | | `5` | Yellow | | `6` | Grey | | `7` | Green | | `10` | Red | | `11` | Black | | `12` | Silver | | `13` | Violet | | `14` | White | | `15` | Orange | | `16` | Gold | #### Emission class (`emissionClass`) | Code | Meaning | |---|---| | `1` | Euro 1 | | `2` | Euro 2 | | `3` | Euro 3 | | `4` | Euro 4 | | `5` | Euro 5 | | `6` | Euro 6 | | `7` | Euro 6c | | `8` | Euro 6d | | `9` | Euro 6d-TEMP | | `10` | Euro 6e | | `11` | Euro 6b | #### Price rating (`priceLabels`, output `priceLabel`) | Value | Meaning | |---|---| | `top-price` | Top price | | `good-price` | Good price | | `fair-price` | Fair price | | `increased-price` | Increased price | | `high-price` | High price | | `toolow-price` | Suspiciously low price | | `no-rating` | No price rating | #### Sort (`sort`) | Value | Meaning | |---|---| | `price` | Price | | `financerate` | Rate | | `make` | Make/Model | | `leasing_rate` | Leasing Rate | | `year` | First registration | | `mileage` | Mileage | | `power` | Power | | `age` | Latest offers first | | `standard` | Best results | | `distance` | By distance | #### Equipment (`equipment`)
141 equipment options (id · name) `1` ABS · `2` Driver-side airbag · `3` Passenger-side airbag · `4` Sunroof · `5` Air conditioning · `6` Leather seats · `10` Radio · `11` 4WD · `12` Power steering · `13` Power windows · `15` Alloy wheels · `16` Electrically adjustable seats · `17` Central door lock · `18` Alarm system · `19` Fog lights · `20` Trailer hitch · `21` Split rear seats · `23` Navigation system · `25` Winter tyres · `26` Immobilizer · `27` Roof rack · `28` Tuned car · `29` Catalytic Converter · `30` Automatic climate control · `31` Traction control · `32` Side airbag · `34` Seat heating · `36` Disabled accessible · `37` Guarantee · `38` Cruise control · `39` Xenon headlights · `40` Park Distance Control · `41` On-board computer · `42` Electronic stability control · `43` MP3 · `44` Wind deflector · `45` Rear airbag · `46` Head airbag · `47` Central door lock with remote control · `48` Right-hand drive · `49` With full service history · `50` Panorama roof · `52` Auxiliary heating · `53` Particulate filter · `54` Tinted windows · `110` Non-smoking vehicle · `111` Cab or rented Car · `112` Sport package · `113` Start-stop system · `114` Multi-function steering wheel · `115` Daytime running lights · `116` Sport suspension · `117` Sport seats · `118` Adaptive headlights · `119` Ski bag · `120` HU/AU new · `121` Electrical side mirrors · `122` Bluetooth · `123` Heads-up display · `124` Hands-free equipment · `125` Isofix · `126` Light sensor · `127` Rain sensor · `128` Parking assist system sensors front · `129` Parking assist system sensors rear · `130` Parking assist system camera · `131` Parking assist system self-steering · `132` CD player · `133` Adaptive Cruise Control · `134` Armrest · `135` Electrically heated windshield · `136` Heated steering wheel · `137` Hill Holder · `138` Digital radio · `139` Electric tailgate · `140` LED Headlights · `141` LED Daytime Running Lights · `142` Leather steering wheel · `143` Lumbar support · `144` Air suspension · `145` Massage seats · `146` Driver drowsiness detection · `147` Night view assist · `148` Emergency brake assistant · `149` Emergency system · `150` Tire pressure monitoring system · `151` Shift paddles · `152` Sliding door · `153` Keyless central door lock · `154` Seat ventilation · `155` Sound system · `156` Voice Control · `157` Lane departure warning system · `158` Blind spot monitor · `159` Touch screen · `160` Television · `161` USB · `162` Traffic sign recognition · `170` Biodiesel conversion · `173` E10-enabled · `174` Awning · `187` 360° camera · `189` High beam assist · `190` Headlight washer system · `210` Summer tyres · `211` All season tyres · `212` Steel wheels · `213` Laser headlights · `214` Glare-free high beam headlights · `215` Spare tyre · `216` Emergency tyre · `217` Emergency tyre repair kit · `218` Smoker's package · `219` Ambient lighting · `220` WLAN / WiFi hotspot · `221` Apple CarPlay · `222` Android Auto · `223` Induction charging for smartphones · `224` Digital cockpit · `225` Automatically dimming interior mirror · `226` Cargo barrier · `227` Speed limit control system · `228` Integrated music streaming · `229` Fold flat passenger seat · `230` Bi-Xenon headlights · `231` Winter package · `232` Distance warning system · `233` Electric backseat adjustment · `237` Range extender · `238` Spoiler · `239` Full-LED headlights · `240` Electronic parking brake · `241` Automatic climate control, 2 zones · `242` Automatic climate control, 3 zones · `243` Automatic climate control, 4 zones · `244` Sliding door left · `245` Sliding door right · `248` Rear seat heating · `249` Heat Pump · `250` Bidirectional Charging · `251` Battery certificate
### Examples **Import sourcing — 2019+ automatic Golf under €20 000, good deals only, DE/AT/NL** ```json { "make": "volkswagen", "model": "golf", "countries": ["D", "A", "NL"], "yearFrom": 2019, "mileageTo": 100000, "priceTo": 20000, "gear": ["A"], "sellerType": "dealer", "priceLabels": ["top-price", "good-price"], "sort": "price", "maxItems": 200 } ``` **Stock alert — newest BMW X5 diesel listings in Germany, hourly** ```json { "make": "bmw", "model": "x5", "country": "D", "fuel": ["D"], "sort": "age", "maxItems": 40 } ``` **Local dealer leads — used cars within 50 km of Munich** ```json { "make": "", "country": "D", "zip": "80331", "radiusKm": 50, "sellerType": "dealer", "condition": "used", "sort": "distance", "maxItems": 500 } ``` **EV residual values — Tesla Model 3 across Europe with specs** ```json { "make": "tesla", "model": "model-3", "country": "", "fuel": ["E"], "detail": true, "maxItems": 300 } ``` **Family car shortlist — station wagons, 1 previous owner, full service history, Euro 6** ```json { "make": "skoda", "model": "octavia", "body": ["5"], "maxPreviousOwners": "1", "equipment": ["49"], "emissionClass": "6", "priceTo": 25000, "maxItems": 100 } ``` ### Output One dataset item per car. Example (real run, trimmed, `detail: true`): ```json { "id": "226560e1-e735-4bd6-940a-6d9e7b3376f1", "url": "https://www.autoscout24.com/offers/bmw-318-d-business-paket-pdc-navi-diesel-black-cat_ma13mo1640-226560e1-…", "title": "BMW 318 d *BUSINESS-PAKET*PDC*NAVI*", "make": "BMW", "model": "318", "modelGroup": "3 Series", "variant": "Touring", "offerType": "Used", "price": 11399, "currency": "EUR", "priceLabel": "top-price", "firstRegistration": "2019-04", "year": 2019, "mileageKm": 161668, "pricePerKm": 0.071, "pricePer1000Km": 71, "fuel": "Diesel", "transmission": "Manual", "powerKw": 110, "powerHp": 150, "engineCcm": 1995, "consumption": "4.3 l/100 km (comb.)", "co2": "114 g/km (comb.)", "countryCode": "DE", "zip": "85276", "city": "Pfaffenhofen an der Ilm", "sellerType": "dealer", "sellerId": "24363553", "sellerName": "MYAUTOCENTER OHG", "sellerPhones": ["+498441797960200", "+498441879460"], "sellerRating": 4.5, "sellerRatingsCount": 251, "imagesCount": 50, "sponsored": true, "position": 1, "searchTotal": 2721, "fetchedAt": "2026-09-13T08:24:40.607Z", "bodyType": "Station Wagon", "seats": 5, "doors": 4, "color": "Black", "upholstery": "Cloth", "cylinders": 4, "driveTrain": "Rear Wheel Drive", "weightKg": 1575, "emissionClass": "Euro 6", "co2Gkm": 114, "consumptionL100km": 4.3, "previousOwners": 2, "equipment": ["Air conditioning", "Armrest", "Automatic climate control", "Navigation system", "…"], "lat": 48.52184, "lon": 11.54022, "createdAt": "2026-05-14T00:32:46.153Z", "status": "Active" } ``` | Field | Description | |---|---| | `id`, `crossReferenceId`, `url`, `title` | Listing GUID, secondary id, listing URL, title | | `make`, `model`, `modelGroup`, `variant`, `version` | Vehicle identity | | `offerType`, `offerTypeCode` | Used / New / Demonstration / … | | `price`, `currency`, `priceFormatted` | Public price in EUR | | `priceLabel` | autoscout24 price rating (`top-price`, `good-price`, `fair-price`, `increased-price`, `high-price`, `toolow-price`) | | `firstRegistration`, `year`, `mileageKm` | `YYYY-MM`, year, km | | `pricePerKm`, `pricePer1000Km` | `price / mileageKm` (null for 0 km cars) | | `fuel`, `transmission`, `powerKw`, `powerHp`, `engineCcm`, `consumption`, `co2`, `damaged` | Specs from the card | | `countryCode`, `zip`, `city`, `street` | Location | | `sellerType`, `sellerId`, `sellerName`, `sellerPhones`, `sellerRating`, `sellerRatingsCount`, `sellerInfoUrl` | Dealer / private seller | | `image`, `imagesCount`, `sponsored`, `leadsRange` | Media, paid placement flag, autoscout24 interest bucket | | `position`, `searchTotal`, `searchUrl`, `fetchedAt` | Rank, total matching cars (market size), search URL, timestamp | | With `detail: true` | `description`, `bodyType`, `seats`, `doors`, `color`, `colorOriginal`, `paintType`, `upholstery`, `cylinders`, `gears`, `driveTrain`, `weightKg`, `emissionClass`, `co2Gkm`, `consumptionL100km`, `electricRangeKm`, `previousOwners`, `hsnTsn`, `equipment`, `equipmentByCategory`, `lat`, `lon`, `createdAt`, `status`, `warranty`, `vatDeductible`, `negotiable`, `netPrice`, `vatRate`, `sellerContactName`, `sellerRecommendPercent`, `offerReference`, `imagesCountFull` | | `detailError` | Present only when the listing page could not be opened (item still saved) | ### Use it from code / agents ```bash curl -X POST "https://api.apify.com/v2/acts/yadroo~autoscout24-cars/run-sync-get-dataset-items?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"make":"audi","model":"a4","country":"D","priceTo":20000,"yearFrom":2018,"sort":"price","maxItems":50}' ``` ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('yadroo/autoscout24-cars').call({ make: 'bmw', model: 'x5', sort: 'age', maxItems: 40 }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); ``` ```python from apify_client import ApifyClient client = ApifyClient(os.environ["APIFY_TOKEN"]) run = client.actor("yadroo/autoscout24-cars").call(run_input={"make": "tesla", "model": "model-3", "country": "", "detail": True}) items = client.dataset(run["defaultDatasetId"]).list_items().items ``` MCP: add `https://mcp.apify.com` to Claude / Cursor / any MCP client and call the `yadroo/autoscout24-cars` tool with the same JSON input. ### Pricing Pay per event: **$0.005 per run start + $0.0015 per car**. No proxy or browser costs. Typical runs: 40 cars ≈ $0.065; a 1 000-car pricing dataset ≈ $1.505; an hourly 20-car stock alert ≈ $0.035/run. `detail: true` costs the same per car but adds ~1 s per car. ### Limits & FAQ - **Depth** — autoscout24 serves 20 cars per page and at most 200 pages (4 000 cars) per search; the log tells you when a search is bigger. Split by price or year range. - **Rate limits** — ~0.8 s between search pages and ~0.9 s between listing pages; 429/5xx retried with backoff. A 403 or unknown page layout fails the run with a clear error. - **Filters not available** — autoscout24's URL does not honour drivetrain, "online since" or damaged-car parameters, so they are not offered; `priceLabels` is applied client-side. - **Countries** — the 8 autoscout24 markets listed above; the `.com` site shows the same stock as local domains. - **Freshness** — live at run time. - **Roadmap** — vans/motorbikes (`atype`), dealer inventory mode (all cars of one dealer), price-drop tracking between runs. *** Made by **Yadroo**. Sibling actors: [kolesa-kz](https://apify.com/yadroo/kolesa-kz) (cars in Kazakhstan), [krisha-kz](https://apify.com/yadroo/krisha-kz) (real estate), [kaspi-kz-products](https://apify.com/yadroo/kaspi-kz-products) (marketplace prices), [hh-kz-vacancies](https://apify.com/yadroo/hh-kz-vacancies) (jobs), [marktplaats-nl](https://apify.com/yadroo/marktplaats-nl), [kleinanzeigen-de](https://apify.com/yadroo/kleinanzeigen-de), [willhaben-at](https://apify.com/yadroo/willhaben-at). # Actor input Schema ## `make` (type: `string`): Make slug, name or autoscout24 id: "bmw", "mercedes-benz", "Volkswagen", "Lynk & Co", "13". 293 makes supported (README → Reference → Makes). Empty = all makes. ## `model` (type: `string`): Model slug as in the site URL https://www.autoscout24.com/lst//: a model ("x5", "golf", "a4", "c-220", "id-4") or a model line / series ("3-series", "c-class", "range-rover-sport"). Empty = all models. An unrecognised model fails the run with the list of valid slugs instead of silently returning every car of the make. Note: leave empty for all models of the make. ## `country` (type: `string`): Where the car is offered. Use `countries` for several. ## `countries` (type: `array`): Overrides `country` when not empty, e.g. \["D","A","NL"] for cross-border sourcing. ## `zip` (type: `string`): Search around a postcode inside the selected country (e.g. "80331" Munich). Enables sort=distance. ## `radiusKm` (type: `integer`): Radius around `zip`. The site offers 10, 20, 50, 100, 150, 200, 250, 300, 400. ## `condition` (type: `string`): autoscout24 `ustate`. ## `offerTypes` (type: `array`): Finer offer type (`offer`): N new, U used, J employee car, O classic, D demonstration, S pre-registered. Several = OR. ## `priceFrom` (type: `integer`): Minimum price in EUR. ## `priceTo` (type: `integer`): Maximum price in EUR. ## `yearFrom` (type: `integer`): autoscout24 `fregfrom`. ## `yearTo` (type: `integer`): autoscout24 `fregto`. ## `mileageFrom` (type: `integer`): autoscout24 `kmfrom`. ## `mileageTo` (type: `integer`): autoscout24 `kmto`. ## `powerFrom` (type: `integer`): Minimum engine power in `powerUnit`. ## `powerTo` (type: `integer`): Maximum engine power in `powerUnit`. ## `powerUnit` (type: `string`): Unit for powerFrom/powerTo. ## `fuel` (type: `array`): autoscout24 `fuel`: B petrol, D diesel, E electric, 2 petrol hybrid, 3 diesel hybrid, L LPG, C CNG, H hydrogen, M ethanol, O other. Several = OR. ## `gear` (type: `array`): autoscout24 `gear`: A automatic, M manual, S semi-automatic. ## `body` (type: `array`): autoscout24 `body`: 1 compact, 2 convertible, 3 coupe, 4 SUV/off-road/pick-up, 5 station wagon, 6 sedan, 12 van, 13 transporter, 7 other. ## `sellerType` (type: `string`): autoscout24 `custtype`. ## `bodyColors` (type: `array`): autoscout24 `bcol`. ## `emissionClass` (type: `string`): autoscout24 `emclass`. ## `maxPreviousOwners` (type: `string`): autoscout24 `prevownersid`. ## `doorsFrom` (type: `integer`): autoscout24 `doorfrom`. ## `doorsTo` (type: `integer`): autoscout24 `doorto`. ## `seatsFrom` (type: `integer`): autoscout24 `seatsfrom`. ## `seatsTo` (type: `integer`): autoscout24 `seatsto`. ## `equipment` (type: `array`): Equipment names or ids, e.g. "Navigation system", "Trailer hitch", "37" (Guarantee), "49" (full service history). 136 options in README → Reference. ## `priceLabels` (type: `array`): Keep only cars with these autoscout24 price ratings, e.g. \["top-price","good-price"] for deal hunting. Applied after download, so more pages may be scanned. ## `extraParams` (type: `object`): Any other autoscout24 /lst query parameter copied from a site URL, e.g. {"eq": "37,49"}. Overrides the fields above. ## `sort` (type: `string`): autoscout24 `sort`. Direction via `sortDescending`. ## `sortDescending` (type: `boolean`): Descending order (e.g. most expensive first). Default: ascending, except "age" which is newest first. ## `maxItems` (type: `integer`): Stop after this many cars. 20 per page; autoscout24 serves at most 200 pages (4 000 cars) per search. ## `maxPages` (type: `integer`): Safety cap on search pages. Raise it together with maxItems or when priceLabels filters out most cars. ## `detail` (type: `boolean`): Open each listing and add description, full equipment list, colour, body, seats/doors, cylinders, drivetrain, weight, emission class, CO₂ and consumption, previous owners, coordinates, listing creation date, VAT/negotiable flags. +1 request per car (~1 s each). ## `dedupe` (type: `boolean`): Skip listing ids already seen in this run (sponsored cars repeat across pages). ## Actor input object example ```json { "make": "bmw", "model": "x5", "country": "D", "countries": [], "condition": "all", "offerTypes": [], "powerUnit": "kw", "fuel": [], "gear": [], "body": [], "sellerType": "all", "bodyColors": [], "emissionClass": "", "maxPreviousOwners": "", "equipment": [], "priceLabels": [], "extraParams": {}, "sort": "standard", "maxItems": 40, "maxPages": 20, "detail": false, "dedupe": true } ``` # Actor output Schema ## `cars` (type: `string`): No description ## `overview` (type: `string`): No description ## `dealers` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "make": "bmw", "model": "x5", "countries": [], "offerTypes": [], "fuel": [], "gear": [], "body": [], "bodyColors": [], "equipment": [], "priceLabels": [], "extraParams": {} }; // Run the Actor and wait for it to finish const run = await client.actor("yadroo/autoscout24-cars").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "make": "bmw", "model": "x5", "countries": [], "offerTypes": [], "fuel": [], "gear": [], "body": [], "bodyColors": [], "equipment": [], "priceLabels": [], "extraParams": {}, } # Run the Actor and wait for it to finish run = client.actor("yadroo/autoscout24-cars").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "make": "bmw", "model": "x5", "countries": [], "offerTypes": [], "fuel": [], "gear": [], "body": [], "bodyColors": [], "equipment": [], "priceLabels": [], "extraParams": {} }' | apify call yadroo/autoscout24-cars --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,yadroo/autoscout24-cars" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/LiqduX7FToexRE76G/builds/ig7lCuOvnFzJRhvfz/openapi.json