{ "data": { "id": "7pM4ZAf08ybOi0aeF", "actId": "1K4YT3j4kaybWbN6D", "userId": "IYgBDiXtHOijAaUel", "startedAt": "2026-11-01T13:36:10.838Z", "finishedAt": "2026-11-01T13:36:21.648Z", "status": "SUCCEEDED", "meta": { "origin": "CLI" }, "stats": { "durationMillis": 10714, "runTimeSecs": 10.714, "computeUnits": 0.011904444444444445, "imageSizeBytes": 361797632 }, "options": { "useCache": true, "betaPackages": false, "memoryMbytes": 4096, "diskMbytes": 8192 }, "createdByOrganizationMemberUserId": "QYo53EZkJk0prePWY", "exitCode": 0, "inputSchema": "{\n \"title\": \"AutoScout24 Scraper Input\",\n \"description\": \"Search AutoScout24 across 8 HTML markets plus the Swiss API, fetch detail pages, follow search/dealer URLs, or resolve listing IDs.\",\n \"type\": \"object\",\n \"schemaVersion\": 1,\n \"properties\": {\n \"mode\": {\n \"title\": \"Mode\",\n \"type\": \"string\",\n \"description\": \"What to do: search by filters, fetch listing URLs, replay search URLs, read dealer inventory, or resolve listing IDs.\",\n \"editor\": \"select\",\n \"enum\": [\n \"searchCars\",\n \"getCarDetails\",\n \"searchByUrl\",\n \"dealerInventory\",\n \"listingIds\"\n ],\n \"enumTitles\": [\n \"Search cars by filters\",\n \"Get car details by listing URLs\",\n \"Search using AutoScout24 search URLs\",\n \"Dealer inventory\",\n \"Resolve listing IDs\"\n ],\n \"default\": \"searchCars\",\n \"prefill\": \"searchCars\"\n },\n \"make\": {\n \"title\": \"Car Make\",\n \"type\": \"string\",\n \"description\": \"Car brand/manufacturer to filter by (e.g. BMW, Mercedes-Benz, Volkswagen, Audi, Toyota).\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"Alfa Romeo\",\n \"Audi\",\n \"BMW\",\n \"Chevrolet\",\n \"Citroen\",\n \"Dacia\",\n \"Fiat\",\n \"Ford\",\n \"Honda\",\n \"Hyundai\",\n \"Jaguar\",\n \"Jeep\",\n \"Kia\",\n \"Land Rover\",\n \"Lexus\",\n \"Mazda\",\n \"Mercedes-Benz\",\n \"Mini\",\n \"Mitsubishi\",\n \"Nissan\",\n \"Opel\",\n \"Peugeot\",\n \"Porsche\",\n \"Renault\",\n \"SEAT\",\n \"Skoda\",\n \"Subaru\",\n \"Suzuki\",\n \"Tesla\",\n \"Toyota\",\n \"Volkswagen\",\n \"Volvo\"\n ],\n \"enumTitles\": [\n \"Any make\",\n \"Alfa Romeo\",\n \"Audi\",\n \"BMW\",\n \"Chevrolet\",\n \"Citroen\",\n \"Dacia\",\n \"Fiat\",\n \"Ford\",\n \"Honda\",\n \"Hyundai\",\n \"Jaguar\",\n \"Jeep\",\n \"Kia\",\n \"Land Rover\",\n \"Lexus\",\n \"Mazda\",\n \"Mercedes-Benz\",\n \"Mini\",\n \"Mitsubishi\",\n \"Nissan\",\n \"Opel\",\n \"Peugeot\",\n \"Porsche\",\n \"Renault\",\n \"SEAT\",\n \"Skoda\",\n \"Subaru\",\n \"Suzuki\",\n \"Tesla\",\n \"Toyota\",\n \"Volkswagen\",\n \"Volvo\"\n ],\n \"prefill\": \"BMW\"\n },\n \"model\": {\n \"title\": \"Car Model\",\n \"type\": \"string\",\n \"description\": \"Model name to filter (e.g. 3 Series, Golf, A4). Leave empty for all models.\",\n \"editor\": \"textfield\"\n },\n \"searchQuery\": {\n \"title\": \"Keyword\",\n \"type\": \"string\",\n \"description\": \"Free-text keyword applied to the search (e.g. panoramic, quattro).\",\n \"editor\": \"textfield\"\n },\n \"yearFrom\": {\n \"title\": \"Year From\",\n \"type\": \"integer\",\n \"description\": \"Minimum first registration year (1900-2026).\",\n \"minimum\": 1900,\n \"maximum\": 2026\n },\n \"yearTo\": {\n \"title\": \"Year To\",\n \"type\": \"integer\",\n \"description\": \"Maximum first registration year (1900-2026).\",\n \"minimum\": 1900,\n \"maximum\": 2026\n },\n \"priceFrom\": {\n \"title\": \"Price From\",\n \"type\": \"integer\",\n \"description\": \"Minimum price in the selected market's currency (EUR everywhere except Switzerland, which uses CHF).\",\n \"minimum\": 0,\n \"maximum\": 10000000\n },\n \"priceTo\": {\n \"title\": \"Price To\",\n \"type\": \"integer\",\n \"description\": \"Maximum price in the selected market's currency.\",\n \"minimum\": 0,\n \"maximum\": 10000000\n },\n \"mileageMax\": {\n \"title\": \"Max Mileage (km)\",\n \"type\": \"integer\",\n \"description\": \"Maximum mileage in kilometres.\",\n \"minimum\": 0,\n \"maximum\": 2000000\n },\n \"fuelType\": {\n \"title\": \"Fuel Type\",\n \"type\": \"string\",\n \"description\": \"Fuel type filter. 'hybrid' matches all hybrid and plug-in hybrid listings.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"petrol\",\n \"diesel\",\n \"electric\",\n \"hybrid\",\n \"plug-in-hybrid-petrol\",\n \"plug-in-hybrid-diesel\",\n \"cng\",\n \"lpg\",\n \"ethanol\",\n \"hydrogen\",\n \"other\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"Petrol\",\n \"Diesel\",\n \"Electric\",\n \"Hybrid (all)\",\n \"Plug-in hybrid petrol\",\n \"Plug-in hybrid diesel\",\n \"CNG\",\n \"LPG\",\n \"Ethanol\",\n \"Hydrogen\",\n \"Other\"\n ],\n \"default\": \"\"\n },\n \"transmission\": {\n \"title\": \"Transmission\",\n \"type\": \"string\",\n \"description\": \"Transmission type filter.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"automatic\",\n \"manual\",\n \"semi-automatic\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"Automatic\",\n \"Manual\",\n \"Semi-automatic\"\n ],\n \"default\": \"\"\n },\n \"country\": {\n \"title\": \"Country\",\n \"type\": \"string\",\n \"description\": \"Market to search. 'all' loops the 8 HTML markets plus Switzerland. '.com' is URL-only and is not part of 'all'.\",\n \"editor\": \"select\",\n \"enum\": [\n \"de\",\n \"at\",\n \"be\",\n \"fr\",\n \"it\",\n \"nl\",\n \"pl\",\n \"es\",\n \"ch\",\n \"all\"\n ],\n \"enumTitles\": [\n \"Germany\",\n \"Austria\",\n \"Belgium\",\n \"France\",\n \"Italy\",\n \"Netherlands\",\n \"Poland\",\n \"Spain\",\n \"Switzerland (API)\",\n \"All 9 markets\"\n ],\n \"default\": \"de\",\n \"prefill\": \"de\"\n },\n \"condition\": {\n \"title\": \"Condition\",\n \"type\": \"string\",\n \"description\": \"Vehicle condition. N=new, U=used, J=young used, O=oldtimer, D=demonstrator, S=other. Sent as `offer`, never `ustate`.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"N\",\n \"U\",\n \"J\",\n \"O\",\n \"D\",\n \"S\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"New\",\n \"Used\",\n \"Young used\",\n \"Oldtimer\",\n \"Demonstrator\",\n \"Other\"\n ],\n \"default\": \"\"\n },\n \"bodyType\": {\n \"title\": \"Body Type\",\n \"type\": \"string\",\n \"description\": \"Vehicle body type filter.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"1\",\n \"2\",\n \"3\",\n \"4\",\n \"5\",\n \"6\",\n \"7\",\n \"12\",\n \"13\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"Small car\",\n \"Convertible / Cabrio\",\n \"Coupe\",\n \"SUV / Off-road / Pickup\",\n \"Estate / Kombi\",\n \"Sedan / Limousine\",\n \"Other\",\n \"Van / Minibus\",\n \"Panel van / Transporter\"\n ],\n \"default\": \"\"\n },\n \"vehicleType\": {\n \"title\": \"Vehicle Category\",\n \"type\": \"string\",\n \"description\": \"Vehicle category. HTML sends `atype` (C/B/N/X) and uses `/lst-moto`, `/lst-caravan` or `/lst-transporter` for motorcycles, campers and utility vehicles; Switzerland sends the plural `vehicleCategories` field with car/motorcycle/camper/utility/truck.\",\n \"editor\": \"select\",\n \"enum\": [\n \"car\",\n \"motorcycle\",\n \"caravan\",\n \"camper\",\n \"transporter\",\n \"utility\",\n \"truck\"\n ],\n \"enumTitles\": [\n \"Cars\",\n \"Motorcycles\",\n \"Caravans\",\n \"Campers / motorhomes\",\n \"Transporters / vans\",\n \"Utility vehicles\",\n \"Trucks\"\n ],\n \"default\": \"car\"\n },\n \"drivetrain\": {\n \"title\": \"Drivetrain\",\n \"type\": \"string\",\n \"description\": \"Drivetrain filter (HTML `dtrain`, CH equivalent).\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"awd\",\n \"fwd\",\n \"rwd\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"All-wheel drive\",\n \"Front-wheel drive\",\n \"Rear-wheel drive\"\n ],\n \"default\": \"\"\n },\n \"bodyColor\": {\n \"title\": \"Exterior Colour\",\n \"type\": \"string\",\n \"description\": \"Exterior colour filter.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"black\",\n \"blue\",\n \"brown\",\n \"beige\",\n \"gold\",\n \"green\",\n \"grey\",\n \"orange\",\n \"red\",\n \"silver\",\n \"white\",\n \"yellow\",\n \"purple\",\n \"other\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"Black\",\n \"Blue\",\n \"Brown\",\n \"Beige\",\n \"Gold\",\n \"Green\",\n \"Grey\",\n \"Orange\",\n \"Red\",\n \"Silver\",\n \"White\",\n \"Yellow\",\n \"Purple\",\n \"Other\"\n ],\n \"default\": \"\"\n },\n \"interiorColor\": {\n \"title\": \"Interior Colour\",\n \"type\": \"string\",\n \"description\": \"Interior colour filter.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"black\",\n \"blue\",\n \"brown\",\n \"beige\",\n \"gold\",\n \"green\",\n \"grey\",\n \"orange\",\n \"red\",\n \"silver\",\n \"white\",\n \"yellow\",\n \"purple\",\n \"other\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"Black\",\n \"Blue\",\n \"Brown\",\n \"Beige\",\n \"Gold\",\n \"Green\",\n \"Grey\",\n \"Orange\",\n \"Red\",\n \"Silver\",\n \"White\",\n \"Yellow\",\n \"Purple\",\n \"Other\"\n ],\n \"default\": \"\"\n },\n \"upholstery\": {\n \"title\": \"Upholstery\",\n \"type\": \"string\",\n \"description\": \"Interior upholstery filter.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"alcantara\",\n \"cloth\",\n \"full-leather\",\n \"partial-leather\",\n \"vinyl\",\n \"other\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"Alcantara\",\n \"Cloth\",\n \"Full leather\",\n \"Partial leather\",\n \"Vinyl\",\n \"Other\"\n ],\n \"default\": \"\"\n },\n \"equipment\": {\n \"title\": \"Equipment IDs\",\n \"type\": \"array\",\n \"description\": \"AutoScout24 equipment taxonomy IDs passed as `eq` (HTML) or `equipmentSearchAttributes` (CH).\",\n \"editor\": \"stringList\"\n },\n \"emissionStandard\": {\n \"title\": \"Emission Standard\",\n \"type\": \"string\",\n \"description\": \"Emission standard code 1-11 (HTML `emclass`).\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"1\",\n \"2\",\n \"3\",\n \"4\",\n \"5\",\n \"6\",\n \"7\",\n \"8\",\n \"9\",\n \"10\",\n \"11\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"Euro 1\",\n \"Euro 2\",\n \"Euro 3\",\n \"Euro 4\",\n \"Euro 5\",\n \"Euro 6\",\n \"7\",\n \"8\",\n \"9\",\n \"10\",\n \"11\"\n ],\n \"default\": \"\"\n },\n \"previousOwnersMax\": {\n \"title\": \"Previous Owners (max)\",\n \"type\": \"string\",\n \"description\": \"Maximum previous owners (HTML `prevownersid`).\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"1\",\n \"2\",\n \"3\",\n \"4+\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"1\",\n \"2\",\n \"3\",\n \"4 or more\"\n ],\n \"default\": \"\"\n },\n \"listedWithinDays\": {\n \"title\": \"Listed Within (days)\",\n \"type\": \"string\",\n \"description\": \"Only listings created within this many days (HTML `adage`).\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"0\",\n \"1\",\n \"2\",\n \"3\",\n \"4\",\n \"5\",\n \"6\",\n \"7\",\n \"14\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"Today\",\n \"1 day\",\n \"2 days\",\n \"3 days\",\n \"4 days\",\n \"5 days\",\n \"6 days\",\n \"7 days\",\n \"14 days\"\n ],\n \"default\": \"\"\n },\n \"powerFrom\": {\n \"title\": \"Power From\",\n \"type\": \"integer\",\n \"description\": \"Minimum engine power in the unit set by Power Unit. HP is converted to kW before the request.\",\n \"minimum\": 0,\n \"maximum\": 2000\n },\n \"powerTo\": {\n \"title\": \"Power To\",\n \"type\": \"integer\",\n \"description\": \"Maximum engine power in the unit set by Power Unit. HP is converted to kW before the request.\",\n \"minimum\": 0,\n \"maximum\": 2000\n },\n \"powerUnit\": {\n \"title\": \"Power Unit\",\n \"type\": \"string\",\n \"description\": \"Unit for Power From / Power To. Bounds are always sent to AutoScout24 in kW.\",\n \"editor\": \"select\",\n \"enum\": [\n \"kw\",\n \"hp\"\n ],\n \"enumTitles\": [\n \"kW\",\n \"HP (PS)\"\n ],\n \"default\": \"kw\",\n \"prefill\": \"kw\"\n },\n \"doorsFrom\": {\n \"title\": \"Doors From\",\n \"type\": \"integer\",\n \"description\": \"Minimum number of doors.\",\n \"minimum\": 2,\n \"maximum\": 7\n },\n \"doorsTo\": {\n \"title\": \"Doors To\",\n \"type\": \"integer\",\n \"description\": \"Maximum number of doors.\",\n \"minimum\": 2,\n \"maximum\": 7\n },\n \"seatsFrom\": {\n \"title\": \"Seats From\",\n \"type\": \"integer\",\n \"description\": \"Minimum number of seats.\",\n \"minimum\": 1,\n \"maximum\": 12\n },\n \"seatsTo\": {\n \"title\": \"Seats To\",\n \"type\": \"integer\",\n \"description\": \"Maximum number of seats.\",\n \"minimum\": 1,\n \"maximum\": 12\n },\n \"rangeFromKm\": {\n \"title\": \"Electric Range From (km)\",\n \"type\": \"integer\",\n \"description\": \"Minimum electric range. CH applies it server-side; HTML applies it when a detail record carries a range.\",\n \"minimum\": 0,\n \"maximum\": 2000\n },\n \"engineSizeFromCc\": {\n \"title\": \"Engine Size From (cc)\",\n \"type\": \"integer\",\n \"description\": \"Minimum engine displacement in cc (HTML `ccmfrom`, CH `cubicCapacityFrom`).\",\n \"minimum\": 0,\n \"maximum\": 10000\n },\n \"engineSizeToCc\": {\n \"title\": \"Engine Size To (cc)\",\n \"type\": \"integer\",\n \"description\": \"Maximum engine displacement in cc (HTML `ccmto`, CH `cubicCapacityTo`).\",\n \"minimum\": 0,\n \"maximum\": 10000\n },\n \"vatDeductibleOnly\": {\n \"title\": \"VAT Deductible Only\",\n \"type\": \"boolean\",\n \"description\": \"Only VAT-deductible listings (HTML `vatded=true`). CH has no equivalent filter.\",\n \"default\": false,\n \"prefill\": false\n },\n \"damagedListings\": {\n \"title\": \"Damaged Listings\",\n \"type\": \"string\",\n \"description\": \"Whether to exclude, include, or return only damaged listings.\",\n \"editor\": \"select\",\n \"enum\": [\n \"exclude\",\n \"include\",\n \"only\"\n ],\n \"enumTitles\": [\n \"Exclude damaged\",\n \"Include damaged\",\n \"Damaged only\"\n ],\n \"default\": \"exclude\"\n },\n \"zipCode\": {\n \"title\": \"ZIP / Postal Code\",\n \"type\": \"string\",\n \"description\": \"Postal code for the radius filter (HTML `zip`; CH geo lookup).\",\n \"editor\": \"textfield\"\n },\n \"radiusKm\": {\n \"title\": \"Radius (km)\",\n \"type\": \"string\",\n \"description\": \"Radius around the ZIP/postal code.\",\n \"editor\": \"select\",\n \"enum\": [\n \"0\",\n \"10\",\n \"20\",\n \"50\",\n \"100\",\n \"150\",\n \"200\",\n \"250\",\n \"300\",\n \"400\"\n ],\n \"enumTitles\": [\n \"0 km\",\n \"10 km\",\n \"20 km\",\n \"50 km\",\n \"100 km\",\n \"150 km\",\n \"200 km\",\n \"250 km\",\n \"300 km\",\n \"400 km\"\n ],\n \"default\": \"50\"\n },\n \"sellerType\": {\n \"title\": \"Seller Type\",\n \"type\": \"string\",\n \"description\": \"Filter by dealer or private seller.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"dealer\",\n \"private\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"Dealer\",\n \"Private seller\"\n ],\n \"default\": \"\"\n },\n \"sortBy\": {\n \"title\": \"Sort By\",\n \"type\": \"string\",\n \"description\": \"Result ordering. `distance` requires zipCode; `power` and `make` are not exposed because they are unreliable or empty.\",\n \"editor\": \"select\",\n \"enum\": [\n \"standard\",\n \"price\",\n \"mileage\",\n \"year\",\n \"age\",\n \"distance\"\n ],\n \"enumTitles\": [\n \"Standard\",\n \"Price\",\n \"Mileage\",\n \"First registration year\",\n \"Listing age\",\n \"Distance\"\n ],\n \"default\": \"standard\"\n },\n \"sortOrder\": {\n \"title\": \"Sort Order\",\n \"type\": \"string\",\n \"description\": \"Ascending or descending.\",\n \"editor\": \"select\",\n \"enum\": [\n \"asc\",\n \"desc\"\n ],\n \"enumTitles\": [\n \"Ascending\",\n \"Descending\"\n ],\n \"default\": \"asc\"\n },\n \"startPage\": {\n \"title\": \"Start Page\",\n \"type\": \"integer\",\n \"description\": \"First result page (1-based, 200 listings per page).\",\n \"minimum\": 1,\n \"maximum\": 100000,\n \"default\": 1\n },\n \"endPage\": {\n \"title\": \"End Page\",\n \"type\": \"integer\",\n \"description\": \"Last result page (inclusive). Clamped to the server's maximum page.\",\n \"minimum\": 1,\n \"maximum\": 100000\n },\n \"listingUrls\": {\n \"title\": \"Listing URLs (mode=getCarDetails)\",\n \"type\": \"array\",\n \"description\": \"AutoScout24 detail URLs (absolute or market-relative) to fetch details for.\",\n \"editor\": \"stringList\"\n },\n \"searchUrls\": {\n \"title\": \"Search URLs (mode=searchByUrl)\",\n \"type\": \"array\",\n \"description\": \"AutoScout24 search URLs. Their filters are parsed and replayed; page/size/tracking params are dropped. A user-supplied `cy` on a `.com` URL is preserved because it selects the real country feed there; `/lst-moto` paths switch to motorcycles.\",\n \"editor\": \"requestListSources\"\n },\n \"dealerUrls\": {\n \"title\": \"Dealer URLs (mode=dealerInventory)\",\n \"type\": \"array\",\n \"description\": \"AutoScout24 dealer/stock URLs. The actor reads the dealer page and, when possible, follows its stock search.\",\n \"editor\": \"requestListSources\"\n },\n \"dealerIds\": {\n \"title\": \"Dealer IDs\",\n \"type\": \"array\",\n \"description\": \"HTML dealer customer IDs (cid) or Swiss seller IDs. Used by dealerInventory.\",\n \"editor\": \"stringList\"\n },\n \"listingIds\": {\n \"title\": \"Listing IDs (mode=listingIds)\",\n \"type\": \"array\",\n \"description\": \"UUIDs, Swiss numeric IDs, or full listing URLs.\",\n \"editor\": \"stringList\"\n },\n \"includeDetails\": {\n \"title\": \"Include Detail Enrichment\",\n \"type\": \"boolean\",\n \"description\": \"Fetch each listing's detail page (or CH detail + equipment) to fill body, colour, doors, seats, equipment, history, VAT, seller, GPS, price evaluation, view/favourite counters, mileage-history URL, Carfax (with partner-integration fallback) and created date. Failures keep the search card.\",\n \"default\": false,\n \"prefill\": false\n },\n \"includeSellerProfile\": {\n \"title\": \"Include Seller Profile\",\n \"type\": \"boolean\",\n \"description\": \"Fetch the dealer/seller profile once per seller from `dealerInfoPage` for website, email, VAT/UID, phones, address, contact name, opening hours, imprint, ratings and up to 10 reviews. No extra request is made when this option is off; failures do not drop the listing.\",\n \"default\": false,\n \"prefill\": false\n },\n \"maxItems\": {\n \"title\": \"Max Items\",\n \"type\": \"integer\",\n \"description\": \"Maximum listings to return. Values above the 4,000/query ceiling use year/price slicing; the hard maximum is 10,000. Prefill uses 3 so scheduled checks stay fast.\",\n \"minimum\": 1,\n \"maximum\": 10000,\n \"default\": 100,\n \"prefill\": 3\n }\n },\n \"required\": [\n \"mode\"\n ]\n}", "readme": "# AutoScout24 Car Search Across 9 European Markets\n\nCollect new and used car listings from **AutoScout24** across Germany, Austria, Belgium, France, Italy, the Netherlands, Poland, Spain and Switzerland. Search by make, model, price, year, mileage, fuel, transmission, body style, power, equipment, seller type and more; replay saved search or dealer URLs; resolve listing IDs; and enrich records with detail-page and dealer-profile data. No login, cookies, API key or proxy is required.\n\n## What this actor does\n\n- **Five modes:** `searchCars`, `getCarDetails`, `searchByUrl`, `dealerInventory`, `listingIds`\n- **40+ search filters:** make, model, keyword, price, year, mileage, fuel, transmission, condition, body, power, doors, seats, colour, drivetrain, equipment, emission class, previous owners, listing age, VAT, damage, ZIP radius, seller type and sort\n- **Nine markets in one actor:** Germany, Austria, Belgium, France, Italy, the Netherlands, Poland, Spain and Switzerland, or `country: \"all\"` to search every market with duplicate-free results\n- **Goes past AutoScout24's 4,000-results-per-query ceiling** by splitting broad searches across registration years and price bands, up to 10,000 listings per run\n- **Optional detail and dealer enrichment:** vehicle history, equipment, price evaluation, view/favourite counters, dealer email, VAT/UID, address, opening hours, ratings and up to 10 reviews; **Empty fields are omitted**\n\n## Output per listing\n\nOne row per unique listing. Values are read from the search card, the detail page and the dealer profile when those sources publish them. Empty values are removed at every depth, while meaningful `false` flags are kept.\n\n- **Identity and lifecycle:** `id`, `idType`, `dedupeKey`, `crossReferenceId`, `title`, `status`, `offerType`, `condition`, `isNew`, `isDeliverable`, `recordType`, `scrapedAt`\n- **Listing metadata and source:** `listingUrl`, `sourceUrl`, `description`, `createdAt`, `lastModifiedAt`, `searchPosition`, `adTier`, `marketplace`, `language`, `currency`, `source`\n- **Vehicle:** `make`, `model`, `modelGroup`, `variant`, `vehicleType`, `vin`, `bodyType`, `bodyColor`, `paintType`, `driveTrain`, `transmission`, `fuelType`, `fuelCode`, `cylinders`, `doors`, `seats`, `gears`, `mileageKm`, `displacement`, `powerKw`, `powerHp`, `upholstery`, `upholsteryColor`, `interiorColor`, `hsnTsn`\n- **Registration and efficiency:** `firstRegistration`, `firstRegistrationDate`, `year`, `fuelConsumption`, `consumptionCombined`, `co2EmissionsGkm`, `co2Emission`, `emissionStandard`, `energyLabel`, `wltpValues`, `wltp`\n- **Price:** `priceEur`, `priceAmount`, `priceCurrency`, `priceRaw`, `priceFormatted`, `priceMedian`, `priceEvaluation`, `priceEvaluationCategory`, `priceEvaluationRanges`, `netPrice`, `vatRate`, `taxDeductible`, `negotiable`, `onRequestOnly`, `listPrice`, `leasingRate`, `dealerPrice`\n- **EV, dimensions, availability and warranty:** `batteryCapacityKwh`, `electricRangeKm`, `chargingPowerKw`, `fastChargingPowerKw`, `fastChargingTime0To80Min`, `chargingTime0To100Min`, `powerConsumptionKwh100km`, `electricMotorHp`, `combustionEngineHp`, `directImport`, `warrantyAvailable`, `warranty`, `availabilityType`, `availableNow`, `dimensions`, `weightKg`, `payloadKg`, `towingCapacityKg`\n- **Location:** `location`, `city`, `countryCode`, `zip`, `street`, `region`, `latitude`, `longitude`, `coordinates`\n- **Seller and dealer:** `sellerType`, `sellerTypeRaw`, `sellerName`, `sellerContact`, `sellerId`, `sellerPhone`, `sellerPhones`, `sellerEmail`, `sellerVatId`, `sellerWebsite`, `sellerDealerUrl`, `sellerAddress`, `sellerImprint`, `sellerOpeningHours`, `sellerGooglePlace`, `sellerReviews`, `sellerReviewCount`, `sellerRatingStars`, `sellerRatingCount`\n- **Media:** `photos`, `imageCount`, `headerImage`, `has360`, `videoUrl`, `whatsapp`\n- **History, inspection and equipment:** `features`, `equipment`, `previousOwners`, `accidentFree`, `fullServiceHistory`, `nonSmoking`, `newInspection`, `lastInspectionDate`, `inspectionPassed`, `carfaxUrl`, `mileageHistoryUrl`, `vehicleReport`, `certificationNumber`\n- **Engagement and enrichment flags:** `viewCount`, `favoriteCount`, `detailEnriched`, `sellerEnriched`\n\n`priceEur` is used for every euro market, including Poland. Swiss records use `priceAmount` with `priceCurrency: \"CHF\"`. `photos` contains up to 20 absolute image URLs, while `imageCount` reports the full count before that cap.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `searchCars` | `searchCars` filters listings, `getCarDetails` fetches listing URLs, `searchByUrl` replays search URLs, `dealerInventory` reads dealer stock, `listingIds` resolves IDs or URLs. |\n| `make` | string | – | Manufacturer from a curated list of common European makes. Leave empty to search every make. |\n| `model` | string | – | Model name such as `3 Series`, `Golf` or `A4`. Leave empty for all models. |\n| `searchQuery` | string | – | Free-text keyword applied to the search, such as `panoramic` or `quattro`. |\n| `yearFrom` | integer | – | Earliest first-registration year (1900–2026). |\n| `yearTo` | integer | – | Latest first-registration year (1900–2026). |\n| `priceFrom` | integer | – | Minimum price in the market currency (0–10,000,000). |\n| `priceTo` | integer | – | Maximum price in the market currency (0–10,000,000). |\n| `mileageMax` | integer | – | Maximum mileage in kilometres (0–2,000,000). |\n| `fuelType` | string | – | Petrol, diesel, electric, hybrid, plug-in hybrid petrol/diesel, CNG, LPG, ethanol, hydrogen or other. `hybrid` covers all hybrids and plug-in hybrids. |\n| `transmission` | string | – | Automatic, manual or semi-automatic. |\n| `country` | string | `de` | `de`, `at`, `be`, `fr`, `it`, `nl`, `pl`, `es`, `ch`, or `all` for every market. Belgium follows the Dutch-language feed; Switzerland prices in CHF; the international `.com` site is available only through `searchByUrl`. |\n| `condition` | string | – | New, used, young used, oldtimer, demonstrator or other. |\n| `bodyType` | string | – | Small car, convertible/cabrio, coupe, SUV/off-road/pickup, estate/kombi, sedan/limousine, other, van/minibus or panel van/transporter. |\n| `vehicleType` | string | `car` | Cars, motorcycles, caravans, campers/motorhomes, transporters/vans, utility vehicles or trucks. Switzerland supports cars, motorcycles, campers, utility vehicles and trucks. |\n| `drivetrain` | string | – | All-wheel, front-wheel or rear-wheel drive. |\n| `bodyColor` | string | – | Exterior colour. |\n| `interiorColor` | string | – | Interior colour. |\n| `upholstery` | string | – | Alcantara, cloth, full leather, partial leather, vinyl or other. |\n| `equipment` | array | – | AutoScout24 equipment IDs to require, using the IDs shown by the site. |\n| `emissionStandard` | string | – | Emission-standard code as used by AutoScout24 (Euro 1–6 and codes 7–11). |\n| `previousOwnersMax` | string | – | Any, 1, 2, 3, or 4 or more previous owners. |\n| `listedWithinDays` | string | – | Any, today, or 1–7 or 14 days since the listing was created. |\n| `powerFrom` | integer | – | Minimum engine power in the unit selected by `powerUnit` (0–2,000). |\n| `powerTo` | integer | – | Maximum engine power in the unit selected by `powerUnit` (0–2,000). |\n| `powerUnit` | string | `kw` | `kw` or `hp` (PS). AutoScout24 applies the bounds in kW. |\n| `doorsFrom` | integer | – | Minimum number of doors (2–7). |\n| `doorsTo` | integer | – | Maximum number of doors (2–7). |\n| `seatsFrom` | integer | – | Minimum number of seats (1–12). |\n| `seatsTo` | integer | – | Maximum number of seats (1–12). |\n| `rangeFromKm` | integer | – | Minimum electric range in kilometres (0–2,000). Switzerland applies it to the whole search; other markets apply it to records that publish a range. |\n| `engineSizeFromCc` | integer | – | Minimum engine displacement in cc (0–10,000). |\n| `engineSizeToCc` | integer | – | Maximum engine displacement in cc (0–10,000). |\n| `vatDeductibleOnly` | boolean | `false` | Return only VAT-deductible listings. Applies to the eight local markets; Switzerland has no equivalent filter. |\n| `damagedListings` | string | `exclude` | `exclude`, `include` or `only`. |\n| `zipCode` | string | – | Postal code used for the radius filter and for distance sorting. |\n| `radiusKm` | string | `50` | Radius around the postal code: 0, 10, 20, 50, 100, 150, 200, 250, 300 or 400 km. |\n| `sellerType` | string | – | Any, dealer or private seller. |\n| `sortBy` | string | `standard` | Standard, price, mileage, first-registration year, listing age or distance. Distance requires `zipCode`. |\n| `sortOrder` | string | `asc` | Ascending or descending. |\n| `startPage` | integer | `1` | First result page, 1-based (1–100,000). Most markets return 200 listings per page; Switzerland returns 20. |\n| `endPage` | integer | – | Last result page, inclusive (1–100,000). Clamped to the last page the market allows. |\n| `listingUrls` | array | – | Listing URLs, absolute or market-relative, for `getCarDetails`. |\n| `searchUrls` | array of URLs | – | AutoScout24 search URLs for `searchByUrl`. Filters in the URL are replayed; page, size and tracking parameters are ignored. A country parameter on a `.com` URL is kept. |\n| `dealerUrls` | array of URLs | – | Dealer or dealer-stock pages for `dealerInventory`. |\n| `dealerIds` | array | – | Dealer customer IDs or Swiss seller IDs for `dealerInventory`. |\n| `listingIds` | array | – | Listing UUIDs, Swiss numeric IDs or full listing URLs for `listingIds`. |\n| `includeDetails` | boolean | `false` | Fetch each listing's detail page for extra vehicle, equipment, history, price-evaluation and engagement fields. Failures keep the search record. |\n| `includeSellerProfile` | boolean | `false` | Fetch the dealer profile once per seller for contact details, VAT/UID, address, opening hours, ratings and up to 10 reviews. Failures keep the listing. |\n| `maxItems` | integer | `100` | Maximum listings to return (1–10,000). Searches above 4,000 results are split automatically. |\n\n### Example: German diesel SUV search\n\n```json\n{\n \"mode\": \"searchCars\",\n \"make\": \"BMW\",\n \"fuelType\": \"diesel\",\n \"bodyType\": \"4\",\n \"powerFrom\": 100,\n \"powerTo\": 250,\n \"powerUnit\": \"kw\",\n \"sellerType\": \"dealer\",\n \"yearFrom\": 2015,\n \"yearTo\": 2022,\n \"priceFrom\": 10000,\n \"priceTo\": 40000,\n \"country\": \"de\",\n \"maxItems\": 50\n}\n```\n\n### Example: Swiss EV search with detail enrichment\n\n```json\n{\n \"mode\": \"searchCars\",\n \"country\": \"ch\",\n \"fuelType\": \"electric\",\n \"rangeFromKm\": 400,\n \"sortBy\": \"price\",\n \"sortOrder\": \"asc\",\n \"maxItems\": 20,\n \"includeDetails\": true\n}\n```\n\n### Example: detail enrichment in search mode\n\n```json\n{\n \"mode\": \"searchCars\",\n \"make\": \"Audi\",\n \"country\": \"de\",\n \"maxItems\": 20,\n \"includeDetails\": true,\n \"includeSellerProfile\": true\n}\n```\n\n### Example: replay a search URL\n\n```json\n{\n \"mode\": \"searchByUrl\",\n \"searchUrls\": [\"https://www.autoscout24.de/lst/bmw/320?fregfrom=2020&pricefrom=10000&sort=price&desc=0\"],\n \"maxItems\": 100\n}\n```\n\n## Use cases\n\n- **Dealerships and marketplaces** — monitor competing stock, asking prices and listing age across nearby markets\n- **Vehicle valuation and residual-value models** — build comparable sets by make, model, year, mileage, equipment and condition\n- **EV and fleet research** — compare electric range, battery capacity, charging power and consumption across nine markets\n- **Procurement and sourcing** — find dealer stock by region, VAT status, seller type and damage status\n- **Automotive data platforms** — enrich catalogues with dealer contacts, VAT/UID, geodata, photos and vehicle history\n- **Academic and market research** — study used-car supply, pricing and specification trends across Europe\n\n## FAQ\n\n### Which AutoScout24 markets are supported?\n\nGermany, Austria, Belgium, France, Italy, the Netherlands, Poland, Spain and Switzerland. Use `country: \"all\"` to search every market with duplicates removed. Prices are in EUR everywhere except Switzerland, which uses CHF. Belgium follows AutoScout24's Dutch-language feed.\n\n### What happens when a search has more than 4,000 results?\n\nAutoScout24 exposes at most 4,000 listings per search (20 pages at 200 listings each). The actor splits a broader search by first-registration year and then by price band, removes duplicates, and continues until `maxItems` is reached, up to 10,000 listings. Listings with an unknown or \"price on request\" value cannot be bucketed and are fetched separately.\n\n### Why are some fields missing from a record?\n\nAutoScout24 does not publish every attribute for every listing. Empty fields are omitted instead of being sent as `null`. VIN is rarely exposed, previous-owner counts appear for only part of the inventory, and battery-health or charging-plug fields are not published. Detail and dealer enrichment improve fill rates but cannot create data the source does not have.\n\n### Do I need a login, cookie, API key or proxy?\n\nNo. The actor reads publicly available AutoScout24 listings anonymously. Set the input and run it.\n\n### Are Swiss prices converted to EUR?\n\nNo. Swiss records use `priceAmount` with `priceCurrency: \"CHF\"`. Euro-market records, including Poland, use `priceEur`. No CHF value is labelled as EUR.\n\n### What does the seller profile add?\n\nWhen the dealer publishes them: website, email, VAT/UID, phone numbers, postal address, contact name, opening hours, imprint, rating stars and count, and up to 10 recent reviews. It is off by default and only adds data when available.\n\n### Can I search only damaged cars or only VAT-deductible cars?\n\nYes. Set `damagedListings` to `exclude`, `include` or `only`. Set `vatDeductibleOnly` to `true` for VAT-deductible listings in the eight local markets; Switzerland has no equivalent filter and skips it.\n\n### Why does distance sorting require a ZIP code?\n\nAutoScout24 needs an origin point to calculate distance. Provide `zipCode` (and optionally `radiusKm`) when using `sortBy: \"distance\"`; otherwise choose another sort.\n\n### How current is the data?\n\nEvery run reads live listings. Runs are stateless and there is no incremental or \"new listings only\" mode, so result ordering can shift slightly between runs. Use `listingIds` or listing URLs when you need an exact record.\n\n### Is this actor affiliated with AutoScout24?\n\nNo. This is an independent third-party actor that collects publicly available AutoScout24 listings.\n", "actorDefinition": { "actorSpecification": 1, "name": "autoscout24-car-search-across-9-european-markets", "title": "AutoScout24 Car Search Across 9 European Markets", "description": "Search AutoScout24 car listings across eight HTML markets plus the Swiss API by make, price, mileage, fuel type and body type, fetch full detail records for listing URLs, replay search/dealer URLs, or resolve listing IDs.", "version": "1.0", "buildTag": "latest", "dockerfile": "./Dockerfile", "readme": "# AutoScout24 Car Search Across 9 European Markets\n\nCollect new and used car listings from **AutoScout24** across Germany, Austria, Belgium, France, Italy, the Netherlands, Poland, Spain and Switzerland. Search by make, model, price, year, mileage, fuel, transmission, body style, power, equipment, seller type and more; replay saved search or dealer URLs; resolve listing IDs; and enrich records with detail-page and dealer-profile data. No login, cookies, API key or proxy is required.\n\n## What this actor does\n\n- **Five modes:** `searchCars`, `getCarDetails`, `searchByUrl`, `dealerInventory`, `listingIds`\n- **40+ search filters:** make, model, keyword, price, year, mileage, fuel, transmission, condition, body, power, doors, seats, colour, drivetrain, equipment, emission class, previous owners, listing age, VAT, damage, ZIP radius, seller type and sort\n- **Nine markets in one actor:** Germany, Austria, Belgium, France, Italy, the Netherlands, Poland, Spain and Switzerland, or `country: \"all\"` to search every market with duplicate-free results\n- **Goes past AutoScout24's 4,000-results-per-query ceiling** by splitting broad searches across registration years and price bands, up to 10,000 listings per run\n- **Optional detail and dealer enrichment:** vehicle history, equipment, price evaluation, view/favourite counters, dealer email, VAT/UID, address, opening hours, ratings and up to 10 reviews; **Empty fields are omitted**\n\n## Output per listing\n\nOne row per unique listing. Values are read from the search card, the detail page and the dealer profile when those sources publish them. Empty values are removed at every depth, while meaningful `false` flags are kept.\n\n- **Identity and lifecycle:** `id`, `idType`, `dedupeKey`, `crossReferenceId`, `title`, `status`, `offerType`, `condition`, `isNew`, `isDeliverable`, `recordType`, `scrapedAt`\n- **Listing metadata and source:** `listingUrl`, `sourceUrl`, `description`, `createdAt`, `lastModifiedAt`, `searchPosition`, `adTier`, `marketplace`, `language`, `currency`, `source`\n- **Vehicle:** `make`, `model`, `modelGroup`, `variant`, `vehicleType`, `vin`, `bodyType`, `bodyColor`, `paintType`, `driveTrain`, `transmission`, `fuelType`, `fuelCode`, `cylinders`, `doors`, `seats`, `gears`, `mileageKm`, `displacement`, `powerKw`, `powerHp`, `upholstery`, `upholsteryColor`, `interiorColor`, `hsnTsn`\n- **Registration and efficiency:** `firstRegistration`, `firstRegistrationDate`, `year`, `fuelConsumption`, `consumptionCombined`, `co2EmissionsGkm`, `co2Emission`, `emissionStandard`, `energyLabel`, `wltpValues`, `wltp`\n- **Price:** `priceEur`, `priceAmount`, `priceCurrency`, `priceRaw`, `priceFormatted`, `priceMedian`, `priceEvaluation`, `priceEvaluationCategory`, `priceEvaluationRanges`, `netPrice`, `vatRate`, `taxDeductible`, `negotiable`, `onRequestOnly`, `listPrice`, `leasingRate`, `dealerPrice`\n- **EV, dimensions, availability and warranty:** `batteryCapacityKwh`, `electricRangeKm`, `chargingPowerKw`, `fastChargingPowerKw`, `fastChargingTime0To80Min`, `chargingTime0To100Min`, `powerConsumptionKwh100km`, `electricMotorHp`, `combustionEngineHp`, `directImport`, `warrantyAvailable`, `warranty`, `availabilityType`, `availableNow`, `dimensions`, `weightKg`, `payloadKg`, `towingCapacityKg`\n- **Location:** `location`, `city`, `countryCode`, `zip`, `street`, `region`, `latitude`, `longitude`, `coordinates`\n- **Seller and dealer:** `sellerType`, `sellerTypeRaw`, `sellerName`, `sellerContact`, `sellerId`, `sellerPhone`, `sellerPhones`, `sellerEmail`, `sellerVatId`, `sellerWebsite`, `sellerDealerUrl`, `sellerAddress`, `sellerImprint`, `sellerOpeningHours`, `sellerGooglePlace`, `sellerReviews`, `sellerReviewCount`, `sellerRatingStars`, `sellerRatingCount`\n- **Media:** `photos`, `imageCount`, `headerImage`, `has360`, `videoUrl`, `whatsapp`\n- **History, inspection and equipment:** `features`, `equipment`, `previousOwners`, `accidentFree`, `fullServiceHistory`, `nonSmoking`, `newInspection`, `lastInspectionDate`, `inspectionPassed`, `carfaxUrl`, `mileageHistoryUrl`, `vehicleReport`, `certificationNumber`\n- **Engagement and enrichment flags:** `viewCount`, `favoriteCount`, `detailEnriched`, `sellerEnriched`\n\n`priceEur` is used for every euro market, including Poland. Swiss records use `priceAmount` with `priceCurrency: \"CHF\"`. `photos` contains up to 20 absolute image URLs, while `imageCount` reports the full count before that cap.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `searchCars` | `searchCars` filters listings, `getCarDetails` fetches listing URLs, `searchByUrl` replays search URLs, `dealerInventory` reads dealer stock, `listingIds` resolves IDs or URLs. |\n| `make` | string | – | Manufacturer from a curated list of common European makes. Leave empty to search every make. |\n| `model` | string | – | Model name such as `3 Series`, `Golf` or `A4`. Leave empty for all models. |\n| `searchQuery` | string | – | Free-text keyword applied to the search, such as `panoramic` or `quattro`. |\n| `yearFrom` | integer | – | Earliest first-registration year (1900–2026). |\n| `yearTo` | integer | – | Latest first-registration year (1900–2026). |\n| `priceFrom` | integer | – | Minimum price in the market currency (0–10,000,000). |\n| `priceTo` | integer | – | Maximum price in the market currency (0–10,000,000). |\n| `mileageMax` | integer | – | Maximum mileage in kilometres (0–2,000,000). |\n| `fuelType` | string | – | Petrol, diesel, electric, hybrid, plug-in hybrid petrol/diesel, CNG, LPG, ethanol, hydrogen or other. `hybrid` covers all hybrids and plug-in hybrids. |\n| `transmission` | string | – | Automatic, manual or semi-automatic. |\n| `country` | string | `de` | `de`, `at`, `be`, `fr`, `it`, `nl`, `pl`, `es`, `ch`, or `all` for every market. Belgium follows the Dutch-language feed; Switzerland prices in CHF; the international `.com` site is available only through `searchByUrl`. |\n| `condition` | string | – | New, used, young used, oldtimer, demonstrator or other. |\n| `bodyType` | string | – | Small car, convertible/cabrio, coupe, SUV/off-road/pickup, estate/kombi, sedan/limousine, other, van/minibus or panel van/transporter. |\n| `vehicleType` | string | `car` | Cars, motorcycles, caravans, campers/motorhomes, transporters/vans, utility vehicles or trucks. Switzerland supports cars, motorcycles, campers, utility vehicles and trucks. |\n| `drivetrain` | string | – | All-wheel, front-wheel or rear-wheel drive. |\n| `bodyColor` | string | – | Exterior colour. |\n| `interiorColor` | string | – | Interior colour. |\n| `upholstery` | string | – | Alcantara, cloth, full leather, partial leather, vinyl or other. |\n| `equipment` | array | – | AutoScout24 equipment IDs to require, using the IDs shown by the site. |\n| `emissionStandard` | string | – | Emission-standard code as used by AutoScout24 (Euro 1–6 and codes 7–11). |\n| `previousOwnersMax` | string | – | Any, 1, 2, 3, or 4 or more previous owners. |\n| `listedWithinDays` | string | – | Any, today, or 1–7 or 14 days since the listing was created. |\n| `powerFrom` | integer | – | Minimum engine power in the unit selected by `powerUnit` (0–2,000). |\n| `powerTo` | integer | – | Maximum engine power in the unit selected by `powerUnit` (0–2,000). |\n| `powerUnit` | string | `kw` | `kw` or `hp` (PS). AutoScout24 applies the bounds in kW. |\n| `doorsFrom` | integer | – | Minimum number of doors (2–7). |\n| `doorsTo` | integer | – | Maximum number of doors (2–7). |\n| `seatsFrom` | integer | – | Minimum number of seats (1–12). |\n| `seatsTo` | integer | – | Maximum number of seats (1–12). |\n| `rangeFromKm` | integer | – | Minimum electric range in kilometres (0–2,000). Switzerland applies it to the whole search; other markets apply it to records that publish a range. |\n| `engineSizeFromCc` | integer | – | Minimum engine displacement in cc (0–10,000). |\n| `engineSizeToCc` | integer | – | Maximum engine displacement in cc (0–10,000). |\n| `vatDeductibleOnly` | boolean | `false` | Return only VAT-deductible listings. Applies to the eight local markets; Switzerland has no equivalent filter. |\n| `damagedListings` | string | `exclude` | `exclude`, `include` or `only`. |\n| `zipCode` | string | – | Postal code used for the radius filter and for distance sorting. |\n| `radiusKm` | string | `50` | Radius around the postal code: 0, 10, 20, 50, 100, 150, 200, 250, 300 or 400 km. |\n| `sellerType` | string | – | Any, dealer or private seller. |\n| `sortBy` | string | `standard` | Standard, price, mileage, first-registration year, listing age or distance. Distance requires `zipCode`. |\n| `sortOrder` | string | `asc` | Ascending or descending. |\n| `startPage` | integer | `1` | First result page, 1-based (1–100,000). Most markets return 200 listings per page; Switzerland returns 20. |\n| `endPage` | integer | – | Last result page, inclusive (1–100,000). Clamped to the last page the market allows. |\n| `listingUrls` | array | – | Listing URLs, absolute or market-relative, for `getCarDetails`. |\n| `searchUrls` | array of URLs | – | AutoScout24 search URLs for `searchByUrl`. Filters in the URL are replayed; page, size and tracking parameters are ignored. A country parameter on a `.com` URL is kept. |\n| `dealerUrls` | array of URLs | – | Dealer or dealer-stock pages for `dealerInventory`. |\n| `dealerIds` | array | – | Dealer customer IDs or Swiss seller IDs for `dealerInventory`. |\n| `listingIds` | array | – | Listing UUIDs, Swiss numeric IDs or full listing URLs for `listingIds`. |\n| `includeDetails` | boolean | `false` | Fetch each listing's detail page for extra vehicle, equipment, history, price-evaluation and engagement fields. Failures keep the search record. |\n| `includeSellerProfile` | boolean | `false` | Fetch the dealer profile once per seller for contact details, VAT/UID, address, opening hours, ratings and up to 10 reviews. Failures keep the listing. |\n| `maxItems` | integer | `100` | Maximum listings to return (1–10,000). Searches above 4,000 results are split automatically. |\n\n### Example: German diesel SUV search\n\n```json\n{\n \"mode\": \"searchCars\",\n \"make\": \"BMW\",\n \"fuelType\": \"diesel\",\n \"bodyType\": \"4\",\n \"powerFrom\": 100,\n \"powerTo\": 250,\n \"powerUnit\": \"kw\",\n \"sellerType\": \"dealer\",\n \"yearFrom\": 2015,\n \"yearTo\": 2022,\n \"priceFrom\": 10000,\n \"priceTo\": 40000,\n \"country\": \"de\",\n \"maxItems\": 50\n}\n```\n\n### Example: Swiss EV search with detail enrichment\n\n```json\n{\n \"mode\": \"searchCars\",\n \"country\": \"ch\",\n \"fuelType\": \"electric\",\n \"rangeFromKm\": 400,\n \"sortBy\": \"price\",\n \"sortOrder\": \"asc\",\n \"maxItems\": 20,\n \"includeDetails\": true\n}\n```\n\n### Example: detail enrichment in search mode\n\n```json\n{\n \"mode\": \"searchCars\",\n \"make\": \"Audi\",\n \"country\": \"de\",\n \"maxItems\": 20,\n \"includeDetails\": true,\n \"includeSellerProfile\": true\n}\n```\n\n### Example: replay a search URL\n\n```json\n{\n \"mode\": \"searchByUrl\",\n \"searchUrls\": [\"https://www.autoscout24.de/lst/bmw/320?fregfrom=2020&pricefrom=10000&sort=price&desc=0\"],\n \"maxItems\": 100\n}\n```\n\n## Use cases\n\n- **Dealerships and marketplaces** — monitor competing stock, asking prices and listing age across nearby markets\n- **Vehicle valuation and residual-value models** — build comparable sets by make, model, year, mileage, equipment and condition\n- **EV and fleet research** — compare electric range, battery capacity, charging power and consumption across nine markets\n- **Procurement and sourcing** — find dealer stock by region, VAT status, seller type and damage status\n- **Automotive data platforms** — enrich catalogues with dealer contacts, VAT/UID, geodata, photos and vehicle history\n- **Academic and market research** — study used-car supply, pricing and specification trends across Europe\n\n## FAQ\n\n### Which AutoScout24 markets are supported?\n\nGermany, Austria, Belgium, France, Italy, the Netherlands, Poland, Spain and Switzerland. Use `country: \"all\"` to search every market with duplicates removed. Prices are in EUR everywhere except Switzerland, which uses CHF. Belgium follows AutoScout24's Dutch-language feed.\n\n### What happens when a search has more than 4,000 results?\n\nAutoScout24 exposes at most 4,000 listings per search (20 pages at 200 listings each). The actor splits a broader search by first-registration year and then by price band, removes duplicates, and continues until `maxItems` is reached, up to 10,000 listings. Listings with an unknown or \"price on request\" value cannot be bucketed and are fetched separately.\n\n### Why are some fields missing from a record?\n\nAutoScout24 does not publish every attribute for every listing. Empty fields are omitted instead of being sent as `null`. VIN is rarely exposed, previous-owner counts appear for only part of the inventory, and battery-health or charging-plug fields are not published. Detail and dealer enrichment improve fill rates but cannot create data the source does not have.\n\n### Do I need a login, cookie, API key or proxy?\n\nNo. The actor reads publicly available AutoScout24 listings anonymously. Set the input and run it.\n\n### Are Swiss prices converted to EUR?\n\nNo. Swiss records use `priceAmount` with `priceCurrency: \"CHF\"`. Euro-market records, including Poland, use `priceEur`. No CHF value is labelled as EUR.\n\n### What does the seller profile add?\n\nWhen the dealer publishes them: website, email, VAT/UID, phone numbers, postal address, contact name, opening hours, imprint, rating stars and count, and up to 10 recent reviews. It is off by default and only adds data when available.\n\n### Can I search only damaged cars or only VAT-deductible cars?\n\nYes. Set `damagedListings` to `exclude`, `include` or `only`. Set `vatDeductibleOnly` to `true` for VAT-deductible listings in the eight local markets; Switzerland has no equivalent filter and skips it.\n\n### Why does distance sorting require a ZIP code?\n\nAutoScout24 needs an origin point to calculate distance. Provide `zipCode` (and optionally `radiusKm`) when using `sortBy: \"distance\"`; otherwise choose another sort.\n\n### How current is the data?\n\nEvery run reads live listings. Runs are stateless and there is no incremental or \"new listings only\" mode, so result ordering can shift slightly between runs. Use `listingIds` or listing URLs when you need an exact record.\n\n### Is this actor affiliated with AutoScout24?\n\nNo. This is an independent third-party actor that collects publicly available AutoScout24 listings.\n", "input": { "title": "AutoScout24 Scraper Input", "description": "Search AutoScout24 across 8 HTML markets plus the Swiss API, fetch detail pages, follow search/dealer URLs, or resolve listing IDs.", "type": "object", "schemaVersion": 1, "properties": { "mode": { "title": "Mode", "type": "string", "description": "What to do: search by filters, fetch listing URLs, replay search URLs, read dealer inventory, or resolve listing IDs.", "editor": "select", "enum": [ "searchCars", "getCarDetails", "searchByUrl", "dealerInventory", "listingIds" ], "enumTitles": [ "Search cars by filters", "Get car details by listing URLs", "Search using AutoScout24 search URLs", "Dealer inventory", "Resolve listing IDs" ], "default": "searchCars", "prefill": "searchCars" }, "make": { "title": "Car Make", "type": "string", "description": "Car brand/manufacturer to filter by (e.g. BMW, Mercedes-Benz, Volkswagen, Audi, Toyota).", "editor": "select", "enum": [ "", "Alfa Romeo", "Audi", "BMW", "Chevrolet", "Citroen", "Dacia", "Fiat", "Ford", "Honda", "Hyundai", "Jaguar", "Jeep", "Kia", "Land Rover", "Lexus", "Mazda", "Mercedes-Benz", "Mini", "Mitsubishi", "Nissan", "Opel", "Peugeot", "Porsche", "Renault", "SEAT", "Skoda", "Subaru", "Suzuki", "Tesla", "Toyota", "Volkswagen", "Volvo" ], "enumTitles": [ "Any make", "Alfa Romeo", "Audi", "BMW", "Chevrolet", "Citroen", "Dacia", "Fiat", "Ford", "Honda", "Hyundai", "Jaguar", "Jeep", "Kia", "Land Rover", "Lexus", "Mazda", "Mercedes-Benz", "Mini", "Mitsubishi", "Nissan", "Opel", "Peugeot", "Porsche", "Renault", "SEAT", "Skoda", "Subaru", "Suzuki", "Tesla", "Toyota", "Volkswagen", "Volvo" ], "prefill": "BMW" }, "model": { "title": "Car Model", "type": "string", "description": "Model name to filter (e.g. 3 Series, Golf, A4). Leave empty for all models.", "editor": "textfield" }, "searchQuery": { "title": "Keyword", "type": "string", "description": "Free-text keyword applied to the search (e.g. panoramic, quattro).", "editor": "textfield" }, "yearFrom": { "title": "Year From", "type": "integer", "description": "Minimum first registration year (1900-2026).", "minimum": 1900, "maximum": 2026 }, "yearTo": { "title": "Year To", "type": "integer", "description": "Maximum first registration year (1900-2026).", "minimum": 1900, "maximum": 2026 }, "priceFrom": { "title": "Price From", "type": "integer", "description": "Minimum price in the selected market's currency (EUR everywhere except Switzerland, which uses CHF).", "minimum": 0, "maximum": 10000000 }, "priceTo": { "title": "Price To", "type": "integer", "description": "Maximum price in the selected market's currency.", "minimum": 0, "maximum": 10000000 }, "mileageMax": { "title": "Max Mileage (km)", "type": "integer", "description": "Maximum mileage in kilometres.", "minimum": 0, "maximum": 2000000 }, "fuelType": { "title": "Fuel Type", "type": "string", "description": "Fuel type filter. 'hybrid' matches all hybrid and plug-in hybrid listings.", "editor": "select", "enum": [ "", "petrol", "diesel", "electric", "hybrid", "plug-in-hybrid-petrol", "plug-in-hybrid-diesel", "cng", "lpg", "ethanol", "hydrogen", "other" ], "enumTitles": [ "Any", "Petrol", "Diesel", "Electric", "Hybrid (all)", "Plug-in hybrid petrol", "Plug-in hybrid diesel", "CNG", "LPG", "Ethanol", "Hydrogen", "Other" ], "default": "" }, "transmission": { "title": "Transmission", "type": "string", "description": "Transmission type filter.", "editor": "select", "enum": [ "", "automatic", "manual", "semi-automatic" ], "enumTitles": [ "Any", "Automatic", "Manual", "Semi-automatic" ], "default": "" }, "country": { "title": "Country", "type": "string", "description": "Market to search. 'all' loops the 8 HTML markets plus Switzerland. '.com' is URL-only and is not part of 'all'.", "editor": "select", "enum": [ "de", "at", "be", "fr", "it", "nl", "pl", "es", "ch", "all" ], "enumTitles": [ "Germany", "Austria", "Belgium", "France", "Italy", "Netherlands", "Poland", "Spain", "Switzerland (API)", "All 9 markets" ], "default": "de", "prefill": "de" }, "condition": { "title": "Condition", "type": "string", "description": "Vehicle condition. N=new, U=used, J=young used, O=oldtimer, D=demonstrator, S=other. Sent as `offer`, never `ustate`.", "editor": "select", "enum": [ "", "N", "U", "J", "O", "D", "S" ], "enumTitles": [ "Any", "New", "Used", "Young used", "Oldtimer", "Demonstrator", "Other" ], "default": "" }, "bodyType": { "title": "Body Type", "type": "string", "description": "Vehicle body type filter.", "editor": "select", "enum": [ "", "1", "2", "3", "4", "5", "6", "7", "12", "13" ], "enumTitles": [ "Any", "Small car", "Convertible / Cabrio", "Coupe", "SUV / Off-road / Pickup", "Estate / Kombi", "Sedan / Limousine", "Other", "Van / Minibus", "Panel van / Transporter" ], "default": "" }, "vehicleType": { "title": "Vehicle Category", "type": "string", "description": "Vehicle category. HTML sends `atype` (C/B/N/X) and uses `/lst-moto`, `/lst-caravan` or `/lst-transporter` for motorcycles, campers and utility vehicles; Switzerland sends the plural `vehicleCategories` field with car/motorcycle/camper/utility/truck.", "editor": "select", "enum": [ "car", "motorcycle", "caravan", "camper", "transporter", "utility", "truck" ], "enumTitles": [ "Cars", "Motorcycles", "Caravans", "Campers / motorhomes", "Transporters / vans", "Utility vehicles", "Trucks" ], "default": "car" }, "drivetrain": { "title": "Drivetrain", "type": "string", "description": "Drivetrain filter (HTML `dtrain`, CH equivalent).", "editor": "select", "enum": [ "", "awd", "fwd", "rwd" ], "enumTitles": [ "Any", "All-wheel drive", "Front-wheel drive", "Rear-wheel drive" ], "default": "" }, "bodyColor": { "title": "Exterior Colour", "type": "string", "description": "Exterior colour filter.", "editor": "select", "enum": [ "", "black", "blue", "brown", "beige", "gold", "green", "grey", "orange", "red", "silver", "white", "yellow", "purple", "other" ], "enumTitles": [ "Any", "Black", "Blue", "Brown", "Beige", "Gold", "Green", "Grey", "Orange", "Red", "Silver", "White", "Yellow", "Purple", "Other" ], "default": "" }, "interiorColor": { "title": "Interior Colour", "type": "string", "description": "Interior colour filter.", "editor": "select", "enum": [ "", "black", "blue", "brown", "beige", "gold", "green", "grey", "orange", "red", "silver", "white", "yellow", "purple", "other" ], "enumTitles": [ "Any", "Black", "Blue", "Brown", "Beige", "Gold", "Green", "Grey", "Orange", "Red", "Silver", "White", "Yellow", "Purple", "Other" ], "default": "" }, "upholstery": { "title": "Upholstery", "type": "string", "description": "Interior upholstery filter.", "editor": "select", "enum": [ "", "alcantara", "cloth", "full-leather", "partial-leather", "vinyl", "other" ], "enumTitles": [ "Any", "Alcantara", "Cloth", "Full leather", "Partial leather", "Vinyl", "Other" ], "default": "" }, "equipment": { "title": "Equipment IDs", "type": "array", "description": "AutoScout24 equipment taxonomy IDs passed as `eq` (HTML) or `equipmentSearchAttributes` (CH).", "editor": "stringList" }, "emissionStandard": { "title": "Emission Standard", "type": "string", "description": "Emission standard code 1-11 (HTML `emclass`).", "editor": "select", "enum": [ "", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11" ], "enumTitles": [ "Any", "Euro 1", "Euro 2", "Euro 3", "Euro 4", "Euro 5", "Euro 6", "7", "8", "9", "10", "11" ], "default": "" }, "previousOwnersMax": { "title": "Previous Owners (max)", "type": "string", "description": "Maximum previous owners (HTML `prevownersid`).", "editor": "select", "enum": [ "", "1", "2", "3", "4+" ], "enumTitles": [ "Any", "1", "2", "3", "4 or more" ], "default": "" }, "listedWithinDays": { "title": "Listed Within (days)", "type": "string", "description": "Only listings created within this many days (HTML `adage`).", "editor": "select", "enum": [ "", "0", "1", "2", "3", "4", "5", "6", "7", "14" ], "enumTitles": [ "Any", "Today", "1 day", "2 days", "3 days", "4 days", "5 days", "6 days", "7 days", "14 days" ], "default": "" }, "powerFrom": { "title": "Power From", "type": "integer", "description": "Minimum engine power in the unit set by Power Unit. HP is converted to kW before the request.", "minimum": 0, "maximum": 2000 }, "powerTo": { "title": "Power To", "type": "integer", "description": "Maximum engine power in the unit set by Power Unit. HP is converted to kW before the request.", "minimum": 0, "maximum": 2000 }, "powerUnit": { "title": "Power Unit", "type": "string", "description": "Unit for Power From / Power To. Bounds are always sent to AutoScout24 in kW.", "editor": "select", "enum": [ "kw", "hp" ], "enumTitles": [ "kW", "HP (PS)" ], "default": "kw", "prefill": "kw" }, "doorsFrom": { "title": "Doors From", "type": "integer", "description": "Minimum number of doors.", "minimum": 2, "maximum": 7 }, "doorsTo": { "title": "Doors To", "type": "integer", "description": "Maximum number of doors.", "minimum": 2, "maximum": 7 }, "seatsFrom": { "title": "Seats From", "type": "integer", "description": "Minimum number of seats.", "minimum": 1, "maximum": 12 }, "seatsTo": { "title": "Seats To", "type": "integer", "description": "Maximum number of seats.", "minimum": 1, "maximum": 12 }, "rangeFromKm": { "title": "Electric Range From (km)", "type": "integer", "description": "Minimum electric range. CH applies it server-side; HTML applies it when a detail record carries a range.", "minimum": 0, "maximum": 2000 }, "engineSizeFromCc": { "title": "Engine Size From (cc)", "type": "integer", "description": "Minimum engine displacement in cc (HTML `ccmfrom`, CH `cubicCapacityFrom`).", "minimum": 0, "maximum": 10000 }, "engineSizeToCc": { "title": "Engine Size To (cc)", "type": "integer", "description": "Maximum engine displacement in cc (HTML `ccmto`, CH `cubicCapacityTo`).", "minimum": 0, "maximum": 10000 }, "vatDeductibleOnly": { "title": "VAT Deductible Only", "type": "boolean", "description": "Only VAT-deductible listings (HTML `vatded=true`). CH has no equivalent filter.", "default": false, "prefill": false }, "damagedListings": { "title": "Damaged Listings", "type": "string", "description": "Whether to exclude, include, or return only damaged listings.", "editor": "select", "enum": [ "exclude", "include", "only" ], "enumTitles": [ "Exclude damaged", "Include damaged", "Damaged only" ], "default": "exclude" }, "zipCode": { "title": "ZIP / Postal Code", "type": "string", "description": "Postal code for the radius filter (HTML `zip`; CH geo lookup).", "editor": "textfield" }, "radiusKm": { "title": "Radius (km)", "type": "string", "description": "Radius around the ZIP/postal code.", "editor": "select", "enum": [ "0", "10", "20", "50", "100", "150", "200", "250", "300", "400" ], "enumTitles": [ "0 km", "10 km", "20 km", "50 km", "100 km", "150 km", "200 km", "250 km", "300 km", "400 km" ], "default": "50" }, "sellerType": { "title": "Seller Type", "type": "string", "description": "Filter by dealer or private seller.", "editor": "select", "enum": [ "", "dealer", "private" ], "enumTitles": [ "Any", "Dealer", "Private seller" ], "default": "" }, "sortBy": { "title": "Sort By", "type": "string", "description": "Result ordering. `distance` requires zipCode; `power` and `make` are not exposed because they are unreliable or empty.", "editor": "select", "enum": [ "standard", "price", "mileage", "year", "age", "distance" ], "enumTitles": [ "Standard", "Price", "Mileage", "First registration year", "Listing age", "Distance" ], "default": "standard" }, "sortOrder": { "title": "Sort Order", "type": "string", "description": "Ascending or descending.", "editor": "select", "enum": [ "asc", "desc" ], "enumTitles": [ "Ascending", "Descending" ], "default": "asc" }, "startPage": { "title": "Start Page", "type": "integer", "description": "First result page (1-based, 200 listings per page).", "minimum": 1, "maximum": 100000, "default": 1 }, "endPage": { "title": "End Page", "type": "integer", "description": "Last result page (inclusive). Clamped to the server's maximum page.", "minimum": 1, "maximum": 100000 }, "listingUrls": { "title": "Listing URLs (mode=getCarDetails)", "type": "array", "description": "AutoScout24 detail URLs (absolute or market-relative) to fetch details for.", "editor": "stringList" }, "searchUrls": { "title": "Search URLs (mode=searchByUrl)", "type": "array", "description": "AutoScout24 search URLs. Their filters are parsed and replayed; page/size/tracking params are dropped. A user-supplied `cy` on a `.com` URL is preserved because it selects the real country feed there; `/lst-moto` paths switch to motorcycles.", "editor": "requestListSources" }, "dealerUrls": { "title": "Dealer URLs (mode=dealerInventory)", "type": "array", "description": "AutoScout24 dealer/stock URLs. The actor reads the dealer page and, when possible, follows its stock search.", "editor": "requestListSources" }, "dealerIds": { "title": "Dealer IDs", "type": "array", "description": "HTML dealer customer IDs (cid) or Swiss seller IDs. Used by dealerInventory.", "editor": "stringList" }, "listingIds": { "title": "Listing IDs (mode=listingIds)", "type": "array", "description": "UUIDs, Swiss numeric IDs, or full listing URLs.", "editor": "stringList" }, "includeDetails": { "title": "Include Detail Enrichment", "type": "boolean", "description": "Fetch each listing's detail page (or CH detail + equipment) to fill body, colour, doors, seats, equipment, history, VAT, seller, GPS, price evaluation, view/favourite counters, mileage-history URL, Carfax (with partner-integration fallback) and created date. Failures keep the search card.", "default": false, "prefill": false }, "includeSellerProfile": { "title": "Include Seller Profile", "type": "boolean", "description": "Fetch the dealer/seller profile once per seller from `dealerInfoPage` for website, email, VAT/UID, phones, address, contact name, opening hours, imprint, ratings and up to 10 reviews. No extra request is made when this option is off; failures do not drop the listing.", "default": false, "prefill": false }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum listings to return. Values above the 4,000/query ceiling use year/price slicing; the hard maximum is 10,000. Prefill uses 3 so scheduled checks stay fast.", "minimum": 1, "maximum": 10000, "default": 100, "prefill": 3 } }, "required": [ "mode" ] }, "output": { "actorOutputSchemaVersion": 1, "title": "AutoScout24 Car Search Across 9 European Markets Output", "description": "Car listings from AutoScout24 with identity, vehicle, price, consumption, location, dealer profile (email, VAT/UID, reviews, address, opening hours), EV/charging, engagement counters, media, equipment/history, and enrichment metadata. Fields that the source does not publish are omitted; CHF prices use priceAmount + priceCurrency=CHF and all other markets use EUR.", "properties": { "carListings": { "type": "string", "title": "Car listings", "description": "Dataset of car listing records (recordType=carListing). One row per unique listing UUID or Swiss numeric id.", "template": "{{links.apiDefaultDatasetUrl}}/items" } } }, "defaultRunOptions": { "memoryMbytes": 1024, "timeoutSecs": 3600 }, "storages": { "dataset": { "actorSpecification": 1, "title": "AutoScout24 car listings", "description": "One record per car listing from 8 HTML AutoScout24 markets and the Swiss API, with optional detail and seller enrichment.", "fields": { "type": "object", "properties": { "id": { "type": [ "string", "null" ], "description": "Listing UUID (HTML) or numeric id (CH API)" }, "idType": { "type": [ "string", "null" ], "description": "uuid or chId" }, "crossReferenceId": { "type": [ "string", "null" ], "description": "Legacy AutoScout24 cross-reference id" }, "title": { "type": [ "string", "null" ], "description": "Listing title" }, "status": { "type": [ "string", "null" ], "description": "Listing status from the detail payload" }, "make": { "type": [ "string", "null" ], "description": "Car make" }, "model": { "type": [ "string", "null" ], "description": "Car model" }, "modelGroup": { "type": [ "string", "null" ], "description": "Model group / family" }, "variant": { "type": [ "string", "null" ], "description": "Trim, variant or version" }, "condition": { "type": [ "string", "null" ], "description": "new, used, demonstrator, oldtimer or other" }, "offerType": { "type": [ "string", "null" ], "description": "Raw HTML offer code (N/U/J/O/D/S)" }, "fuelType": { "type": [ "string", "null" ], "description": "Canonical fuel type" }, "fuelCode": { "type": [ "string", "null" ], "description": "Raw source fuel code" }, "transmission": { "type": [ "string", "null" ], "description": "automatic, manual or semi-automatic" }, "mileageKm": { "type": [ "integer", "null" ], "description": "Mileage in kilometres" }, "displacement": { "type": [ "integer", "null" ], "description": "Engine displacement in cc" }, "priceEur": { "type": [ "integer", "null" ], "description": "Price in EUR for EUR markets" }, "priceAmount": { "type": [ "number", "null" ], "description": "Price in priceCurrency (CHF for the Swiss market)" }, "priceCurrency": { "type": [ "string", "null" ], "description": "Currency code for priceAmount" }, "priceRaw": { "type": [ "integer", "null" ], "description": "Numeric source price" }, "priceFormatted": { "type": [ "string", "null" ], "description": "Source-formatted price" }, "priceMedian": { "type": [ "integer", "null" ], "description": "AutoScout24 price-evaluation median" }, "priceEvaluation": { "type": [ "integer", "null" ], "description": "AutoScout24 price-evaluation category" }, "priceEvaluationCategory": { "type": [ "integer", "null" ], "description": "AutoScout24 price-evaluation category" }, "priceEvaluationRanges": { "type": [ "array", "null" ], "description": "Price-evaluation ranges", "items": { "type": "object" } }, "netPrice": { "type": [ "integer", "null" ], "description": "Net price when the seller publishes it" }, "vatRate": { "type": [ "number", "null" ], "description": "VAT rate when published" }, "taxDeductible": { "type": [ "boolean", "null" ], "description": "Whether VAT is deductible" }, "negotiable": { "type": [ "boolean", "null" ], "description": "Whether the price is negotiable" }, "onRequestOnly": { "type": [ "boolean", "null" ], "description": "Price on request / POA sentinel" }, "listPrice": { "type": [ "number", "null" ], "description": "CH list price when the search price is a leasing rate" }, "leasingRate": { "type": [ "number", "null" ], "description": "CH leasing rate when split from listPrice" }, "dealerPrice": { "type": [ "integer", "null" ], "description": "Dealer-network price when published separately" }, "bodyType": { "type": [ "string", "null" ], "description": "Body type" }, "bodyColor": { "type": [ "string", "null" ], "description": "Exterior colour" }, "paintType": { "type": [ "string", "null" ], "description": "Paint finish" }, "powerKw": { "type": [ "integer", "null" ], "description": "Power in kW" }, "powerHp": { "type": [ "integer", "null" ], "description": "Power in HP/PS" }, "driveTrain": { "type": [ "string", "null" ], "description": "Drivetrain (awd/fwd/rwd or source label)" }, "cylinders": { "type": [ "integer", "null" ], "description": "Number of cylinders" }, "doors": { "type": [ "integer", "null" ], "description": "Number of doors" }, "seats": { "type": [ "integer", "null" ], "description": "Number of seats" }, "gears": { "type": [ "integer", "null" ], "description": "Number of gears" }, "firstRegistration": { "type": [ "string", "null" ], "description": "First-registration date as published" }, "firstRegistrationDate": { "type": [ "string", "null" ], "description": "ISO first-registration date" }, "year": { "type": [ "integer", "null" ], "description": "First-registration year (1900-2026)" }, "fuelConsumption": { "type": [ "string", "null" ], "description": "Published fuel consumption" }, "consumptionCombined": { "type": [ "number", "null" ], "description": "Combined consumption value" }, "co2EmissionsGkm": { "type": [ "string", "null" ], "description": "CO2 emissions with unit" }, "co2Emission": { "type": [ "number", "null" ], "description": "Numeric CO2 value" }, "emissionStandard": { "type": [ "string", "null" ], "description": "Emission standard" }, "energyLabel": { "type": [ "string", "null" ], "description": "CH energy label" }, "wltpValues": { "type": [ "array", "null" ], "description": "WLTP display values", "items": { "type": "string" } }, "wltp": { "type": [ "object", "null" ], "description": "Raw WLTP object when published" }, "location": { "type": [ "string", "null" ], "description": "City, country summary" }, "city": { "type": [ "string", "null" ], "description": "City" }, "countryCode": { "type": [ "string", "null" ], "description": "Country code" }, "zip": { "type": [ "string", "null" ], "description": "Postal code" }, "street": { "type": [ "string", "null" ], "description": "Street address when published" }, "region": { "type": [ "string", "null" ], "description": "Region when published" }, "latitude": { "type": [ "number", "null" ], "description": "Latitude" }, "longitude": { "type": [ "number", "null" ], "description": "Longitude" }, "coordinates": { "type": [ "object", "null" ], "description": "Latitude/longitude object" }, "sellerType": { "type": [ "string", "null" ], "description": "Canonical dealer or private" }, "sellerTypeRaw": { "type": [ "string", "null" ], "description": "Raw source seller type" }, "sellerName": { "type": [ "string", "null" ], "description": "Seller/dealer name" }, "sellerContact": { "type": [ "string", "null" ], "description": "Named contact when published" }, "sellerId": { "type": [ "string", "null" ], "description": "Seller id" }, "sellerPhone": { "type": [ "string", "null" ], "description": "First published phone number" }, "sellerPhones": { "type": [ "array", "null" ], "description": "Published phone numbers", "items": { "type": "string" } }, "sellerEmail": { "type": [ "string", "null" ], "description": "Dealer email from the profile or imprint" }, "sellerVatId": { "type": [ "string", "null" ], "description": "Dealer VAT/UID number from the profile or imprint" }, "sellerWebsite": { "type": [ "string", "null" ], "description": "Seller website when published" }, "sellerDealerUrl": { "type": [ "string", "null" ], "description": "AutoScout24 dealer page" }, "sellerAddress": { "type": [ "string", "null" ], "description": "Dealer postal address when published" }, "sellerImprint": { "type": [ "string", "null" ], "description": "Dealer imprint text when published" }, "sellerOpeningHours": { "type": [ "object", "array", "null" ], "description": "Opening hours when published" }, "sellerGooglePlace": { "type": [ "object", "null" ], "description": "Google place rating object" }, "sellerReviews": { "type": [ "array", "null" ], "description": "Up to 10 seller reviews when published", "items": { "type": "object" } }, "sellerReviewCount": { "type": [ "integer", "null" ], "description": "Number of seller reviews" }, "sellerRatingStars": { "type": [ "number", "null" ], "description": "Seller rating out of 5" }, "sellerRatingCount": { "type": [ "integer", "null" ], "description": "Number of ratings" }, "photos": { "type": [ "array", "null" ], "description": "Up to 20 absolute photo URLs", "items": { "type": "string" } }, "imageCount": { "type": [ "integer", "null" ], "description": "Full photo count before the 20 cap" }, "headerImage": { "type": [ "string", "null" ], "description": "Header image URL" }, "has360": { "type": [ "boolean", "null" ], "description": "Whether 360 content exists" }, "videoUrl": { "type": [ "string", "null" ], "description": "Video URL when published" }, "whatsapp": { "type": [ "string", "null" ], "description": "WhatsApp number when published" }, "listingUrl": { "type": [ "string", "null" ], "description": "Absolute listing URL" }, "sourceUrl": { "type": [ "string", "null" ], "description": "Source listing URL" }, "description": { "type": [ "string", "null" ], "description": "Plain-text description" }, "upholstery": { "type": [ "string", "null" ], "description": "Upholstery material" }, "upholsteryColor": { "type": [ "string", "null" ], "description": "Upholstery/interior colour" }, "interiorColor": { "type": [ "string", "null" ], "description": "CH interior colour" }, "hsnTsn": { "type": [ "string", "null" ], "description": "German HSN/TSN codes" }, "isDeliverable": { "type": [ "boolean", "null" ], "description": "Whether delivery is offered" }, "isNew": { "type": [ "boolean", "null" ], "description": "Source new/used flag" }, "directImport": { "type": [ "boolean", "null" ], "description": "CH direct-import flag" }, "warrantyAvailable": { "type": [ "boolean", "null" ], "description": "CH warrantyExists flag" }, "availabilityType": { "type": [ "integer", "null" ], "description": "CH availability type" }, "availableNow": { "type": [ "boolean", "null" ], "description": "Whether the listing is available now" }, "viewCount": { "type": [ "integer", "null" ], "description": "HTML detail interaction/view counter" }, "favoriteCount": { "type": [ "integer", "null" ], "description": "HTML detail favourite counter" }, "features": { "type": [ "array", "null" ], "description": "Flat equipment list", "items": { "type": "string" } }, "equipment": { "type": [ "object", "null" ], "description": "Equipment grouped by category" }, "previousOwners": { "type": [ "integer", "null" ], "description": "Number of previous owners" }, "accidentFree": { "type": [ "boolean", "null" ], "description": "Whether the source says accident-free" }, "fullServiceHistory": { "type": [ "boolean", "null" ], "description": "Full service history flag" }, "nonSmoking": { "type": [ "boolean", "null" ], "description": "Non-smoking flag" }, "newInspection": { "type": [ "boolean", "null" ], "description": "New inspection flag" }, "lastInspectionDate": { "type": [ "string", "null" ], "description": "Last inspection date" }, "inspectionPassed": { "type": [ "boolean", "null" ], "description": "CH inspection flag" }, "carfaxUrl": { "type": [ "string", "null" ], "description": "Carfax / vehicle report URL" }, "mileageHistoryUrl": { "type": [ "string", "null" ], "description": "Mileage-history report URL when published" }, "vehicleReport": { "type": [ "object", "null" ], "description": "Vehicle report object" }, "warranty": { "type": [ "string", "object", "null" ], "description": "Warranty details when published" }, "adTier": { "type": [ "string", "null" ], "description": "AutoScout24 ad tier (sort/ad disambiguation)" }, "certificationNumber": { "type": [ "string", "null" ], "description": "CH certification number" }, "batteryCapacityKwh": { "type": [ "number", "null" ], "description": "Battery capacity in kWh" }, "electricRangeKm": { "type": [ "integer", "null" ], "description": "Electric range in km" }, "chargingPowerKw": { "type": [ "number", "null" ], "description": "Charging power in kW" }, "fastChargingPowerKw": { "type": [ "number", "null" ], "description": "CH fast-charging power in kW" }, "fastChargingTime0To80Min": { "type": [ "number", "null" ], "description": "CH fast-charge time 0-80% in minutes" }, "chargingTime0To100Min": { "type": [ "number", "null" ], "description": "CH charge time 0-100% in minutes" }, "powerConsumptionKwh100km": { "type": [ "number", "null" ], "description": "CH electric consumption in kWh/100 km" }, "electricMotorHp": { "type": [ "integer", "null" ], "description": "CH electric motor power in HP" }, "combustionEngineHp": { "type": [ "integer", "null" ], "description": "CH combustion engine power in HP" }, "dimensions": { "type": [ "object", "null" ], "description": "Length/width/height in mm" }, "weightKg": { "type": [ "integer", "null" ], "description": "Weight in kg" }, "payloadKg": { "type": [ "integer", "null" ], "description": "Payload in kg" }, "towingCapacityKg": { "type": [ "integer", "null" ], "description": "Braked towing capacity in kg" }, "vin": { "type": [ "string", "null" ], "description": "VIN only when the source exposes it" }, "vehicleType": { "type": [ "string", "null" ], "description": "Source vehicle type/category" }, "createdAt": { "type": [ "string", "null" ], "description": "ISO listing creation time" }, "lastModifiedAt": { "type": [ "string", "null" ], "description": "ISO listing modification time" }, "searchPosition": { "type": [ "integer", "null" ], "description": "Position in the result page" }, "marketplace": { "type": [ "string", "null" ], "description": "Market key (de/at/be/fr/it/nl/pl/es/ch)" }, "language": { "type": [ "string", "null" ], "description": "Market language" }, "currency": { "type": [ "string", "null" ], "description": "Market currency" }, "source": { "type": [ "string", "null" ], "description": "html or chApi" }, "dedupeKey": { "type": [ "string", "null" ], "description": "idType:id dedupe key" }, "detailEnriched": { "type": [ "boolean", "null" ], "description": "True when detail data was merged" }, "sellerEnriched": { "type": [ "boolean", "null" ], "description": "True when a seller profile was merged" }, "recordType": { "type": [ "string", "null" ], "description": "Always carListing" }, "scrapedAt": { "type": [ "string", "null" ], "description": "UTC ISO scrape timestamp" } } }, "views": { "overview": { "title": "Car Listings", "transformation": { "fields": [ "id", "title", "make", "model", "year", "priceEur", "priceAmount", "priceCurrency", "mileageKm", "fuelType", "transmission", "sellerName", "sellerType", "city", "countryCode", "listingUrl", "createdAt" ] }, "display": { "component": "table", "properties": { "id": { "label": "ID", "format": "text" }, "title": { "label": "Title", "format": "text" }, "make": { "label": "Make", "format": "text" }, "model": { "label": "Model", "format": "text" }, "year": { "label": "Year", "format": "number" }, "priceEur": { "label": "Price (EUR)", "format": "number" }, "priceAmount": { "label": "Price", "format": "number" }, "priceCurrency": { "label": "Currency", "format": "text" }, "mileageKm": { "label": "Mileage (km)", "format": "number" }, "fuelType": { "label": "Fuel", "format": "text" }, "transmission": { "label": "Transmission", "format": "text" }, "sellerName": { "label": "Seller", "format": "text" }, "sellerType": { "label": "Seller type", "format": "text" }, "city": { "label": "City", "format": "text" }, "countryCode": { "label": "Country", "format": "text" }, "listingUrl": { "label": "Listing URL", "format": "link" }, "createdAt": { "label": "Created", "format": "text" } } } } } } }, "environmentVariables": {} }, "buildNumber": "1.0.2", "imageDigest": "63c51b364b5f505755a01ddd67cb861bce78c65cab154c6a4c091c9ad87740a1", "actVersion": { "sourceType": "SOURCE_FILES", "buildTag": "latest", "versionNumber": "1.0" }, "usage": { "ACTOR_COMPUTE_UNITS": 0.011904444444444445 } } }