Nimbryxo Studio
Actors/AutoScout24 Car Search Across 9 European Markets

AutoScout24 Car Search Across 9 European Markets

Search AutoScout24 car listings across nine European countries by make, price, mileage, fuel type and body type, or fetch full detail records for specific listing URLs.

Open on ApifyGitHub source

Input schema

Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.

FieldTypeRequiredDescription
modestringrequiredWhat to do: search by filters, fetch listing URLs, replay search URLs, read dealer inventory, or resolve listing IDs.
makestringoptionalCar brand/manufacturer to filter by (e.g. BMW, Mercedes-Benz, Volkswagen, Audi, Toyota).
modelstringoptionalModel name to filter (e.g. 3 Series, Golf, A4). Leave empty for all models.
Show all input fields
FieldTypeRequiredDescription
modestringrequiredWhat to do: search by filters, fetch listing URLs, replay search URLs, read dealer inventory, or resolve listing IDs.
makestringoptionalCar brand/manufacturer to filter by (e.g. BMW, Mercedes-Benz, Volkswagen, Audi, Toyota).
modelstringoptionalModel name to filter (e.g. 3 Series, Golf, A4). Leave empty for all models.
searchQuerystringoptionalFree-text keyword applied to the search (e.g. panoramic, quattro).
yearFromintegeroptionalMinimum first registration year (1900-2026).
yearTointegeroptionalMaximum first registration year (1900-2026).
priceFromintegeroptionalMinimum price in the selected market's currency (EUR everywhere except Switzerland, which uses CHF).
priceTointegeroptionalMaximum price in the selected market's currency.
mileageMaxintegeroptionalMaximum mileage in kilometres.
fuelTypestringoptionalFuel type filter. 'hybrid' matches all hybrid and plug-in hybrid listings.
transmissionstringoptionalTransmission type filter.
countrystringoptionalMarket to search. 'all' loops the 8 HTML markets plus Switzerland. '.com' is URL-only and is not part of 'all'.
conditionstringoptionalVehicle condition. N=new, U=used, J=young used, O=oldtimer, D=demonstrator, S=other. Sent as `offer`, never `ustate`.
bodyTypestringoptionalVehicle body type filter.
vehicleTypestringoptionalVehicle 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.
drivetrainstringoptionalDrivetrain filter (HTML `dtrain`, CH equivalent).
bodyColorstringoptionalExterior colour filter.
interiorColorstringoptionalInterior colour filter.
upholsterystringoptionalInterior upholstery filter.
equipmentarrayoptionalAutoScout24 equipment taxonomy IDs passed as `eq` (HTML) or `equipmentSearchAttributes` (CH).
emissionStandardstringoptionalEmission standard code 1-11 (HTML `emclass`).
previousOwnersMaxstringoptionalMaximum previous owners (HTML `prevownersid`).
listedWithinDaysstringoptionalOnly listings created within this many days (HTML `adage`).
powerFromintegeroptionalMinimum engine power in the unit set by Power Unit. HP is converted to kW before the request.
powerTointegeroptionalMaximum engine power in the unit set by Power Unit. HP is converted to kW before the request.
powerUnitstringoptionalUnit for Power From / Power To. Bounds are always sent to AutoScout24 in kW.
doorsFromintegeroptionalMinimum number of doors.
doorsTointegeroptionalMaximum number of doors.
seatsFromintegeroptionalMinimum number of seats.
seatsTointegeroptionalMaximum number of seats.
rangeFromKmintegeroptionalMinimum electric range. CH applies it server-side; HTML applies it when a detail record carries a range.
engineSizeFromCcintegeroptionalMinimum engine displacement in cc (HTML `ccmfrom`, CH `cubicCapacityFrom`).
engineSizeToCcintegeroptionalMaximum engine displacement in cc (HTML `ccmto`, CH `cubicCapacityTo`).
vatDeductibleOnlybooleanoptionalOnly VAT-deductible listings (HTML `vatded=true`). CH has no equivalent filter.
damagedListingsstringoptionalWhether to exclude, include, or return only damaged listings.
zipCodestringoptionalPostal code for the radius filter (HTML `zip`; CH geo lookup).
radiusKmstringoptionalRadius around the ZIP/postal code.
sellerTypestringoptionalFilter by dealer or private seller.
sortBystringoptionalResult ordering. `distance` requires zipCode; `power` and `make` are not exposed because they are unreliable or empty.
sortOrderstringoptionalAscending or descending.
startPageintegeroptionalFirst result page (1-based, 200 listings per page).
endPageintegeroptionalLast result page (inclusive). Clamped to the server's maximum page.
listingUrlsarrayoptionalAutoScout24 detail URLs (absolute or market-relative) to fetch details for.
searchUrlsarrayoptionalAutoScout24 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.
dealerUrlsarrayoptionalAutoScout24 dealer/stock URLs. The actor reads the dealer page and, when possible, follows its stock search.
dealerIdsarrayoptionalHTML dealer customer IDs (cid) or Swiss seller IDs. Used by dealerInventory.
listingIdsarrayoptionalUUIDs, Swiss numeric IDs, or full listing URLs.
includeDetailsbooleanoptionalFetch 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.
includeSellerProfilebooleanoptionalFetch 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.
maxItemsintegeroptionalMaximum 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.

Download the published input schema

View complete JSON
{
  "description": "Search AutoScout24 across 8 HTML markets plus the Swiss API, fetch detail pages, follow search/dealer URLs, or resolve listing IDs.",
  "properties": {
    "bodyColor": {
      "default": "",
      "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"
      ],
      "title": "Exterior Colour",
      "type": "string"
    },
    "bodyType": {
      "default": "",
      "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"
      ],
      "title": "Body Type",
      "type": "string"
    },
    "condition": {
      "default": "",
      "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"
      ],
      "title": "Condition",
      "type": "string"
    },
    "country": {
      "default": "de",
      "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"
      ],
      "prefill": "de",
      "title": "Country",
      "type": "string"
    },
    "damagedListings": {
      "default": "exclude",
      "description": "Whether to exclude, include, or return only damaged listings.",
      "editor": "select",
      "enum": [
        "exclude",
        "include",
        "only"
      ],
      "enumTitles": [
        "Exclude damaged",
        "Include damaged",
        "Damaged only"
      ],
      "title": "Damaged Listings",
      "type": "string"
    },
    "dealerIds": {
      "description": "HTML dealer customer IDs (cid) or Swiss seller IDs. Used by dealerInventory.",
      "editor": "stringList",
      "title": "Dealer IDs",
      "type": "array"
    },
    "dealerUrls": {
      "description": "AutoScout24 dealer/stock URLs. The actor reads the dealer page and, when possible, follows its stock search.",
      "editor": "requestListSources",
      "title": "Dealer URLs (mode=dealerInventory)",
      "type": "array"
    },
    "doorsFrom": {
      "description": "Minimum number of doors.",
      "maximum": 7,
      "minimum": 2,
      "title": "Doors From",
      "type": "integer"
    },
    "doorsTo": {
      "description": "Maximum number of doors.",
      "maximum": 7,
      "minimum": 2,
      "title": "Doors To",
      "type": "integer"
    },
    "drivetrain": {
      "default": "",
      "description": "Drivetrain filter (HTML `dtrain`, CH equivalent).",
      "editor": "select",
      "enum": [
        "",
        "awd",
        "fwd",
        "rwd"
      ],
      "enumTitles": [
        "Any",
        "All-wheel drive",
        "Front-wheel drive",
        "Rear-wheel drive"
      ],
      "title": "Drivetrain",
      "type": "string"
    },
    "emissionStandard": {
      "default": "",
      "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"
      ],
      "title": "Emission Standard",
      "type": "string"
    },
    "endPage": {
      "description": "Last result page (inclusive). Clamped to the server's maximum page.",
      "maximum": 100000,
      "minimum": 1,
      "title": "End Page",
      "type": "integer"
    },
    "engineSizeFromCc": {
      "description": "Minimum engine displacement in cc (HTML `ccmfrom`, CH `cubicCapacityFrom`).",
      "maximum": 10000,
      "minimum": 0,
      "title": "Engine Size From (cc)",
      "type": "integer"
    },
    "engineSizeToCc": {
      "description": "Maximum engine displacement in cc (HTML `ccmto`, CH `cubicCapacityTo`).",
      "maximum": 10000,
      "minimum": 0,
      "title": "Engine Size To (cc)",
      "type": "integer"
    },
    "equipment": {
      "description": "AutoScout24 equipment taxonomy IDs passed as `eq` (HTML) or `equipmentSearchAttributes` (CH).",
      "editor": "stringList",
      "title": "Equipment IDs",
      "type": "array"
    },
    "fuelType": {
      "default": "",
      "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"
      ],
      "title": "Fuel Type",
      "type": "string"
    },
    "includeDetails": {
      "default": false,
      "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.",
      "prefill": false,
      "title": "Include Detail Enrichment",
      "type": "boolean"
    },
    "includeSellerProfile": {
      "default": false,
      "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.",
      "prefill": false,
      "title": "Include Seller Profile",
      "type": "boolean"
    },
    "interiorColor": {
      "default": "",
      "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"
      ],
      "title": "Interior Colour",
      "type": "string"
    },
    "listedWithinDays": {
      "default": "",
      "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"
      ],
      "title": "Listed Within (days)",
      "type": "string"
    },
    "listingIds": {
      "description": "UUIDs, Swiss numeric IDs, or full listing URLs.",
      "editor": "stringList",
      "title": "Listing IDs (mode=listingIds)",
      "type": "array"
    },
    "listingUrls": {
      "description": "AutoScout24 detail URLs (absolute or market-relative) to fetch details for.",
      "editor": "stringList",
      "title": "Listing URLs (mode=getCarDetails)",
      "type": "array"
    },
    "make": {
      "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",
      "title": "Car Make",
      "type": "string"
    },
    "maxItems": {
      "default": 100,
      "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.",
      "maximum": 10000,
      "minimum": 1,
      "prefill": 3,
      "title": "Max Items",
      "type": "integer"
    },
    "mileageMax": {
      "description": "Maximum mileage in kilometres.",
      "maximum": 2000000,
      "minimum": 0,
      "title": "Max Mileage (km)",
      "type": "integer"
    },
    "mode": {
      "default": "searchCars",
      "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"
      ],
      "prefill": "searchCars",
      "title": "Mode",
      "type": "string"
    },
    "model": {
      "description": "Model name to filter (e.g. 3 Series, Golf, A4). Leave empty for all models.",
      "editor": "textfield",
      "title": "Car Model",
      "type": "string"
    },
    "powerFrom": {
      "description": "Minimum engine power in the unit set by Power Unit. HP is converted to kW before the request.",
      "maximum": 2000,
      "minimum": 0,
      "title": "Power From",
      "type": "integer"
    },
    "powerTo": {
      "description": "Maximum engine power in the unit set by Power Unit. HP is converted to kW before the request.",
      "maximum": 2000,
      "minimum": 0,
      "title": "Power To",
      "type": "integer"
    },
    "powerUnit": {
      "default": "kw",
      "description": "Unit for Power From / Power To. Bounds are always sent to AutoScout24 in kW.",
      "editor": "select",
      "enum": [
        "kw",
        "hp"
      ],
      "enumTitles": [
        "kW",
        "HP (PS)"
      ],
      "prefill": "kw",
      "title": "Power Unit",
      "type": "string"
    },
    "previousOwnersMax": {
      "default": "",
      "description": "Maximum previous owners (HTML `prevownersid`).",
      "editor": "select",
      "enum": [
        "",
        "1",
        "2",
        "3",
        "4+"
      ],
      "enumTitles": [
        "Any",
        "1",
        "2",
        "3",
        "4 or more"
      ],
      "title": "Previous Owners (max)",
      "type": "string"
    },
    "priceFrom": {
      "description": "Minimum price in the selected market's currency (EUR everywhere except Switzerland, which uses CHF).",
      "maximum": 10000000,
      "minimum": 0,
      "title": "Price From",
      "type": "integer"
    },
    "priceTo": {
      "description": "Maximum price in the selected market's currency.",
      "maximum": 10000000,
      "minimum": 0,
      "title": "Price To",
      "type": "integer"
    },
    "radiusKm": {
      "default": "50",
      "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"
      ],
      "title": "Radius (km)",
      "type": "string"
    },
    "rangeFromKm": {
      "description": "Minimum electric range. CH applies it server-side; HTML applies it when a detail record carries a range.",
      "maximum": 2000,
      "minimum": 0,
      "title": "Electric Range From (km)",
      "type": "integer"
    },
    "searchQuery": {
      "description": "Free-text keyword applied to the search (e.g. panoramic, quattro).",
      "editor": "textfield",
      "title": "Keyword",
      "type": "string"
    },
    "searchUrls": {
      "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",
      "title": "Search URLs (mode=searchByUrl)",
      "type": "array"
    },
    "seatsFrom": {
      "description": "Minimum number of seats.",
      "maximum": 12,
      "minimum": 1,
      "title": "Seats From",
      "type": "integer"
    },
    "seatsTo": {
      "description": "Maximum number of seats.",
      "maximum": 12,
      "minimum": 1,
      "title": "Seats To",
      "type": "integer"
    },
    "sellerType": {
      "default": "",
      "description": "Filter by dealer or private seller.",
      "editor": "select",
      "enum": [
        "",
        "dealer",
        "private"
      ],
      "enumTitles": [
        "Any",
        "Dealer",
        "Private seller"
      ],
      "title": "Seller Type",
      "type": "string"
    },
    "sortBy": {
      "default": "standard",
      "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"
      ],
      "title": "Sort By",
      "type": "string"
    },
    "sortOrder": {
      "default": "asc",
      "description": "Ascending or descending.",
      "editor": "select",
      "enum": [
        "asc",
        "desc"
      ],
      "enumTitles": [
        "Ascending",
        "Descending"
      ],
      "title": "Sort Order",
      "type": "string"
    },
    "startPage": {
      "default": 1,
      "description": "First result page (1-based, 200 listings per page).",
      "maximum": 100000,
      "minimum": 1,
      "title": "Start Page",
      "type": "integer"
    },
    "transmission": {
      "default": "",
      "description": "Transmission type filter.",
      "editor": "select",
      "enum": [
        "",
        "automatic",
        "manual",
        "semi-automatic"
      ],
      "enumTitles": [
        "Any",
        "Automatic",
        "Manual",
        "Semi-automatic"
      ],
      "title": "Transmission",
      "type": "string"
    },
    "upholstery": {
      "default": "",
      "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"
      ],
      "title": "Upholstery",
      "type": "string"
    },
    "vatDeductibleOnly": {
      "default": false,
      "description": "Only VAT-deductible listings (HTML `vatded=true`). CH has no equivalent filter.",
      "prefill": false,
      "title": "VAT Deductible Only",
      "type": "boolean"
    },
    "vehicleType": {
      "default": "car",
      "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"
      ],
      "title": "Vehicle Category",
      "type": "string"
    },
    "yearFrom": {
      "description": "Minimum first registration year (1900-2026).",
      "maximum": 2026,
      "minimum": 1900,
      "title": "Year From",
      "type": "integer"
    },
    "yearTo": {
      "description": "Maximum first registration year (1900-2026).",
      "maximum": 2026,
      "minimum": 1900,
      "title": "Year To",
      "type": "integer"
    },
    "zipCode": {
      "description": "Postal code for the radius filter (HTML `zip`; CH geo lookup).",
      "editor": "textfield",
      "title": "ZIP / Postal Code",
      "type": "string"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "AutoScout24 Scraper Input",
  "type": "object"
}

Output schema

Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.

FieldTypeRequiredDescription
carListingsstringoptionalDataset of car listing records (recordType=carListing). One row per unique listing UUID or Swiss numeric id.

Download the published output schema

View complete JSON
{
  "actorOutputSchemaVersion": 1,
  "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": {
      "description": "Dataset of car listing records (recordType=carListing). One row per unique listing UUID or Swiss numeric id.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Car listings",
      "type": "string"
    }
  },
  "title": "AutoScout24 Car Search Across 9 European Markets Output"
}

Dataset schema

Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.

Download the published dataset schema

View complete JSON
{
  "actorSpecification": 1,
  "description": "One record per car listing from 8 HTML AutoScout24 markets and the Swiss API, with optional detail and seller enrichment.",
  "fields": {
    "properties": {
      "accidentFree": {
        "description": "Whether the source says accident-free",
        "type": [
          "boolean",
          "null"
        ]
      },
      "adTier": {
        "description": "AutoScout24 ad tier (sort/ad disambiguation)",
        "type": [
          "string",
          "null"
        ]
      },
      "availabilityType": {
        "description": "CH availability type",
        "type": [
          "integer",
          "null"
        ]
      },
      "availableNow": {
        "description": "Whether the listing is available now",
        "type": [
          "boolean",
          "null"
        ]
      },
      "batteryCapacityKwh": {
        "description": "Battery capacity in kWh",
        "type": [
          "number",
          "null"
        ]
      },
      "bodyColor": {
        "description": "Exterior colour",
        "type": [
          "string",
          "null"
        ]
      },
      "bodyType": {
        "description": "Body type",
        "type": [
          "string",
          "null"
        ]
      },
      "carfaxUrl": {
        "description": "Carfax / vehicle report URL",
        "type": [
          "string",
          "null"
        ]
      },
      "certificationNumber": {
        "description": "CH certification number",
        "type": [
          "string",
          "null"
        ]
      },
      "chargingPowerKw": {
        "description": "Charging power in kW",
        "type": [
          "number",
          "null"
        ]
      },
      "chargingTime0To100Min": {
        "description": "CH charge time 0-100% in minutes",
        "type": [
          "number",
          "null"
        ]
      },
      "city": {
        "description": "City",
        "type": [
          "string",
          "null"
        ]
      },
      "co2Emission": {
        "description": "Numeric CO2 value",
        "type": [
          "number",
          "null"
        ]
      },
      "co2EmissionsGkm": {
        "description": "CO2 emissions with unit",
        "type": [
          "string",
          "null"
        ]
      },
      "combustionEngineHp": {
        "description": "CH combustion engine power in HP",
        "type": [
          "integer",
          "null"
        ]
      },
      "condition": {
        "description": "new, used, demonstrator, oldtimer or other",
        "type": [
          "string",
          "null"
        ]
      },
      "consumptionCombined": {
        "description": "Combined consumption value",
        "type": [
          "number",
          "null"
        ]
      },
      "coordinates": {
        "description": "Latitude/longitude object",
        "type": [
          "object",
          "null"
        ]
      },
      "countryCode": {
        "description": "Country code",
        "type": [
          "string",
          "null"
        ]
      },
      "createdAt": {
        "description": "ISO listing creation time",
        "type": [
          "string",
          "null"
        ]
      },
      "crossReferenceId": {
        "description": "Legacy AutoScout24 cross-reference id",
        "type": [
          "string",
          "null"
        ]
      },
      "currency": {
        "description": "Market currency",
        "type": [
          "string",
          "null"
        ]
      },
      "cylinders": {
        "description": "Number of cylinders",
        "type": [
          "integer",
          "null"
        ]
      },
      "dealerPrice": {
        "description": "Dealer-network price when published separately",
        "type": [
          "integer",
          "null"
        ]
      },
      "dedupeKey": {
        "description": "idType:id dedupe key",
        "type": [
          "string",
          "null"
        ]
      },
      "description": {
        "description": "Plain-text description",
        "type": [
          "string",
          "null"
        ]
      },
      "detailEnriched": {
        "description": "True when detail data was merged",
        "type": [
          "boolean",
          "null"
        ]
      },
      "dimensions": {
        "description": "Length/width/height in mm",
        "type": [
          "object",
          "null"
        ]
      },
      "directImport": {
        "description": "CH direct-import flag",
        "type": [
          "boolean",
          "null"
        ]
      },
      "displacement": {
        "description": "Engine displacement in cc",
        "type": [
          "integer",
          "null"
        ]
      },
      "doors": {
        "description": "Number of doors",
        "type": [
          "integer",
          "null"
        ]
      },
      "driveTrain": {
        "description": "Drivetrain (awd/fwd/rwd or source label)",
        "type": [
          "string",
          "null"
        ]
      },
      "electricMotorHp": {
        "description": "CH electric motor power in HP",
        "type": [
          "integer",
          "null"
        ]
      },
      "electricRangeKm": {
        "description": "Electric range in km",
        "type": [
          "integer",
          "null"
        ]
      },
      "emissionStandard": {
        "description": "Emission standard",
        "type": [
          "string",
          "null"
        ]
      },
      "energyLabel": {
        "description": "CH energy label",
        "type": [
          "string",
          "null"
        ]
      },
      "equipment": {
        "description": "Equipment grouped by category",
        "type": [
          "object",
          "null"
        ]
      },
      "fastChargingPowerKw": {
        "description": "CH fast-charging power in kW",
        "type": [
          "number",
          "null"
        ]
      },
      "fastChargingTime0To80Min": {
        "description": "CH fast-charge time 0-80% in minutes",
        "type": [
          "number",
          "null"
        ]
      },
      "favoriteCount": {
        "description": "HTML detail favourite counter",
        "type": [
          "integer",
          "null"
        ]
      },
      "features": {
        "description": "Flat equipment list",
        "items": {
          "type": "string"
        },
        "type": [
          "array",
          "null"
        ]
      },
      "firstRegistration": {
        "description": "First-registration date as published",
        "type": [
          "string",
          "null"
        ]
      },
      "firstRegistrationDate": {
        "description": "ISO first-registration date",
        "type": [
          "string",
          "null"
        ]
      },
      "fuelCode": {
        "description": "Raw source fuel code",
        "type": [
          "string",
          "null"
        ]
      },
      "fuelConsumption": {
        "description": "Published fuel consumption",
        "type": [
          "string",
          "null"
        ]
      },
      "fuelType": {
        "description": "Canonical fuel type",
        "type": [
          "string",
          "null"
        ]
      },
      "fullServiceHistory": {
        "description": "Full service history flag",
        "type": [
          "boolean",
          "null"
        ]
      },
      "gears": {
        "description": "Number of gears",
        "type": [
          "integer",
          "null"
        ]
      },
      "has360": {
        "description": "Whether 360 content exists",
        "type": [
          "boolean",
          "null"
        ]
      },
      "headerImage": {
        "description": "Header image URL",
        "type": [
          "string",
          "null"
        ]
      },
      "hsnTsn": {
        "description": "German HSN/TSN codes",
        "type": [
          "string",
          "null"
        ]
      },
      "id": {
        "description": "Listing UUID (HTML) or numeric id (CH API)",
        "type": [
          "string",
          "null"
        ]
      },
      "idType": {
        "description": "uuid or chId",
        "type": [
          "string",
          "null"
        ]
      },
      "imageCount": {
        "description": "Full photo count before the 20 cap",
        "type": [
          "integer",
          "null"
        ]
      },
      "inspectionPassed": {
        "description": "CH inspection flag",
        "type": [
          "boolean",
          "null"
        ]
      },
      "interiorColor": {
        "description": "CH interior colour",
        "type": [
          "string",
          "null"
        ]
      },
      "isDeliverable": {
        "description": "Whether delivery is offered",
        "type": [
          "boolean",
          "null"
        ]
      },
      "isNew": {
        "description": "Source new/used flag",
        "type": [
          "boolean",
          "null"
        ]
      },
      "language": {
        "description": "Market language",
        "type": [
          "string",
          "null"
        ]
      },
      "lastInspectionDate": {
        "description": "Last inspection date",
        "type": [
          "string",
          "null"
        ]
      },
      "lastModifiedAt": {
        "description": "ISO listing modification time",
        "type": [
          "string",
          "null"
        ]
      },
      "latitude": {
        "description": "Latitude",
        "type": [
          "number",
          "null"
        ]
      },
      "leasingRate": {
        "description": "CH leasing rate when split from listPrice",
        "type": [
          "number",
          "null"
        ]
      },
      "listPrice": {
        "description": "CH list price when the search price is a leasing rate",
        "type": [
          "number",
          "null"
        ]
      },
      "listingUrl": {
        "description": "Absolute listing URL",
        "type": [
          "string",
          "null"
        ]
      },
      "location": {
        "description": "City, country summary",
        "type": [
          "string",
          "null"
        ]
      },
      "longitude": {
        "description": "Longitude",
        "type": [
          "number",
          "null"
        ]
      },
      "make": {
        "description": "Car make",
        "type": [
          "string",
          "null"
        ]
      },
      "marketplace": {
        "description": "Market key (de/at/be/fr/it/nl/pl/es/ch)",
        "type": [
          "string",
          "null"
        ]
      },
      "mileageHistoryUrl": {
        "description": "Mileage-history report URL when published",
        "type": [
          "string",
          "null"
        ]
      },
      "mileageKm": {
        "description": "Mileage in kilometres",
        "type": [
          "integer",
          "null"
        ]
      },
      "model": {
        "description": "Car model",
        "type": [
          "string",
          "null"
        ]
      },
      "modelGroup": {
        "description": "Model group / family",
        "type": [
          "string",
          "null"
        ]
      },
      "negotiable": {
        "description": "Whether the price is negotiable",
        "type": [
          "boolean",
          "null"
        ]
      },
      "netPrice": {
        "description": "Net price when the seller publishes it",
        "type": [
          "integer",
          "null"
        ]
      },
      "newInspection": {
        "description": "New inspection flag",
        "type": [
          "boolean",
          "null"
        ]
      },
      "nonSmoking": {
        "description": "Non-smoking flag",
        "type": [
          "boolean",
          "null"
        ]
      },
      "offerType": {
        "description": "Raw HTML offer code (N/U/J/O/D/S)",
        "type": [
          "string",
          "null"
        ]
      },
      "onRequestOnly": {
        "description": "Price on request / POA sentinel",
        "type": [
          "boolean",
          "null"
        ]
      },
      "paintType": {
        "description": "Paint finish",
        "type": [
          "string",
          "null"
        ]
      },
      "payloadKg": {
        "description": "Payload in kg",
        "type": [
          "integer",
          "null"
        ]
      },
      "photos": {
        "description": "Up to 20 absolute photo URLs",
        "items": {
          "type": "string"
        },
        "type": [
          "array",
          "null"
        ]
      },
      "powerConsumptionKwh100km": {
        "description": "CH electric consumption in kWh/100 km",
        "type": [
          "number",
          "null"
        ]
      },
      "powerHp": {
        "description": "Power in HP/PS",
        "type": [
          "integer",
          "null"
        ]
      },
      "powerKw": {
        "description": "Power in kW",
        "type": [
          "integer",
          "null"
        ]
      },
      "previousOwners": {
        "description": "Number of previous owners",
        "type": [
          "integer",
          "null"
        ]
      },
      "priceAmount": {
        "description": "Price in priceCurrency (CHF for the Swiss market)",
        "type": [
          "number",
          "null"
        ]
      },
      "priceCurrency": {
        "description": "Currency code for priceAmount",
        "type": [
          "string",
          "null"
        ]
      },
      "priceEur": {
        "description": "Price in EUR for EUR markets",
        "type": [
          "integer",
          "null"
        ]
      },
      "priceEvaluation": {
        "description": "AutoScout24 price-evaluation category",
        "type": [
          "integer",
          "null"
        ]
      },
      "priceEvaluationCategory": {
        "description": "AutoScout24 price-evaluation category",
        "type": [
          "integer",
          "null"
        ]
      },
      "priceEvaluationRanges": {
        "description": "Price-evaluation ranges",
        "items": {
          "type": "object"
        },
        "type": [
          "array",
          "null"
        ]
      },
      "priceFormatted": {
        "description": "Source-formatted price",
        "type": [
          "string",
          "null"
        ]
      },
      "priceMedian": {
        "description": "AutoScout24 price-evaluation median",
        "type": [
          "integer",
          "null"
        ]
      },
      "priceRaw": {
        "description": "Numeric source price",
        "type": [
          "integer",
          "null"
        ]
      },
      "recordType": {
        "description": "Always carListing",
        "type": [
          "string",
          "null"
        ]
      },
      "region": {
        "description": "Region when published",
        "type": [
          "string",
          "null"
        ]
      },
      "scrapedAt": {
        "description": "UTC ISO scrape timestamp",
        "type": [
          "string",
          "null"
        ]
      },
      "searchPosition": {
        "description": "Position in the result page",
        "type": [
          "integer",
          "null"
        ]
      },
      "seats": {
        "description": "Number of seats",
        "type": [
          "integer",
          "null"
        ]
      },
      "sellerAddress": {
        "description": "Dealer postal address when published",
        "type": [
          "string",
          "null"
        ]
      },
      "sellerContact": {
        "description": "Named contact when published",
        "type": [
          "string",
          "null"
        ]
      },
      "sellerDealerUrl": {
        "description": "AutoScout24 dealer page",
        "type": [
          "string",
          "null"
        ]
      },
      "sellerEmail": {
        "description": "Dealer email from the profile or imprint",
        "type": [
          "string",
          "null"
        ]
      },
      "sellerEnriched": {
        "description": "True when a seller profile was merged",
        "type": [
          "boolean",
          "null"
        ]
      },
      "sellerGooglePlace": {
        "description": "Google place rating object",
        "type": [
          "object",
          "null"
        ]
      },
      "sellerId": {
        "description": "Seller id",
        "type": [
          "string",
          "null"
        ]
      },
      "sellerImprint": {
        "description": "Dealer imprint text when published",
        "type": [
          "string",
          "null"
        ]
      },
      "sellerName": {
        "description": "Seller/dealer name",
        "type": [
          "string",
          "null"
        ]
      },
      "sellerOpeningHours": {
        "description": "Opening hours when published",
        "type": [
          "object",
          "array",
          "null"
        ]
      },
      "sellerPhone": {
        "description": "First published phone number",
        "type": [
          "string",
          "null"
        ]
      },
      "sellerPhones": {
        "description": "Published phone numbers",
        "items": {
          "type": "string"
        },
        "type": [
          "array",
          "null"
        ]
      },
      "sellerRatingCount": {
        "description": "Number of ratings",
        "type": [
          "integer",
          "null"
        ]
      },
      "sellerRatingStars": {
        "description": "Seller rating out of 5",
        "type": [
          "number",
          "null"
        ]
      },
      "sellerReviewCount": {
        "description": "Number of seller reviews",
        "type": [
          "integer",
          "null"
        ]
      },
      "sellerReviews": {
        "description": "Up to 10 seller reviews when published",
        "items": {
          "type": "object"
        },
        "type": [
          "array",
          "null"
        ]
      },
      "sellerType": {
        "description": "Canonical dealer or private",
        "type": [
          "string",
          "null"
        ]
      },
      "sellerTypeRaw": {
        "description": "Raw source seller type",
        "type": [
          "string",
          "null"
        ]
      },
      "sellerVatId": {
        "description": "Dealer VAT/UID number from the profile or imprint",
        "type": [
          "string",
          "null"
        ]
      },
      "sellerWebsite": {
        "description": "Seller website when published",
        "type": [
          "string",
          "null"
        ]
      },
      "source": {
        "description": "html or chApi",
        "type": [
          "string",
          "null"
        ]
      },
      "sourceUrl": {
        "description": "Source listing URL",
        "type": [
          "string",
          "null"
        ]
      },
      "status": {
        "description": "Listing status from the detail payload",
        "type": [
          "string",
          "null"
        ]
      },
      "street": {
        "description": "Street address when published",
        "type": [
          "string",
          "null"
        ]
      },
      "taxDeductible": {
        "description": "Whether VAT is deductible",
        "type": [
          "boolean",
          "null"
        ]
      },
      "title": {
        "description": "Listing title",
        "type": [
          "string",
          "null"
        ]
      },
      "towingCapacityKg": {
        "description": "Braked towing capacity in kg",
        "type": [
          "integer",
          "null"
        ]
      },
      "transmission": {
        "description": "automatic, manual or semi-automatic",
        "type": [
          "string",
          "null"
        ]
      },
      "upholstery": {
        "description": "Upholstery material",
        "type": [
          "string",
          "null"
        ]
      },
      "upholsteryColor": {
        "description": "Upholstery/interior colour",
        "type": [
          "string",
          "null"
        ]
      },
      "variant": {
        "description": "Trim, variant or version",
        "type": [
          "string",
          "null"
        ]
      },
      "vatRate": {
        "description": "VAT rate when published",
        "type": [
          "number",
          "null"
        ]
      },
      "vehicleReport": {
        "description": "Vehicle report object",
        "type": [
          "object",
          "null"
        ]
      },
      "vehicleType": {
        "description": "Source vehicle type/category",
        "type": [
          "string",
          "null"
        ]
      },
      "videoUrl": {
        "description": "Video URL when published",
        "type": [
          "string",
          "null"
        ]
      },
      "viewCount": {
        "description": "HTML detail interaction/view counter",
        "type": [
          "integer",
          "null"
        ]
      },
      "vin": {
        "description": "VIN only when the source exposes it",
        "type": [
          "string",
          "null"
        ]
      },
      "warranty": {
        "description": "Warranty details when published",
        "type": [
          "string",
          "object",
          "null"
        ]
      },
      "warrantyAvailable": {
        "description": "CH warrantyExists flag",
        "type": [
          "boolean",
          "null"
        ]
      },
      "weightKg": {
        "description": "Weight in kg",
        "type": [
          "integer",
          "null"
        ]
      },
      "whatsapp": {
        "description": "WhatsApp number when published",
        "type": [
          "string",
          "null"
        ]
      },
      "wltp": {
        "description": "Raw WLTP object when published",
        "type": [
          "object",
          "null"
        ]
      },
      "wltpValues": {
        "description": "WLTP display values",
        "items": {
          "type": "string"
        },
        "type": [
          "array",
          "null"
        ]
      },
      "year": {
        "description": "First-registration year (1900-2026)",
        "type": [
          "integer",
          "null"
        ]
      },
      "zip": {
        "description": "Postal code",
        "type": [
          "string",
          "null"
        ]
      }
    },
    "type": "object"
  },
  "title": "AutoScout24 car listings",
  "views": {
    "overview": {
      "display": {
        "component": "table",
        "properties": {
          "city": {
            "format": "text",
            "label": "City"
          },
          "countryCode": {
            "format": "text",
            "label": "Country"
          },
          "createdAt": {
            "format": "text",
            "label": "Created"
          },
          "fuelType": {
            "format": "text",
            "label": "Fuel"
          },
          "id": {
            "format": "text",
            "label": "ID"
          },
          "listingUrl": {
            "format": "link",
            "label": "Listing URL"
          },
          "make": {
            "format": "text",
            "label": "Make"
          },
          "mileageKm": {
            "format": "number",
            "label": "Mileage (km)"
          },
          "model": {
            "format": "text",
            "label": "Model"
          },
          "priceAmount": {
            "format": "number",
            "label": "Price"
          },
          "priceCurrency": {
            "format": "text",
            "label": "Currency"
          },
          "priceEur": {
            "format": "number",
            "label": "Price (EUR)"
          },
          "sellerName": {
            "format": "text",
            "label": "Seller"
          },
          "sellerType": {
            "format": "text",
            "label": "Seller type"
          },
          "title": {
            "format": "text",
            "label": "Title"
          },
          "transmission": {
            "format": "text",
            "label": "Transmission"
          },
          "year": {
            "format": "number",
            "label": "Year"
          }
        }
      },
      "title": "Car Listings",
      "transformation": {
        "fields": [
          "id",
          "title",
          "make",
          "model",
          "year",
          "priceEur",
          "priceAmount",
          "priceCurrency",
          "mileageKm",
          "fuelType",
          "transmission",
          "sellerName",
          "sellerType",
          "city",
          "countryCode",
          "listingUrl",
          "createdAt"
        ]
      }
    }
  }
}

Key-value schema

Published key-value store definitions, when provided by this build.

This definition is not present in the default published build. See the published README for available documentation.

Published README

Read the full published documentation

AutoScout24 Car Search Across 9 European Markets

Collect 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.

What this actor does

  • Five modes: searchCars, getCarDetails, searchByUrl, dealerInventory, listingIds
  • 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
  • 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
  • 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
  • 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

Output per listing

One 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.

  • Identity and lifecycle: id, idType, dedupeKey, crossReferenceId, title, status, offerType, condition, isNew, isDeliverable, recordType, scrapedAt
  • Listing metadata and source: listingUrl, sourceUrl, description, createdAt, lastModifiedAt, searchPosition, adTier, marketplace, language, currency, source
  • 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
  • Registration and efficiency: firstRegistration, firstRegistrationDate, year, fuelConsumption, consumptionCombined, co2EmissionsGkm, co2Emission, emissionStandard, energyLabel, wltpValues, wltp
  • Price: priceEur, priceAmount, priceCurrency, priceRaw, priceFormatted, priceMedian, priceEvaluation, priceEvaluationCategory, priceEvaluationRanges, netPrice, vatRate, taxDeductible, negotiable, onRequestOnly, listPrice, leasingRate, dealerPrice
  • EV, dimensions, availability and warranty: batteryCapacityKwh, electricRangeKm, chargingPowerKw, fastChargingPowerKw, fastChargingTime0To80Min, chargingTime0To100Min, powerConsumptionKwh100km, electricMotorHp, combustionEngineHp, directImport, warrantyAvailable, warranty, availabilityType, availableNow, dimensions, weightKg, payloadKg, towingCapacityKg
  • Location: location, city, countryCode, zip, street, region, latitude, longitude, coordinates
  • Seller and dealer: sellerType, sellerTypeRaw, sellerName, sellerContact, sellerId, sellerPhone, sellerPhones, sellerEmail, sellerVatId, sellerWebsite, sellerDealerUrl, sellerAddress, sellerImprint, sellerOpeningHours, sellerGooglePlace, sellerReviews, sellerReviewCount, sellerRatingStars, sellerRatingCount
  • Media: photos, imageCount, headerImage, has360, videoUrl, whatsapp
  • History, inspection and equipment: features, equipment, previousOwners, accidentFree, fullServiceHistory, nonSmoking, newInspection, lastInspectionDate, inspectionPassed, carfaxUrl, mileageHistoryUrl, vehicleReport, certificationNumber
  • Engagement and enrichment flags: viewCount, favoriteCount, detailEnriched, sellerEnriched

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.

Input

Field Type Default Description
mode string searchCars searchCars filters listings, getCarDetails fetches listing URLs, searchByUrl replays search URLs, dealerInventory reads dealer stock, listingIds resolves IDs or URLs.
make string – Manufacturer from a curated list of common European makes. Leave empty to search every make.
model string – Model name such as 3 Series, Golf or A4. Leave empty for all models.
searchQuery string – Free-text keyword applied to the search, such as panoramic or quattro.
yearFrom integer – Earliest first-registration year (1900–2026).
yearTo integer – Latest first-registration year (1900–2026).
priceFrom integer – Minimum price in the market currency (0–10,000,000).
priceTo integer – Maximum price in the market currency (0–10,000,000).
mileageMax integer – Maximum mileage in kilometres (0–2,000,000).
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.
transmission string – Automatic, manual or semi-automatic.
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.
condition string – New, used, young used, oldtimer, demonstrator or other.
bodyType string – Small car, convertible/cabrio, coupe, SUV/off-road/pickup, estate/kombi, sedan/limousine, other, van/minibus or panel van/transporter.
vehicleType string car Cars, motorcycles, caravans, campers/motorhomes, transporters/vans, utility vehicles or trucks. Switzerland supports cars, motorcycles, campers, utility vehicles and trucks.
drivetrain string – All-wheel, front-wheel or rear-wheel drive.
bodyColor string – Exterior colour.
interiorColor string – Interior colour.
upholstery string – Alcantara, cloth, full leather, partial leather, vinyl or other.
equipment array – AutoScout24 equipment IDs to require, using the IDs shown by the site.
emissionStandard string – Emission-standard code as used by AutoScout24 (Euro 1–6 and codes 7–11).
previousOwnersMax string – Any, 1, 2, 3, or 4 or more previous owners.
listedWithinDays string – Any, today, or 1–7 or 14 days since the listing was created.
powerFrom integer – Minimum engine power in the unit selected by powerUnit (0–2,000).
powerTo integer – Maximum engine power in the unit selected by powerUnit (0–2,000).
powerUnit string kw kw or hp (PS). AutoScout24 applies the bounds in kW.
doorsFrom integer – Minimum number of doors (2–7).
doorsTo integer – Maximum number of doors (2–7).
seatsFrom integer – Minimum number of seats (1–12).
seatsTo integer – Maximum number of seats (1–12).
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.
engineSizeFromCc integer – Minimum engine displacement in cc (0–10,000).
engineSizeToCc integer – Maximum engine displacement in cc (0–10,000).
vatDeductibleOnly boolean false Return only VAT-deductible listings. Applies to the eight local markets; Switzerland has no equivalent filter.
damagedListings string exclude exclude, include or only.
zipCode string – Postal code used for the radius filter and for distance sorting.
radiusKm string 50 Radius around the postal code: 0, 10, 20, 50, 100, 150, 200, 250, 300 or 400 km.
sellerType string – Any, dealer or private seller.
sortBy string standard Standard, price, mileage, first-registration year, listing age or distance. Distance requires zipCode.
sortOrder string asc Ascending or descending.
startPage integer 1 First result page, 1-based (1–100,000). Most markets return 200 listings per page; Switzerland returns 20.
endPage integer – Last result page, inclusive (1–100,000). Clamped to the last page the market allows.
listingUrls array – Listing URLs, absolute or market-relative, for getCarDetails.
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.
dealerUrls array of URLs – Dealer or dealer-stock pages for dealerInventory.
dealerIds array – Dealer customer IDs or Swiss seller IDs for dealerInventory.
listingIds array – Listing UUIDs, Swiss numeric IDs or full listing URLs for listingIds.
includeDetails boolean false Fetch each listing's detail page for extra vehicle, equipment, history, price-evaluation and engagement fields. Failures keep the search record.
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.
maxItems integer 100 Maximum listings to return (1–10,000). Searches above 4,000 results are split automatically. 
{
  "mode": "searchCars",
  "make": "BMW",
  "fuelType": "diesel",
  "bodyType": "4",
  "powerFrom": 100,
  "powerTo": 250,
  "powerUnit": "kw",
  "sellerType": "dealer",
  "yearFrom": 2015,
  "yearTo": 2022,
  "priceFrom": 10000,
  "priceTo": 40000,
  "country": "de",
  "maxItems": 50
}

Example: Swiss EV search with detail enrichment

{
  "mode": "searchCars",
  "country": "ch",
  "fuelType": "electric",
  "rangeFromKm": 400,
  "sortBy": "price",
  "sortOrder": "asc",
  "maxItems": 20,
  "includeDetails": true
}

Example: detail enrichment in search mode

{
  "mode": "searchCars",
  "make": "Audi",
  "country": "de",
  "maxItems": 20,
  "includeDetails": true,
  "includeSellerProfile": true
}

Example: replay a search URL

{
  "mode": "searchByUrl",
  "searchUrls": ["https://www.autoscout24.de/lst/bmw/320?fregfrom=2020&pricefrom=10000&sort=price&desc=0"],
  "maxItems": 100
}

Use cases

  • Dealerships and marketplaces — monitor competing stock, asking prices and listing age across nearby markets
  • Vehicle valuation and residual-value models — build comparable sets by make, model, year, mileage, equipment and condition
  • EV and fleet research — compare electric range, battery capacity, charging power and consumption across nine markets
  • Procurement and sourcing — find dealer stock by region, VAT status, seller type and damage status
  • Automotive data platforms — enrich catalogues with dealer contacts, VAT/UID, geodata, photos and vehicle history
  • Academic and market research — study used-car supply, pricing and specification trends across Europe

FAQ

Which AutoScout24 markets are supported?

Germany, 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.

What happens when a search has more than 4,000 results?

AutoScout24 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.

Why are some fields missing from a record?

AutoScout24 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.

No. The actor reads publicly available AutoScout24 listings anonymously. Set the input and run it.

Are Swiss prices converted to EUR?

No. Swiss records use priceAmount with priceCurrency: "CHF". Euro-market records, including Poland, use priceEur. No CHF value is labelled as EUR.

What does the seller profile add?

When 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.

Can I search only damaged cars or only VAT-deductible cars?

Yes. 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.

Why does distance sorting require a ZIP code?

AutoScout24 needs an origin point to calculate distance. Provide zipCode (and optionally radiusKm) when using sortBy: "distance"; otherwise choose another sort.

How current is the data?

Every 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.

Is this actor affiliated with AutoScout24?

No. This is an independent third-party actor that collects publicly available AutoScout24 listings.

Python quickstart

Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.

Open the step-by-step Python guide →

Source build 7pM4ZAf08ybOi0aeF. Documentation is regenerated from the default published build; private drafts are not included.