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.

Example: German diesel SUV search

{
  "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.

Do I need a login, cookie, API key or proxy?

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.