{ "data": { "id": "5xy9ar3jXECfZfhdc", "actId": "yffB7HBFSXcZB6sjC", "userId": "NL4ThgItAwaoBlffQ", "startedAt": "2026-10-27T15:03:00.528Z", "finishedAt": "2026-10-27T15:03:03.780Z", "status": "SUCCEEDED", "meta": { "origin": "CLI" }, "stats": { "durationMillis": 3151, "runTimeSecs": 3.151, "computeUnits": 0.003501111111111111, "imageSizeBytes": 318842880 }, "options": { "useCache": true, "betaPackages": false, "memoryMbytes": 4096, "diskMbytes": 8192 }, "createdByOrganizationMemberUserId": "zifX0mkAFMHe8CatY", "exitCode": 0, "inputSchema": "{\n \"title\": \"AutoScout24 Scraper Input\",\n \"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.\",\n \"type\": \"object\",\n \"schemaVersion\": 1,\n \"properties\": {\n \"mode\": {\n \"title\": \"Mode\",\n \"type\": \"string\",\n \"description\": \"Search with filters, open specific listing IDs/URLs, scrape a dealer's inventory, or paginate search URLs you paste.\",\n \"editor\": \"select\",\n \"enum\": [\n \"search\",\n \"details\",\n \"dealer\",\n \"byUrl\"\n ],\n \"enumTitles\": [\n \"Search with filters\",\n \"Listing IDs or listing URLs\",\n \"Dealer inventory\",\n \"Search URLs\"\n ],\n \"default\": \"search\",\n \"prefill\": \"search\"\n },\n \"searchQuery\": {\n \"title\": \"Search text\",\n \"type\": \"string\",\n \"description\": \"Free-text search, e.g. \\\"BMW 320 Touring\\\" (mode=search).\",\n \"editor\": \"textfield\"\n },\n \"make\": {\n \"title\": \"Make\",\n \"type\": \"string\",\n \"description\": \"Vehicle make, e.g. bmw, audi, mercedes-benz, volkswagen (mode=search).\",\n \"editor\": \"textfield\",\n \"prefill\": \"bmw\",\n \"example\": \"bmw\"\n },\n \"model\": {\n \"title\": \"Model\",\n \"type\": \"string\",\n \"description\": \"Model as AutoScout24 spells it, e.g. 3er, a4, c-klasse, golf (mode=search).\",\n \"editor\": \"textfield\",\n \"example\": \"3er\"\n },\n \"vehicleType\": {\n \"title\": \"Vehicle type\",\n \"type\": \"string\",\n \"description\": \"Which vehicle category to search (mode=search).\",\n \"editor\": \"select\",\n \"enum\": [\n \"car\",\n \"motorcycle\",\n \"caravan\",\n \"transporter\"\n ],\n \"enumTitles\": [\n \"Cars\",\n \"Motorcycles\",\n \"Caravans\",\n \"Transporters\"\n ],\n \"default\": \"car\",\n \"prefill\": \"car\"\n },\n \"country\": {\n \"title\": \"Country\",\n \"type\": \"string\",\n \"description\": \"Country site to search (mode=search). 'All eight country sites' runs one search per market; Belgium (French) and autoscout24.com stay separately selectable.\",\n \"editor\": \"select\",\n \"enum\": [\n \"de\",\n \"at\",\n \"be-nl\",\n \"be-fr\",\n \"es\",\n \"fr\",\n \"it\",\n \"lu\",\n \"nl\",\n \"com\",\n \"all\"\n ],\n \"enumTitles\": [\n \"Germany\",\n \"Austria\",\n \"Belgium (Dutch)\",\n \"Belgium (French)\",\n \"Spain\",\n \"France\",\n \"Italy\",\n \"Luxembourg\",\n \"Netherlands\",\n \"Europe (autoscout24.com)\",\n \"All eight country sites\"\n ],\n \"default\": \"de\",\n \"prefill\": \"de\"\n },\n \"priceMin\": {\n \"title\": \"Minimum price\",\n \"type\": \"integer\",\n \"description\": \"Lowest asking price in EUR.\",\n \"editor\": \"number\",\n \"minimum\": 0\n },\n \"priceMax\": {\n \"title\": \"Maximum price\",\n \"type\": \"integer\",\n \"description\": \"Highest asking price in EUR.\",\n \"editor\": \"number\",\n \"minimum\": 0\n },\n \"yearMin\": {\n \"title\": \"First registration from\",\n \"type\": \"integer\",\n \"description\": \"Earliest first-registration year.\",\n \"editor\": \"number\",\n \"minimum\": 1900,\n \"maximum\": 2030\n },\n \"yearMax\": {\n \"title\": \"First registration to\",\n \"type\": \"integer\",\n \"description\": \"Latest first-registration year.\",\n \"editor\": \"number\",\n \"minimum\": 1900,\n \"maximum\": 2030\n },\n \"mileageMin\": {\n \"title\": \"Minimum mileage (km)\",\n \"type\": \"integer\",\n \"description\": \"Lowest mileage in kilometres.\",\n \"editor\": \"number\",\n \"minimum\": 0\n },\n \"mileageMax\": {\n \"title\": \"Maximum mileage (km)\",\n \"type\": \"integer\",\n \"description\": \"Highest mileage in kilometres.\",\n \"editor\": \"number\",\n \"minimum\": 0\n },\n \"powerMin\": {\n \"title\": \"Minimum power (kW)\",\n \"type\": \"integer\",\n \"description\": \"Lowest engine power in kilowatts.\",\n \"editor\": \"number\",\n \"minimum\": 0,\n \"maximum\": 2000\n },\n \"powerMax\": {\n \"title\": \"Maximum power (kW)\",\n \"type\": \"integer\",\n \"description\": \"Highest engine power in kilowatts.\",\n \"editor\": \"number\",\n \"minimum\": 0,\n \"maximum\": 2000\n },\n \"fuelType\": {\n \"title\": \"Fuel type\",\n \"type\": \"string\",\n \"description\": \"Fuel or plug-in hybrid type.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"petrol\",\n \"diesel\",\n \"electric\",\n \"plug-in-hybrid-petrol\",\n \"plug-in-hybrid-diesel\",\n \"cng\",\n \"lpg\",\n \"ethanol\",\n \"hydrogen\",\n \"other\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"Petrol\",\n \"Diesel\",\n \"Electric\",\n \"Plug-in hybrid (petrol)\",\n \"Plug-in hybrid (diesel)\",\n \"CNG\",\n \"LPG\",\n \"Ethanol\",\n \"Hydrogen\",\n \"Other\"\n ]\n },\n \"transmission\": {\n \"title\": \"Transmission\",\n \"type\": \"string\",\n \"description\": \"Gearbox type.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"manual\",\n \"automatic\",\n \"semi-automatic\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"Manual\",\n \"Automatic\",\n \"Semi-automatic\"\n ]\n },\n \"sellerType\": {\n \"title\": \"Seller type\",\n \"type\": \"string\",\n \"description\": \"Dealer or private seller.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"dealer\",\n \"private\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"Dealer\",\n \"Private seller\"\n ]\n },\n \"bodyType\": {\n \"title\": \"Body type\",\n \"type\": \"string\",\n \"description\": \"Vehicle body style.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"small-car\",\n \"convertible\",\n \"coupe\",\n \"suv\",\n \"estate\",\n \"sedan\",\n \"van\",\n \"transporter\",\n \"other\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"Small car\",\n \"Convertible\",\n \"Coupe\",\n \"SUV / off-road / pickup\",\n \"Estate\",\n \"Sedan\",\n \"Van / minibus\",\n \"Transporter\",\n \"Other\"\n ]\n },\n \"color\": {\n \"title\": \"Exterior colour\",\n \"type\": \"string\",\n \"description\": \"Exterior paint colour.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"beige\",\n \"blue\",\n \"brown\",\n \"bronze\",\n \"yellow\",\n \"grey\",\n \"green\",\n \"red\",\n \"black\",\n \"silver\",\n \"violet\",\n \"white\",\n \"orange\",\n \"gold\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"Beige\",\n \"Blue\",\n \"Brown\",\n \"Bronze\",\n \"Yellow\",\n \"Grey\",\n \"Green\",\n \"Red\",\n \"Black\",\n \"Silver\",\n \"Violet\",\n \"White\",\n \"Orange\",\n \"Gold\"\n ]\n },\n \"driveTrain\": {\n \"title\": \"Drive train\",\n \"type\": \"string\",\n \"description\": \"Driven wheels.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"awd\",\n \"front\",\n \"rear\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"All-wheel drive\",\n \"Front-wheel drive\",\n \"Rear-wheel drive\"\n ]\n },\n \"zipCode\": {\n \"title\": \"ZIP / postal code\",\n \"type\": \"string\",\n \"description\": \"Search around this postal code. Combine with the radius.\",\n \"editor\": \"textfield\",\n \"example\": \"80331\"\n },\n \"radius\": {\n \"title\": \"Radius around ZIP\",\n \"type\": \"string\",\n \"description\": \"Distance in kilometres from the ZIP code.\",\n \"editor\": \"select\",\n \"enum\": [\n \"10\",\n \"20\",\n \"50\",\n \"100\",\n \"150\",\n \"200\",\n \"250\",\n \"300\",\n \"400\"\n ],\n \"enumTitles\": [\n \"10 km\",\n \"20 km\",\n \"50 km\",\n \"100 km\",\n \"150 km\",\n \"200 km\",\n \"250 km\",\n \"300 km\",\n \"400 km\"\n ]\n },\n \"sortBy\": {\n \"title\": \"Sort by\",\n \"type\": \"string\",\n \"description\": \"Result order.\",\n \"editor\": \"select\",\n \"enum\": [\n \"standard\",\n \"price-asc\",\n \"price-desc\",\n \"mileage-asc\",\n \"mileage-desc\",\n \"year-desc\",\n \"year-asc\",\n \"power-desc\",\n \"newest\",\n \"distance\"\n ],\n \"enumTitles\": [\n \"Best match\",\n \"Price: low to high\",\n \"Price: high to low\",\n \"Mileage: low to high\",\n \"Mileage: high to low\",\n \"First registration: newest first\",\n \"First registration: oldest first\",\n \"Power: highest first\",\n \"Newest listings first\",\n \"Distance (requires ZIP code)\"\n ],\n \"default\": \"standard\",\n \"prefill\": \"standard\"\n },\n \"onlineSinceDays\": {\n \"title\": \"Online since (days)\",\n \"type\": \"integer\",\n \"description\": \"Only listings published within this many days. 0 means any age.\",\n \"editor\": \"number\",\n \"minimum\": 0,\n \"maximum\": 14,\n \"default\": 0\n },\n \"previousOwnersMax\": {\n \"title\": \"Maximum previous owners\",\n \"type\": \"string\",\n \"description\": \"Filter by the number of previous owners.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"1\",\n \"2\",\n \"3\",\n \"4\"\n ],\n \"enumTitles\": [\n \"Any\",\n \"1 owner\",\n \"Up to 2 owners\",\n \"Up to 3 owners\",\n \"4 or more owners\"\n ]\n },\n \"damagedListings\": {\n \"title\": \"Damaged vehicles\",\n \"type\": \"string\",\n \"description\": \"Whether to include listings marked as damaged.\",\n \"editor\": \"select\",\n \"enum\": [\n \"exclude\",\n \"include\",\n \"only\"\n ],\n \"enumTitles\": [\n \"Exclude damaged vehicles\",\n \"Include damaged vehicles\",\n \"Only damaged vehicles\"\n ],\n \"default\": \"exclude\",\n \"prefill\": \"exclude\"\n },\n \"includeDetails\": {\n \"title\": \"Fetch full vehicle details\",\n \"type\": \"boolean\",\n \"description\": \"Open each listing's detail page for specifications, equipment, description and high-resolution photos. Turn off for a faster, cheaper listing-only run.\",\n \"default\": true,\n \"prefill\": false\n },\n \"includeDealerContact\": {\n \"title\": \"Fetch dealer contact details\",\n \"type\": \"boolean\",\n \"description\": \"Look up each dealer's public profile for email, website, opening hours and ratings. Phone numbers are already included from the listing.\",\n \"default\": true,\n \"prefill\": false\n },\n \"maxResults\": {\n \"title\": \"Maximum results\",\n \"type\": \"integer\",\n \"description\": \"Maximum listings to save. 0 means the site cap (4,000 per search query).\",\n \"editor\": \"number\",\n \"minimum\": 0,\n \"maximum\": 10000,\n \"default\": 100,\n \"prefill\": 3\n },\n \"startUrls\": {\n \"title\": \"Start URLs\",\n \"type\": \"array\",\n \"description\": \"URLs for mode=byUrl (search URLs), mode=details (listing URLs) or mode=dealer (dealer profile URLs).\",\n \"editor\": \"requestListSources\",\n \"prefill\": []\n },\n \"listingIds\": {\n \"title\": \"Listing IDs\",\n \"type\": \"array\",\n \"description\": \"AutoScout24 listing UUIDs or listing URLs (mode=details). UUIDs use the selected Country; paste a full listing URL to pick the market automatically.\",\n \"editor\": \"stringList\",\n \"prefill\": []\n }\n },\n \"required\": [\n \"mode\"\n ]\n}", "readme": "# AutoScout24 Vehicle Listings with Dealer Contact Details\n\nCollect 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.\n\n## What this actor does\n\n- Searches eight AutoScout24 country sites and the English `autoscout24.com` marketplace.\n- 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.\n- Walks the result pages up to the source cap and de-duplicates listings by their AutoScout24 ID.\n- Opens each listing's detail page on request for the full specification sheet, equipment list, description, price evaluation and 1280x960 photos.\n- 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.\n- Scrapes a dealer's live inventory for the selected vehicle type from a dealer profile URL.\n- Omits fields the source does not publish; every record contains only real, non-empty values.\n\n## Markets\n\n| Value | Site |\n|---|---|\n| `de` | autoscout24.de |\n| `at` | autoscout24.at |\n| `be-nl` / `be-fr` | autoscout24.be (Dutch / French) |\n| `es` | autoscout24.es |\n| `fr` | autoscout24.fr |\n| `it` | autoscout24.it |\n| `lu` | autoscout24.lu |\n| `nl` | autoscout24.nl |\n| `com` | autoscout24.com (English pan-European feed) |\n| `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 |\n\n## Output per listing\n\n| Group | Fields |\n|---|---|\n| Listing | `platform`, `listingId`, `url`, `title`, `subtitle`, `description`, `descriptionHtml`, `status`, `createdAt`, `lastModifiedAt` |\n| 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` |\n| 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` |\n| Specifications | `specifications.powerKw`, `powerHp`, `power`, `fuelType`, `fuelCode`, `transmission`, `transmissionCode`, `driveType`, `consumptionL100km`, `consumption`, `co2Emissions`, `emission`, `electricRangeKm`, `batteryCapacityKwh` |\n| Equipment | `features` (flat list), `equipment` (grouped by comfort, entertainment, safety and extras) |\n| 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` |\n| Location | `location.country`, `city`, `zip`, `street`, `region`, `latitude`, `longitude`, `coordinates` |\n| Media | `images`, `thumbnail`, `imageCount`, `has360`, `videoUrl`, `whatsappNumber` |\n| Meta | `meta.scrapedAt`, `meta.country`, `meta.marketplace`, `meta.language`, `meta.source`, `meta.crawlId`, `meta.promoted`, `meta.searchPosition`, `meta.deliveryAvailable` |\n\nFields are nested for readability. Empty values are omitted rather than emitted as `null`.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | select | `search` | `search`, `details`, `dealer` or `byUrl` |\n| `searchQuery` | text | – | Free-text search |\n| `make` / `model` | text | – | AutoScout24 make and model slugs, e.g. `bmw`, `3er` |\n| `vehicleType` | select | `car` | Cars, motorcycles, caravans or transporters |\n| `country` | select | `de` | One market, `com`, or `all` |\n| `priceMin` / `priceMax` | number | – | Price range in EUR |\n| `yearMin` / `yearMax` | number | – | First-registration year range |\n| `mileageMin` / `mileageMax` | number | – | Mileage range in km |\n| `powerMin` / `powerMax` | number | – | Power range in kW |\n| `fuelType` | select | – | Petrol, diesel, electric, plug-in hybrids, CNG, LPG, ethanol, hydrogen, other |\n| `transmission` | select | – | Manual, automatic or semi-automatic |\n| `sellerType` | select | – | Dealer or private seller |\n| `bodyType` | select | – | Small car, convertible, coupe, SUV, estate, sedan, van, transporter, other |\n| `color` | select | – | Exterior colour |\n| `driveTrain` | select | – | All-wheel, front-wheel or rear-wheel drive |\n| `zipCode` / `radius` | text / select | – | Search around a postal code |\n| `sortBy` | select | `standard` | Price, mileage, registration year, power, newest or distance |\n| `onlineSinceDays` | number | `0` | Only listings published within N days; 0 = any |\n| `previousOwnersMax` | select | – | 1, 2, 3 or 4+ previous owners |\n| `damagedListings` | select | `exclude` | Exclude, include or only damaged vehicles |\n| `includeDetails` | boolean | `true` | Open every listing's detail page |\n| `includeDealerContact` | boolean | `true` | Add the dealer's public profile details |\n| `maxResults` | number | `100` | Row cap; 0 means the 4,000-row source cap for the run (shared across markets and de-duplicated) |\n| `startUrls` | array | – | Search URLs (`byUrl`), listing URLs (`details`) or dealer URLs (`dealer`) |\n| `listingIds` | array | – | Listing UUIDs or listing URLs (`details`). UUIDs use the selected `country`; full URLs select their own market. |\n\n## Examples\n\nSearch in Germany:\n\n```json\n{\n \"mode\": \"search\",\n \"country\": \"de\",\n \"make\": \"bmw\",\n \"model\": \"3er\",\n \"priceMax\": 30000,\n \"yearMin\": 2019,\n \"fuelType\": \"diesel\",\n \"transmission\": \"automatic\",\n \"maxResults\": 50\n}\n```\n\nSearch all eight country sites:\n\n```json\n{\n \"mode\": \"search\",\n \"country\": \"all\",\n \"make\": \"volkswagen\",\n \"model\": \"golf\",\n \"maxResults\": 200\n}\n```\n\nOpen listing IDs:\n\n```json\n{\n \"mode\": \"details\",\n \"country\": \"de\",\n \"listingIds\": [\"dc39eaab-7f63-4b3b-b732-ae82f17ef805\"],\n \"includeDealerContact\": true\n}\n```\n\nScrape a dealer's inventory:\n\n```json\n{\n \"mode\": \"dealer\",\n \"startUrls\": [{\"url\": \"https://www.autoscout24.de/haendler/autohaus-next-car\"}],\n \"maxResults\": 100\n}\n```\n\nUse a saved search URL:\n\n```json\n{\n \"mode\": \"byUrl\",\n \"startUrls\": [{\"url\": \"https://www.autoscout24.it/lst/bmw?atype=C&fuel=D&sort=price&desc=0\"}],\n \"maxResults\": 100\n}\n```\n\n## Dealer contact coverage\n\nDealer 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.\n\n## Limits\n\n- 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.\n- Switzerland (`autoscout24.ch`) runs on a separate API and is not included; the eight country sites and `autoscout24.com` are covered.\n- Some specification fields (consumption, CO2, warranty, net price) are only shown when the seller provides them.\n- 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.\n- The actor is stateless: there is no only-new mode. Keep the `listingId` values from a previous run and compare them in your own pipeline.\n- `autoscout24.com` is an English pan-European feed and overlaps the country sites; use one or the other when de-duplicating yourself.\n\n## FAQ\n\n**Do I need an account, login or API key?**\nNo. The actor reads public pages and returns data without any credentials.\n\n**Which markets are covered?**\nGermany, Austria, Belgium (Dutch and French), Spain, France, Italy, Luxembourg, the Netherlands and the English `autoscout24.com` feed.\n\n**What is the difference between `includeDetails` on and off?**\nWith 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.\n\n**How do I scrape a dealer's inventory?**\nUse `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.\n\n**Can I use listing IDs instead of URLs?**\nYes. Put the AutoScout24 UUIDs in `listingIds` with `mode: \"details\"`.\n\n**Why are some dealer fields missing?**\nEmail, website, opening hours and VAT details are optional on AutoScout24. They are included only when the dealer publishes them.\n\n**Why do I get fewer rows than `maxResults`?**\nThe 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.\n\n**Is this affiliated with AutoScout24?**\nNo. This actor reads public pages and is not affiliated with, endorsed by or sponsored by AutoScout24.\n", "actorDefinition": { "actorSpecification": 1, "name": "autoscout24-vehicle-listings-with-dealer-contact", "title": "AutoScout24 Vehicle Listings with Dealer Contact Details", "description": "Search AutoScout24 across eight European countries and the English EU site for vehicle specs, equipment, photos and public dealer contact details — phone, email, website and opening hours.", "version": "1.0", "buildTag": "latest", "defaultRunOptions": { "build": "latest", "timeoutSecs": 3600, "memoryMbytes": 1024 }, "input": { "title": "AutoScout24 Scraper Input", "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.", "type": "object", "schemaVersion": 1, "properties": { "mode": { "title": "Mode", "type": "string", "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" ], "default": "search", "prefill": "search" }, "searchQuery": { "title": "Search text", "type": "string", "description": "Free-text search, e.g. \"BMW 320 Touring\" (mode=search).", "editor": "textfield" }, "make": { "title": "Make", "type": "string", "description": "Vehicle make, e.g. bmw, audi, mercedes-benz, volkswagen (mode=search).", "editor": "textfield", "prefill": "bmw", "example": "bmw" }, "model": { "title": "Model", "type": "string", "description": "Model as AutoScout24 spells it, e.g. 3er, a4, c-klasse, golf (mode=search).", "editor": "textfield", "example": "3er" }, "vehicleType": { "title": "Vehicle type", "type": "string", "description": "Which vehicle category to search (mode=search).", "editor": "select", "enum": [ "car", "motorcycle", "caravan", "transporter" ], "enumTitles": [ "Cars", "Motorcycles", "Caravans", "Transporters" ], "default": "car", "prefill": "car" }, "country": { "title": "Country", "type": "string", "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" ], "default": "de", "prefill": "de" }, "priceMin": { "title": "Minimum price", "type": "integer", "description": "Lowest asking price in EUR.", "editor": "number", "minimum": 0 }, "priceMax": { "title": "Maximum price", "type": "integer", "description": "Highest asking price in EUR.", "editor": "number", "minimum": 0 }, "yearMin": { "title": "First registration from", "type": "integer", "description": "Earliest first-registration year.", "editor": "number", "minimum": 1900, "maximum": 2030 }, "yearMax": { "title": "First registration to", "type": "integer", "description": "Latest first-registration year.", "editor": "number", "minimum": 1900, "maximum": 2030 }, "mileageMin": { "title": "Minimum mileage (km)", "type": "integer", "description": "Lowest mileage in kilometres.", "editor": "number", "minimum": 0 }, "mileageMax": { "title": "Maximum mileage (km)", "type": "integer", "description": "Highest mileage in kilometres.", "editor": "number", "minimum": 0 }, "powerMin": { "title": "Minimum power (kW)", "type": "integer", "description": "Lowest engine power in kilowatts.", "editor": "number", "minimum": 0, "maximum": 2000 }, "powerMax": { "title": "Maximum power (kW)", "type": "integer", "description": "Highest engine power in kilowatts.", "editor": "number", "minimum": 0, "maximum": 2000 }, "fuelType": { "title": "Fuel type", "type": "string", "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" ] }, "transmission": { "title": "Transmission", "type": "string", "description": "Gearbox type.", "editor": "select", "enum": [ "", "manual", "automatic", "semi-automatic" ], "enumTitles": [ "Any", "Manual", "Automatic", "Semi-automatic" ] }, "sellerType": { "title": "Seller type", "type": "string", "description": "Dealer or private seller.", "editor": "select", "enum": [ "", "dealer", "private" ], "enumTitles": [ "Any", "Dealer", "Private seller" ] }, "bodyType": { "title": "Body type", "type": "string", "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" ] }, "color": { "title": "Exterior colour", "type": "string", "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" ] }, "driveTrain": { "title": "Drive train", "type": "string", "description": "Driven wheels.", "editor": "select", "enum": [ "", "awd", "front", "rear" ], "enumTitles": [ "Any", "All-wheel drive", "Front-wheel drive", "Rear-wheel drive" ] }, "zipCode": { "title": "ZIP / postal code", "type": "string", "description": "Search around this postal code. Combine with the radius.", "editor": "textfield", "example": "80331" }, "radius": { "title": "Radius around ZIP", "type": "string", "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" ] }, "sortBy": { "title": "Sort by", "type": "string", "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)" ], "default": "standard", "prefill": "standard" }, "onlineSinceDays": { "title": "Online since (days)", "type": "integer", "description": "Only listings published within this many days. 0 means any age.", "editor": "number", "minimum": 0, "maximum": 14, "default": 0 }, "previousOwnersMax": { "title": "Maximum previous owners", "type": "string", "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" ] }, "damagedListings": { "title": "Damaged vehicles", "type": "string", "description": "Whether to include listings marked as damaged.", "editor": "select", "enum": [ "exclude", "include", "only" ], "enumTitles": [ "Exclude damaged vehicles", "Include damaged vehicles", "Only damaged vehicles" ], "default": "exclude", "prefill": "exclude" }, "includeDetails": { "title": "Fetch full vehicle details", "type": "boolean", "description": "Open each listing's detail page for specifications, equipment, description and high-resolution photos. Turn off for a faster, cheaper listing-only run.", "default": true, "prefill": false }, "includeDealerContact": { "title": "Fetch dealer contact details", "type": "boolean", "description": "Look up each dealer's public profile for email, website, opening hours and ratings. Phone numbers are already included from the listing.", "default": true, "prefill": false }, "maxResults": { "title": "Maximum results", "type": "integer", "description": "Maximum listings to save. 0 means the site cap (4,000 per search query).", "editor": "number", "minimum": 0, "maximum": 10000, "default": 100, "prefill": 3 }, "startUrls": { "title": "Start URLs", "type": "array", "description": "URLs for mode=byUrl (search URLs), mode=details (listing URLs) or mode=dealer (dealer profile URLs).", "editor": "requestListSources", "prefill": [] }, "listingIds": { "title": "Listing IDs", "type": "array", "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": [] } }, "required": [ "mode" ] }, "output": { "actorOutputSchemaVersion": 1, "title": "AutoScout24 Vehicle Listings with Dealer Contact Details Output", "description": "AutoScout24 vehicle listings with price, specifications, equipment, photos, seller and public dealer contact details.", "properties": { "listings": { "type": "string", "title": "AutoScout24 vehicle listings", "description": "Dataset containing all scraped AutoScout24 vehicle listings.", "template": "{{links.apiDefaultDatasetUrl}}/items" } } }, "readme": "# AutoScout24 Vehicle Listings with Dealer Contact Details\n\nCollect 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.\n\n## What this actor does\n\n- Searches eight AutoScout24 country sites and the English `autoscout24.com` marketplace.\n- 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.\n- Walks the result pages up to the source cap and de-duplicates listings by their AutoScout24 ID.\n- Opens each listing's detail page on request for the full specification sheet, equipment list, description, price evaluation and 1280x960 photos.\n- 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.\n- Scrapes a dealer's live inventory for the selected vehicle type from a dealer profile URL.\n- Omits fields the source does not publish; every record contains only real, non-empty values.\n\n## Markets\n\n| Value | Site |\n|---|---|\n| `de` | autoscout24.de |\n| `at` | autoscout24.at |\n| `be-nl` / `be-fr` | autoscout24.be (Dutch / French) |\n| `es` | autoscout24.es |\n| `fr` | autoscout24.fr |\n| `it` | autoscout24.it |\n| `lu` | autoscout24.lu |\n| `nl` | autoscout24.nl |\n| `com` | autoscout24.com (English pan-European feed) |\n| `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 |\n\n## Output per listing\n\n| Group | Fields |\n|---|---|\n| Listing | `platform`, `listingId`, `url`, `title`, `subtitle`, `description`, `descriptionHtml`, `status`, `createdAt`, `lastModifiedAt` |\n| 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` |\n| 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` |\n| Specifications | `specifications.powerKw`, `powerHp`, `power`, `fuelType`, `fuelCode`, `transmission`, `transmissionCode`, `driveType`, `consumptionL100km`, `consumption`, `co2Emissions`, `emission`, `electricRangeKm`, `batteryCapacityKwh` |\n| Equipment | `features` (flat list), `equipment` (grouped by comfort, entertainment, safety and extras) |\n| 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` |\n| Location | `location.country`, `city`, `zip`, `street`, `region`, `latitude`, `longitude`, `coordinates` |\n| Media | `images`, `thumbnail`, `imageCount`, `has360`, `videoUrl`, `whatsappNumber` |\n| Meta | `meta.scrapedAt`, `meta.country`, `meta.marketplace`, `meta.language`, `meta.source`, `meta.crawlId`, `meta.promoted`, `meta.searchPosition`, `meta.deliveryAvailable` |\n\nFields are nested for readability. Empty values are omitted rather than emitted as `null`.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | select | `search` | `search`, `details`, `dealer` or `byUrl` |\n| `searchQuery` | text | – | Free-text search |\n| `make` / `model` | text | – | AutoScout24 make and model slugs, e.g. `bmw`, `3er` |\n| `vehicleType` | select | `car` | Cars, motorcycles, caravans or transporters |\n| `country` | select | `de` | One market, `com`, or `all` |\n| `priceMin` / `priceMax` | number | – | Price range in EUR |\n| `yearMin` / `yearMax` | number | – | First-registration year range |\n| `mileageMin` / `mileageMax` | number | – | Mileage range in km |\n| `powerMin` / `powerMax` | number | – | Power range in kW |\n| `fuelType` | select | – | Petrol, diesel, electric, plug-in hybrids, CNG, LPG, ethanol, hydrogen, other |\n| `transmission` | select | – | Manual, automatic or semi-automatic |\n| `sellerType` | select | – | Dealer or private seller |\n| `bodyType` | select | – | Small car, convertible, coupe, SUV, estate, sedan, van, transporter, other |\n| `color` | select | – | Exterior colour |\n| `driveTrain` | select | – | All-wheel, front-wheel or rear-wheel drive |\n| `zipCode` / `radius` | text / select | – | Search around a postal code |\n| `sortBy` | select | `standard` | Price, mileage, registration year, power, newest or distance |\n| `onlineSinceDays` | number | `0` | Only listings published within N days; 0 = any |\n| `previousOwnersMax` | select | – | 1, 2, 3 or 4+ previous owners |\n| `damagedListings` | select | `exclude` | Exclude, include or only damaged vehicles |\n| `includeDetails` | boolean | `true` | Open every listing's detail page |\n| `includeDealerContact` | boolean | `true` | Add the dealer's public profile details |\n| `maxResults` | number | `100` | Row cap; 0 means the 4,000-row source cap for the run (shared across markets and de-duplicated) |\n| `startUrls` | array | – | Search URLs (`byUrl`), listing URLs (`details`) or dealer URLs (`dealer`) |\n| `listingIds` | array | – | Listing UUIDs or listing URLs (`details`). UUIDs use the selected `country`; full URLs select their own market. |\n\n## Examples\n\nSearch in Germany:\n\n```json\n{\n \"mode\": \"search\",\n \"country\": \"de\",\n \"make\": \"bmw\",\n \"model\": \"3er\",\n \"priceMax\": 30000,\n \"yearMin\": 2019,\n \"fuelType\": \"diesel\",\n \"transmission\": \"automatic\",\n \"maxResults\": 50\n}\n```\n\nSearch all eight country sites:\n\n```json\n{\n \"mode\": \"search\",\n \"country\": \"all\",\n \"make\": \"volkswagen\",\n \"model\": \"golf\",\n \"maxResults\": 200\n}\n```\n\nOpen listing IDs:\n\n```json\n{\n \"mode\": \"details\",\n \"country\": \"de\",\n \"listingIds\": [\"dc39eaab-7f63-4b3b-b732-ae82f17ef805\"],\n \"includeDealerContact\": true\n}\n```\n\nScrape a dealer's inventory:\n\n```json\n{\n \"mode\": \"dealer\",\n \"startUrls\": [{\"url\": \"https://www.autoscout24.de/haendler/autohaus-next-car\"}],\n \"maxResults\": 100\n}\n```\n\nUse a saved search URL:\n\n```json\n{\n \"mode\": \"byUrl\",\n \"startUrls\": [{\"url\": \"https://www.autoscout24.it/lst/bmw?atype=C&fuel=D&sort=price&desc=0\"}],\n \"maxResults\": 100\n}\n```\n\n## Dealer contact coverage\n\nDealer 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.\n\n## Limits\n\n- 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.\n- Switzerland (`autoscout24.ch`) runs on a separate API and is not included; the eight country sites and `autoscout24.com` are covered.\n- Some specification fields (consumption, CO2, warranty, net price) are only shown when the seller provides them.\n- 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.\n- The actor is stateless: there is no only-new mode. Keep the `listingId` values from a previous run and compare them in your own pipeline.\n- `autoscout24.com` is an English pan-European feed and overlaps the country sites; use one or the other when de-duplicating yourself.\n\n## FAQ\n\n**Do I need an account, login or API key?**\nNo. The actor reads public pages and returns data without any credentials.\n\n**Which markets are covered?**\nGermany, Austria, Belgium (Dutch and French), Spain, France, Italy, Luxembourg, the Netherlands and the English `autoscout24.com` feed.\n\n**What is the difference between `includeDetails` on and off?**\nWith 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.\n\n**How do I scrape a dealer's inventory?**\nUse `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.\n\n**Can I use listing IDs instead of URLs?**\nYes. Put the AutoScout24 UUIDs in `listingIds` with `mode: \"details\"`.\n\n**Why are some dealer fields missing?**\nEmail, website, opening hours and VAT details are optional on AutoScout24. They are included only when the dealer publishes them.\n\n**Why do I get fewer rows than `maxResults`?**\nThe 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.\n\n**Is this affiliated with AutoScout24?**\nNo. This actor reads public pages and is not affiliated with, endorsed by or sponsored by AutoScout24.\n", "dockerfile": "../Dockerfile", "storages": { "dataset": { "actorSpecification": 1, "title": "AutoScout24 Listings", "views": { "overview": { "title": "Overview", "transformation": { "fields": [ "listingId", "title", "price.amount", "price.currency", "vehicle.year", "vehicle.mileage", "specifications.fuelType", "seller.name", "location.city", "url" ] }, "display": { "component": "table", "properties": { "listingId": { "label": "ID", "format": "text" }, "title": { "label": "Title", "format": "text" }, "price.amount": { "label": "Price", "format": "number" }, "vehicle.year": { "label": "Year", "format": "number" }, "vehicle.mileage": { "label": "Mileage", "format": "number" } } } } } } } }, "buildNumber": "1.0.4", "imageDigest": "07d6decbdebe4f7f60189f85a3e96b33ef7056b06462e422cce6f2fccd529399", "actVersion": { "sourceType": "SOURCE_FILES", "buildTag": "latest", "versionNumber": "1.0" }, "usage": { "ACTOR_COMPUTE_UNITS": 0.003501111111111111 } } }