AutoScout24 Vehicle Listings with Dealer Contact Details
Search AutoScout24 across eight European countries by make, price, mileage and location, and get full vehicle specs, equipment, photos and dealer contact details.
Input schema
Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.
| Field | Type | Required | Description |
|---|---|---|---|
mode | string | required | Search with filters, open specific listing IDs/URLs, scrape a dealer's inventory, or paginate search URLs you paste. |
searchQuery | string | optional | Free-text search, e.g. "BMW 320 Touring" (mode=search). |
make | string | optional | Vehicle make, e.g. bmw, audi, mercedes-benz, volkswagen (mode=search). |
Show all input fields
| Field | Type | Required | Description |
|---|---|---|---|
mode | string | required | Search with filters, open specific listing IDs/URLs, scrape a dealer's inventory, or paginate search URLs you paste. |
searchQuery | string | optional | Free-text search, e.g. "BMW 320 Touring" (mode=search). |
make | string | optional | Vehicle make, e.g. bmw, audi, mercedes-benz, volkswagen (mode=search). |
model | string | optional | Model as AutoScout24 spells it, e.g. 3er, a4, c-klasse, golf (mode=search). |
vehicleType | string | optional | Which vehicle category to search (mode=search). |
country | string | optional | Country site to search (mode=search). 'All eight country sites' runs one search per market; Belgium (French) and autoscout24.com stay separately selectable. |
priceMin | integer | optional | Lowest asking price in EUR. |
priceMax | integer | optional | Highest asking price in EUR. |
yearMin | integer | optional | Earliest first-registration year. |
yearMax | integer | optional | Latest first-registration year. |
mileageMin | integer | optional | Lowest mileage in kilometres. |
mileageMax | integer | optional | Highest mileage in kilometres. |
powerMin | integer | optional | Lowest engine power in kilowatts. |
powerMax | integer | optional | Highest engine power in kilowatts. |
fuelType | string | optional | Fuel or plug-in hybrid type. |
transmission | string | optional | Gearbox type. |
sellerType | string | optional | Dealer or private seller. |
bodyType | string | optional | Vehicle body style. |
color | string | optional | Exterior paint colour. |
driveTrain | string | optional | Driven wheels. |
zipCode | string | optional | Search around this postal code. Combine with the radius. |
radius | string | optional | Distance in kilometres from the ZIP code. |
sortBy | string | optional | Result order. |
onlineSinceDays | integer | optional | Only listings published within this many days. 0 means any age. |
previousOwnersMax | string | optional | Filter by the number of previous owners. |
damagedListings | string | optional | Whether to include listings marked as damaged. |
includeDetails | boolean | optional | Open each listing's detail page for specifications, equipment, description and high-resolution photos. Turn off for a faster, cheaper listing-only run. |
includeDealerContact | boolean | optional | Look up each dealer's public profile for email, website, opening hours and ratings. Phone numbers are already included from the listing. |
maxResults | integer | optional | Maximum listings to save. 0 means the site cap (4,000 per search query). |
startUrls | array | optional | URLs for mode=byUrl (search URLs), mode=details (listing URLs) or mode=dealer (dealer profile URLs). |
listingIds | array | optional | AutoScout24 listing UUIDs or listing URLs (mode=details). UUIDs use the selected Country; paste a full listing URL to pick the market automatically. |
Download the published input schema
View complete JSON
{
"description": "Search AutoScout24 vehicle listings, open listing or dealer URLs, or look up listing IDs. Choose whether to add full specification pages and dealer contact details.",
"properties": {
"bodyType": {
"description": "Vehicle body style.",
"editor": "select",
"enum": [
"",
"small-car",
"convertible",
"coupe",
"suv",
"estate",
"sedan",
"van",
"transporter",
"other"
],
"enumTitles": [
"Any",
"Small car",
"Convertible",
"Coupe",
"SUV / off-road / pickup",
"Estate",
"Sedan",
"Van / minibus",
"Transporter",
"Other"
],
"title": "Body type",
"type": "string"
},
"color": {
"description": "Exterior paint colour.",
"editor": "select",
"enum": [
"",
"beige",
"blue",
"brown",
"bronze",
"yellow",
"grey",
"green",
"red",
"black",
"silver",
"violet",
"white",
"orange",
"gold"
],
"enumTitles": [
"Any",
"Beige",
"Blue",
"Brown",
"Bronze",
"Yellow",
"Grey",
"Green",
"Red",
"Black",
"Silver",
"Violet",
"White",
"Orange",
"Gold"
],
"title": "Exterior colour",
"type": "string"
},
"country": {
"default": "de",
"description": "Country site to search (mode=search). 'All eight country sites' runs one search per market; Belgium (French) and autoscout24.com stay separately selectable.",
"editor": "select",
"enum": [
"de",
"at",
"be-nl",
"be-fr",
"es",
"fr",
"it",
"lu",
"nl",
"com",
"all"
],
"enumTitles": [
"Germany",
"Austria",
"Belgium (Dutch)",
"Belgium (French)",
"Spain",
"France",
"Italy",
"Luxembourg",
"Netherlands",
"Europe (autoscout24.com)",
"All eight country sites"
],
"prefill": "de",
"title": "Country",
"type": "string"
},
"damagedListings": {
"default": "exclude",
"description": "Whether to include listings marked as damaged.",
"editor": "select",
"enum": [
"exclude",
"include",
"only"
],
"enumTitles": [
"Exclude damaged vehicles",
"Include damaged vehicles",
"Only damaged vehicles"
],
"prefill": "exclude",
"title": "Damaged vehicles",
"type": "string"
},
"driveTrain": {
"description": "Driven wheels.",
"editor": "select",
"enum": [
"",
"awd",
"front",
"rear"
],
"enumTitles": [
"Any",
"All-wheel drive",
"Front-wheel drive",
"Rear-wheel drive"
],
"title": "Drive train",
"type": "string"
},
"fuelType": {
"description": "Fuel or plug-in hybrid type.",
"editor": "select",
"enum": [
"",
"petrol",
"diesel",
"electric",
"plug-in-hybrid-petrol",
"plug-in-hybrid-diesel",
"cng",
"lpg",
"ethanol",
"hydrogen",
"other"
],
"enumTitles": [
"Any",
"Petrol",
"Diesel",
"Electric",
"Plug-in hybrid (petrol)",
"Plug-in hybrid (diesel)",
"CNG",
"LPG",
"Ethanol",
"Hydrogen",
"Other"
],
"title": "Fuel type",
"type": "string"
},
"includeDealerContact": {
"default": true,
"description": "Look up each dealer's public profile for email, website, opening hours and ratings. Phone numbers are already included from the listing.",
"prefill": false,
"title": "Fetch dealer contact details",
"type": "boolean"
},
"includeDetails": {
"default": true,
"description": "Open each listing's detail page for specifications, equipment, description and high-resolution photos. Turn off for a faster, cheaper listing-only run.",
"prefill": false,
"title": "Fetch full vehicle details",
"type": "boolean"
},
"listingIds": {
"description": "AutoScout24 listing UUIDs or listing URLs (mode=details). UUIDs use the selected Country; paste a full listing URL to pick the market automatically.",
"editor": "stringList",
"prefill": [],
"title": "Listing IDs",
"type": "array"
},
"make": {
"description": "Vehicle make, e.g. bmw, audi, mercedes-benz, volkswagen (mode=search).",
"editor": "textfield",
"example": "bmw",
"prefill": "bmw",
"title": "Make",
"type": "string"
},
"maxResults": {
"default": 100,
"description": "Maximum listings to save. 0 means the site cap (4,000 per search query).",
"editor": "number",
"maximum": 10000,
"minimum": 0,
"prefill": 3,
"title": "Maximum results",
"type": "integer"
},
"mileageMax": {
"description": "Highest mileage in kilometres.",
"editor": "number",
"minimum": 0,
"title": "Maximum mileage (km)",
"type": "integer"
},
"mileageMin": {
"description": "Lowest mileage in kilometres.",
"editor": "number",
"minimum": 0,
"title": "Minimum mileage (km)",
"type": "integer"
},
"mode": {
"default": "search",
"description": "Search with filters, open specific listing IDs/URLs, scrape a dealer's inventory, or paginate search URLs you paste.",
"editor": "select",
"enum": [
"search",
"details",
"dealer",
"byUrl"
],
"enumTitles": [
"Search with filters",
"Listing IDs or listing URLs",
"Dealer inventory",
"Search URLs"
],
"prefill": "search",
"title": "Mode",
"type": "string"
},
"model": {
"description": "Model as AutoScout24 spells it, e.g. 3er, a4, c-klasse, golf (mode=search).",
"editor": "textfield",
"example": "3er",
"title": "Model",
"type": "string"
},
"onlineSinceDays": {
"default": 0,
"description": "Only listings published within this many days. 0 means any age.",
"editor": "number",
"maximum": 14,
"minimum": 0,
"title": "Online since (days)",
"type": "integer"
},
"powerMax": {
"description": "Highest engine power in kilowatts.",
"editor": "number",
"maximum": 2000,
"minimum": 0,
"title": "Maximum power (kW)",
"type": "integer"
},
"powerMin": {
"description": "Lowest engine power in kilowatts.",
"editor": "number",
"maximum": 2000,
"minimum": 0,
"title": "Minimum power (kW)",
"type": "integer"
},
"previousOwnersMax": {
"description": "Filter by the number of previous owners.",
"editor": "select",
"enum": [
"",
"1",
"2",
"3",
"4"
],
"enumTitles": [
"Any",
"1 owner",
"Up to 2 owners",
"Up to 3 owners",
"4 or more owners"
],
"title": "Maximum previous owners",
"type": "string"
},
"priceMax": {
"description": "Highest asking price in EUR.",
"editor": "number",
"minimum": 0,
"title": "Maximum price",
"type": "integer"
},
"priceMin": {
"description": "Lowest asking price in EUR.",
"editor": "number",
"minimum": 0,
"title": "Minimum price",
"type": "integer"
},
"radius": {
"description": "Distance in kilometres from the ZIP code.",
"editor": "select",
"enum": [
"10",
"20",
"50",
"100",
"150",
"200",
"250",
"300",
"400"
],
"enumTitles": [
"10 km",
"20 km",
"50 km",
"100 km",
"150 km",
"200 km",
"250 km",
"300 km",
"400 km"
],
"title": "Radius around ZIP",
"type": "string"
},
"searchQuery": {
"description": "Free-text search, e.g. \"BMW 320 Touring\" (mode=search).",
"editor": "textfield",
"title": "Search text",
"type": "string"
},
"sellerType": {
"description": "Dealer or private seller.",
"editor": "select",
"enum": [
"",
"dealer",
"private"
],
"enumTitles": [
"Any",
"Dealer",
"Private seller"
],
"title": "Seller type",
"type": "string"
},
"sortBy": {
"default": "standard",
"description": "Result order.",
"editor": "select",
"enum": [
"standard",
"price-asc",
"price-desc",
"mileage-asc",
"mileage-desc",
"year-desc",
"year-asc",
"power-desc",
"newest",
"distance"
],
"enumTitles": [
"Best match",
"Price: low to high",
"Price: high to low",
"Mileage: low to high",
"Mileage: high to low",
"First registration: newest first",
"First registration: oldest first",
"Power: highest first",
"Newest listings first",
"Distance (requires ZIP code)"
],
"prefill": "standard",
"title": "Sort by",
"type": "string"
},
"startUrls": {
"description": "URLs for mode=byUrl (search URLs), mode=details (listing URLs) or mode=dealer (dealer profile URLs).",
"editor": "requestListSources",
"prefill": [],
"title": "Start URLs",
"type": "array"
},
"transmission": {
"description": "Gearbox type.",
"editor": "select",
"enum": [
"",
"manual",
"automatic",
"semi-automatic"
],
"enumTitles": [
"Any",
"Manual",
"Automatic",
"Semi-automatic"
],
"title": "Transmission",
"type": "string"
},
"vehicleType": {
"default": "car",
"description": "Which vehicle category to search (mode=search).",
"editor": "select",
"enum": [
"car",
"motorcycle",
"caravan",
"transporter"
],
"enumTitles": [
"Cars",
"Motorcycles",
"Caravans",
"Transporters"
],
"prefill": "car",
"title": "Vehicle type",
"type": "string"
},
"yearMax": {
"description": "Latest first-registration year.",
"editor": "number",
"maximum": 2030,
"minimum": 1900,
"title": "First registration to",
"type": "integer"
},
"yearMin": {
"description": "Earliest first-registration year.",
"editor": "number",
"maximum": 2030,
"minimum": 1900,
"title": "First registration from",
"type": "integer"
},
"zipCode": {
"description": "Search around this postal code. Combine with the radius.",
"editor": "textfield",
"example": "80331",
"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.
| Field | Type | Required | Description |
|---|---|---|---|
listings | string | optional | Dataset containing all scraped AutoScout24 vehicle listings. |
Download the published output schema
View complete JSON
{
"actorOutputSchemaVersion": 1,
"description": "AutoScout24 vehicle listings with price, specifications, equipment, photos, seller and public dealer contact details.",
"properties": {
"listings": {
"description": "Dataset containing all scraped AutoScout24 vehicle listings.",
"template": "{{links.apiDefaultDatasetUrl}}/items",
"title": "AutoScout24 vehicle listings",
"type": "string"
}
},
"title": "AutoScout24 Vehicle Listings with Dealer Contact Details 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,
"title": "AutoScout24 Listings",
"views": {
"overview": {
"display": {
"component": "table",
"properties": {
"listingId": {
"format": "text",
"label": "ID"
},
"price.amount": {
"format": "number",
"label": "Price"
},
"title": {
"format": "text",
"label": "Title"
},
"vehicle.mileage": {
"format": "number",
"label": "Mileage"
},
"vehicle.year": {
"format": "number",
"label": "Year"
}
}
},
"title": "Overview",
"transformation": {
"fields": [
"listingId",
"title",
"price.amount",
"price.currency",
"vehicle.year",
"vehicle.mileage",
"specifications.fuelType",
"seller.name",
"location.city",
"url"
]
}
}
}
}
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 Vehicle Listings with Dealer Contact Details
Collect vehicle listings from AutoScout24 with prices, mileage, first registration, power, fuel, transmission, body and colour, equipment, high-resolution photos and the seller's public contact details. Search by filters, paste search URLs, scrape a dealer's inventory, or open known listing IDs.
What this actor does
- Searches eight AutoScout24 country sites and the English
autoscout24.commarketplace. - Supports free-text search plus make, model, vehicle type, price, year, mileage, power, fuel, transmission, seller type, body, colour, drivetrain, postal code/radius, previous owners and listing age.
- Walks the result pages up to the source cap and de-duplicates listings by their AutoScout24 ID.
- Opens each listing's detail page on request for the full specification sheet, equipment list, description, price evaluation and 1280x960 photos.
- Adds public dealer contact details from the dealer's profile: phone, email, website, address, opening hours, rating, review count, contact persons and VAT/register details when the dealer publishes them.
- Scrapes a dealer's live inventory for the selected vehicle type from a dealer profile URL.
- Omits fields the source does not publish; every record contains only real, non-empty values.
Markets
| Value | Site |
|---|---|
de |
autoscout24.de |
at |
autoscout24.at |
be-nl / be-fr |
autoscout24.be (Dutch / French) |
es |
autoscout24.es |
fr |
autoscout24.fr |
it |
autoscout24.it |
lu |
autoscout24.lu |
nl |
autoscout24.nl |
com |
autoscout24.com (English pan-European feed) |
all |
Runs the eight local country sites (de, at, be-nl, es, fr, it, lu, nl) and merges by listing ID; be-fr and com stay separate |
Output per listing
| Group | Fields |
|---|---|
| Listing | platform, listingId, url, title, subtitle, description, descriptionHtml, status, createdAt, lastModifiedAt |
| Price | price.amount, price.currency, price.formatted, price.raw, price.net, price.negotiable, price.onRequestOnly, price.taxDeductible, price.vatRate, price.isFinalPrice, price.evaluation, price.median, price.previousAmount |
| Vehicle | vehicle.make, model, modelGroup, modelVersion, motorType, variant, condition, offerType, vehicleType, bodyType, year, month, firstRegistrationDate, mileage, mileageUnit, vin, hsnTsn, previousOwners, accidentFree, hasFullServiceHistory, nonSmoking, newInspection, warranty, doors, seats, color, paintType, upholstery, upholsteryColor, cylinders, gears, driveTrain, displacementCcm, weightKg, towingCapacity |
| Specifications | specifications.powerKw, powerHp, power, fuelType, fuelCode, transmission, transmissionCode, driveType, consumptionL100km, consumption, co2Emissions, emission, electricRangeKm, batteryCapacityKwh |
| Equipment | features (flat list), equipment (grouped by comfort, entertainment, safety and extras) |
| Seller | seller.type, isDealer, name, contact, address, city, zip, country, phone, phoneE164, phones, emails, website, dealerUrl, dealerId, rating, ratingCount, reviewCount, recommendPercentage, openingHours, contactPersons, additionalServices, about, imprint, vatId, registerNumber, logo |
| Location | location.country, city, zip, street, region, latitude, longitude, coordinates |
| Media | images, thumbnail, imageCount, has360, videoUrl, whatsappNumber |
| Meta | meta.scrapedAt, meta.country, meta.marketplace, meta.language, meta.source, meta.crawlId, meta.promoted, meta.searchPosition, meta.deliveryAvailable |
Fields are nested for readability. Empty values are omitted rather than emitted as null.
Input
| Field | Type | Default | Description |
|---|---|---|---|
mode |
select | search |
search, details, dealer or byUrl |
searchQuery |
text | – | Free-text search |
make / model |
text | – | AutoScout24 make and model slugs, e.g. bmw, 3er |
vehicleType |
select | car |
Cars, motorcycles, caravans or transporters |
country |
select | de |
One market, com, or all |
priceMin / priceMax |
number | – | Price range in EUR |
yearMin / yearMax |
number | – | First-registration year range |
mileageMin / mileageMax |
number | – | Mileage range in km |
powerMin / powerMax |
number | – | Power range in kW |
fuelType |
select | – | Petrol, diesel, electric, plug-in hybrids, CNG, LPG, ethanol, hydrogen, other |
transmission |
select | – | Manual, automatic or semi-automatic |
sellerType |
select | – | Dealer or private seller |
bodyType |
select | – | Small car, convertible, coupe, SUV, estate, sedan, van, transporter, other |
color |
select | – | Exterior colour |
driveTrain |
select | – | All-wheel, front-wheel or rear-wheel drive |
zipCode / radius |
text / select | – | Search around a postal code |
sortBy |
select | standard |
Price, mileage, registration year, power, newest or distance |
onlineSinceDays |
number | 0 |
Only listings published within N days; 0 = any |
previousOwnersMax |
select | – | 1, 2, 3 or 4+ previous owners |
damagedListings |
select | exclude |
Exclude, include or only damaged vehicles |
includeDetails |
boolean | true |
Open every listing's detail page |
includeDealerContact |
boolean | true |
Add the dealer's public profile details |
maxResults |
number | 100 |
Row cap; 0 means the 4,000-row source cap for the run (shared across markets and de-duplicated) |
startUrls |
array | – | Search URLs (byUrl), listing URLs (details) or dealer URLs (dealer) |
listingIds |
array | – | Listing UUIDs or listing URLs (details). UUIDs use the selected country; full URLs select their own market. |
Examples
Search in Germany:
{
"mode": "search",
"country": "de",
"make": "bmw",
"model": "3er",
"priceMax": 30000,
"yearMin": 2019,
"fuelType": "diesel",
"transmission": "automatic",
"maxResults": 50
}
Search all eight country sites:
{
"mode": "search",
"country": "all",
"make": "volkswagen",
"model": "golf",
"maxResults": 200
}
Open listing IDs:
{
"mode": "details",
"country": "de",
"listingIds": ["dc39eaab-7f63-4b3b-b732-ae82f17ef805"],
"includeDealerContact": true
}
Scrape a dealer's inventory:
{
"mode": "dealer",
"startUrls": [{"url": "https://www.autoscout24.de/haendler/autohaus-next-car"}],
"maxResults": 100
}
Use a saved search URL:
{
"mode": "byUrl",
"startUrls": [{"url": "https://www.autoscout24.it/lst/bmw?atype=C&fuel=D&sort=price&desc=0"}],
"maxResults": 100
}
Dealer contact coverage
Dealer phone numbers are present on the listing itself and are collected for every dealer listing. Email, website, opening hours, rating and VAT/register details come from the dealer's public profile and are included when the dealer publishes them; they are never guessed. Private sellers usually do not publish a company name or email.
Limits
- AutoScout24 returns at most 4,000 listings for one search query. The actor de-duplicates repeated listings across pages, so a cap-level query can return slightly fewer than 4,000 unique rows. Narrow the filters to collect a larger slice of the market.
- Switzerland (
autoscout24.ch) runs on a separate API and is not included; the eight country sites andautoscout24.comare covered. - Some specification fields (consumption, CO2, warranty, net price) are only shown when the seller provides them.
- Buy-online (
smyle) listings opened directly by URL or ID return the smyle specification sheet; seller, location and the full photo set are merged when the same listing is reached through search results. - The actor is stateless: there is no only-new mode. Keep the
listingIdvalues from a previous run and compare them in your own pipeline. autoscout24.comis an English pan-European feed and overlaps the country sites; use one or the other when de-duplicating yourself.
FAQ
Do I need an account, login or API key? No. The actor reads public pages and returns data without any credentials.
Which markets are covered?
Germany, Austria, Belgium (Dutch and French), Spain, France, Italy, Luxembourg, the Netherlands and the English autoscout24.com feed.
What is the difference between includeDetails on and off?
With it on, every listing's detail page is opened for specifications, equipment, description, price evaluation and high-resolution photos. With it off, the run is faster and returns the fields shown on the search results card.
How do I scrape a dealer's inventory?
Use mode: "dealer" and paste the dealer profile URL in startUrls. The run returns that dealer's stock for the selected vehicle type (cars by default); run again with another vehicle type if the dealer also lists transporters, motorcycles or caravans.
Can I use listing IDs instead of URLs?
Yes. Put the AutoScout24 UUIDs in listingIds with mode: "details".
Why are some dealer fields missing? Email, website, opening hours and VAT details are optional on AutoScout24. They are included only when the dealer publishes them.
Why do I get fewer rows than maxResults?
The source caps each search query at 4,000 listings, some combinations of filters have fewer results, and repeated listings are de-duplicated. The run status reports the reason.
Is this affiliated with AutoScout24? No. This actor reads public pages and is not affiliated with, endorsed by or sponsored by AutoScout24.
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.
Source build 5xy9ar3jXECfZfhdc. Documentation is regenerated from the default published build; private drafts are not included.