{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Scraper - Used Car Listings, Prices & Specs", "description": "Used-car listings from AutoScout24 in eight countries: price, mileage, first registration, fuel, gearbox, power, town, dealer or private seller, dealer name, link and photos. Search by make and model or paste a search link.", "version": "0.1", "x-build-id": "neQS3YINBpXja8AFc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~autoscout24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-autoscout24-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/dami_studio~autoscout24-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-autoscout24-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/dami_studio~autoscout24-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-autoscout24-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "make": { "title": "Make", "type": "string", "description": "The make the way AutoScout24 spells it: BMW, Volkswagen, Mercedes-Benz, Alfa Romeo. Leave it empty if you only use search links below." }, "model": { "title": "Model", "type": "string", "description": "Optional. The model in English, as autoscout24.com names it: 3 Series, Golf, C-Class, Model 3. If the site doesn't know the name, the run returns nothing, charges nothing, and lists the model names it does know in RUN_REPORT." }, "keyword": { "title": "Words in the title", "type": "string", "description": "Optional. A word or two the listing title has to contain, like the site's Model version box: 320d, Touring, M Sport." }, "country": { "title": "Country", "enum": [ "all", "DE", "AT", "BE", "ES", "FR", "IT", "LU", "NL" ], "type": "string", "description": "Where the car is for sale.", "default": "all" }, "condition": { "title": "New or used", "enum": [ "any", "used", "new" ], "type": "string", "description": "As the seller listed the car. Employee's cars, classics, demonstration and pre-registered cars are all used cars here; Offer type below picks them out.", "default": "any" }, "priceFrom": { "title": "Price from (EUR)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Lowest asking price, in euros." }, "priceTo": { "title": "Price to (EUR)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Highest asking price, in euros." }, "yearFrom": { "title": "First registration from (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Earliest year the car was first registered." }, "yearTo": { "title": "First registration to (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Latest year the car was first registered." }, "mileageFrom": { "title": "Mileage from (km)", "minimum": 0, "maximum": 2000000, "type": "integer", "description": "Lowest mileage, in kilometres." }, "mileageTo": { "title": "Mileage up to (km)", "minimum": 0, "maximum": 2000000, "type": "integer", "description": "Highest mileage, in kilometres." }, "fuel": { "title": "Fuel", "enum": [ "any", "B", "D", "E", "2", "3", "L", "C", "H", "M", "O" ], "type": "string", "description": "Hybrids are listed under their own two entries.", "default": "any" }, "transmission": { "title": "Gearbox", "enum": [ "any", "A", "M", "S" ], "type": "string", "description": "Automatic, manual or semi-automatic.", "default": "any" }, "sellerType": { "title": "Seller", "enum": [ "any", "dealer", "private" ], "type": "string", "description": "Dealers, private sellers, or both.", "default": "any" }, "sort": { "title": "Order", "enum": [ "newest", "standard", "price-asc", "price-desc", "mileage-asc", "mileage-desc", "power-asc", "power-desc", "year-asc", "year-desc", "nearest" ], "type": "string", "description": "The order listings are read in. With a limit below the number of listings, this decides which ones you get.", "default": "newest" }, "searchUrls": { "title": "Search links", "maxItems": 10, "type": "array", "description": "Or paste up to 10 results pages from any AutoScout24 country site (autoscout24.de, .com, .at, .it, .fr, .es, .nl, .be, .lu), with the filters you set there. Each link needs a make in it. The form fields don't apply to links.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 40000, "type": "integer", "description": "The most listings returned in one run, across all searches. Each one returned is charged. Repeats are skipped and not counted.", "default": 1000 }, "location": { "title": "Postcode or town", "type": "string", "description": "A postcode is the surest. A town name is read AutoScout24's way: \"Munich\" once came back as Münichham, a village about 85 km east. The status and RUN_REPORT say which place was searched. With all eight countries picked, the site can't place it, so the run asks for one country." }, "radiusKm": { "title": "Radius", "enum": [ "10", "20", "50", "100", "150", "200", "250", "300", "400" ], "type": "string", "description": "How far from the place. Left empty, AutoScout24 uses 200 km." }, "offerTypes": { "title": "Offer type", "uniqueItems": true, "type": "array", "description": "Pick one or more; empty means all of them. The rows still say Used for employee's cars, classics, demonstration and pre-registered cars, because that's how the results page lists them.", "items": { "type": "string", "enum": [ "new", "used", "employees-car", "classic", "demonstration", "pre-registered" ], "enumTitles": [ "New", "Used", "Employee's car", "Antique / classic", "Demonstration", "Pre-registered" ] } }, "accidentVehicles": { "title": "Accident vehicles", "enum": [ "hide", "include", "only" ], "type": "string", "description": "Cars the seller lists as having had an accident. AutoScout24 leaves them out unless you ask.", "default": "hide" }, "maxPreviousOwners": { "title": "Previous owners, at most", "enum": [ "1", "2", "3" ], "type": "string", "description": "Once this is set, cars whose listing doesn't say how many owners they had are left out too." }, "warranty": { "title": "With a warranty", "type": "boolean", "description": "Only cars sold with a warranty." }, "fullServiceHistory": { "title": "Full service history", "type": "boolean", "description": "Only cars listed with a full service history." }, "nonSmoking": { "title": "Non-smoking car", "type": "boolean", "description": "Only cars listed as non-smoking." }, "newInspection": { "title": "Fresh German inspection (HU/AU)", "type": "boolean", "description": "Cars that have just passed the German roadworthiness and emissions test, the site's \"HU/AU new\"." }, "powerFrom": { "title": "Power from", "minimum": 0, "maximum": 2000, "type": "integer", "description": "In the unit picked below." }, "powerTo": { "title": "Power to", "minimum": 0, "maximum": 2000, "type": "integer", "description": "In the unit picked below." }, "powerUnit": { "title": "Power unit", "enum": [ "kw", "hp" ], "type": "string", "description": "Kilowatts or horsepower, for the two fields above.", "default": "kw" }, "electricRangeFrom": { "title": "Electric range from (km)", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Only electric cars and plug-in hybrids have one, so this leaves everything else out." }, "electricRangeTo": { "title": "Electric range to (km)", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Highest electric range, in kilometres." }, "bodyTypes": { "title": "Body type", "uniqueItems": true, "type": "array", "description": "Pick one or more; empty means all of them.", "items": { "type": "string", "enum": [ "compact", "convertible", "coupe", "suv", "station-wagon", "sedan", "van", "transporter", "other" ], "enumTitles": [ "Compact", "Convertible", "Coupe", "SUV / off-road / pick-up", "Station wagon", "Sedan", "Van", "Transporter", "Other" ] } }, "seatsFrom": { "title": "Seats from", "minimum": 1, "maximum": 12, "type": "integer", "description": "Fewest seats." }, "seatsTo": { "title": "Seats to", "minimum": 1, "maximum": 12, "type": "integer", "description": "Most seats." }, "doorsFrom": { "title": "Doors from", "minimum": 2, "maximum": 7, "type": "integer", "description": "The site's own buttons are 2/3, 4/5 and 6/7: from 4 to 5 is its 4/5." }, "doorsTo": { "title": "Doors to", "minimum": 2, "maximum": 7, "type": "integer", "description": "Most doors." }, "colors": { "title": "Colour", "uniqueItems": true, "type": "array", "description": "Pick one or more; empty means any colour.", "items": { "type": "string", "enum": [ "beige", "blue", "brown", "bronze", "yellow", "grey", "green", "red", "black", "silver", "violet", "white", "orange", "gold" ], "enumTitles": [ "Beige", "Blue", "Brown", "Bronze", "Yellow", "Grey", "Green", "Red", "Black", "Silver", "Violet", "White", "Orange", "Gold" ] } }, "metallic": { "title": "Metallic paint only", "type": "boolean", "description": "Only cars listed with metallic paint." }, "interiorColors": { "title": "Interior colour", "uniqueItems": true, "type": "array", "description": "Pick one or more; empty means any.", "items": { "type": "string", "enum": [ "beige", "black", "grey", "brown", "blue", "red", "green", "yellow", "orange", "white", "other" ], "enumTitles": [ "Beige", "Black", "Grey", "Brown", "Blue", "Red", "Green", "Yellow", "Orange", "White", "Other" ] } }, "upholstery": { "title": "Upholstery", "uniqueItems": true, "type": "array", "description": "Pick one or more; empty means any.", "items": { "type": "string", "enum": [ "alcantara", "cloth", "full-leather", "part-leather", "velour", "other" ], "enumTitles": [ "Alcantara", "Cloth", "Full leather", "Part leather", "Velour", "Other" ] } }, "emissionClass": { "title": "Euro emission class, at least", "enum": [ "euro-1", "euro-2", "euro-3", "euro-4", "euro-5", "euro-6", "euro-6b", "euro-6c", "euro-6d", "euro-6d-temp", "euro-6e" ], "type": "string", "description": "Euro 6 also brings Euro 6b, 6c, 6d and 6e cars, the way the site's own filter works." }, "emissionSticker": { "title": "German emission sticker, at least", "enum": [ "red", "yellow", "green", "blue" ], "type": "string", "description": "The Umweltplakette. Blue found no cars at all in our tests." }, "particulateFilter": { "title": "Particulate filter", "type": "boolean", "description": "Only cars listed with a particulate filter." }, "equipment": { "title": "Equipment", "uniqueItems": true, "type": "array", "description": "Every item you pick has to be on the car, as on the site. The list is AutoScout24's own.", "items": { "type": "string", "enum": [ "360-camera", "4wd", "abs", "adaptive-cruise-control", "adaptive-headlights", "air-conditioning", "air-suspension", "alarm-system", "all-season-tyres", "alloy-wheels", "ambient-lighting", "android-auto", "apple-carplay", "armrest", "automatic-climate-control", "automatic-climate-control-2-zones", "automatic-climate-control-3-zones", "automatic-climate-control-4-zones", "automatically-dimming-interior-mirror", "auxiliary-heating", "awning", "battery-certificate", "bi-xenon-headlights", "bidirectional-charging", "biodiesel-conversion", "blind-spot-monitor", "bluetooth", "cab-or-rented-car", "cargo-barrier", "catalytic-converter", "cd-player", "central-door-lock", "central-door-lock-with-remote-control", "cruise-control", "daytime-running-lights", "digital-cockpit", "digital-radio", "disabled-accessible", "distance-warning-system", "driver-drowsiness-detection", "driver-side-airbag", "e10-enabled", "electric-backseat-adjustment", "electric-tailgate", "electrical-side-mirrors", "electrically-adjustable-seats", "electrically-heated-windshield", "electronic-parking-brake", "electronic-stability-control", "emergency-brake-assistant", "emergency-system", "emergency-tyre", "emergency-tyre-repair-kit", "fog-lights", "fold-flat-passenger-seat", "full-led-headlights", "glare-free-high-beam-headlights", "hands-free-equipment", "head-airbag", "headlight-washer-system", "heads-up-display", "heat-pump", "heated-steering-wheel", "high-beam-assist", "hill-holder", "immobilizer", "induction-charging-for-smartphones", "integrated-music-streaming", "isofix", "keyless-central-door-lock", "lane-departure-warning-system", "laser-headlights", "leather-seats", "leather-steering-wheel", "led-daytime-running-lights", "led-headlights", "light-sensor", "lumbar-support", "massage-seats", "mp3", "multi-function-steering-wheel", "navigation-system", "night-view-assist", "on-board-computer", "panorama-roof", "park-distance-control", "parking-assist-system-camera", "parking-assist-system-self-steering", "parking-assist-system-sensors-front", "parking-assist-system-sensors-rear", "passenger-side-airbag", "power-steering", "power-windows", "radio", "rain-sensor", "range-extender", "rear-airbag", "rear-seat-heating", "right-hand-drive", "roof-rack", "seat-heating", "seat-ventilation", "shift-paddles", "side-airbag", "ski-bag", "sliding-door", "sliding-door-left", "sliding-door-right", "smoker-s-package", "sound-system", "spare-tyre", "speed-limit-control-system", "split-rear-seats", "spoiler", "sport-package", "sport-seats", "sport-suspension", "start-stop-system", "steel-wheels", "summer-tyres", "sunroof", "television", "tinted-windows", "tire-pressure-monitoring-system", "touch-screen", "traction-control", "traffic-sign-recognition", "trailer-hitch", "tuned-car", "usb", "voice-control", "wind-deflector", "winter-package", "winter-tyres", "wlan-wifi-hotspot", "xenon-headlights" ], "enumTitles": [ "360° camera", "4WD", "ABS", "Adaptive Cruise Control", "Adaptive headlights", "Air conditioning", "Air suspension", "Alarm system", "All season tyres", "Alloy wheels", "Ambient lighting", "Android Auto", "Apple CarPlay", "Armrest", "Automatic climate control", "Automatic climate control, 2 zones", "Automatic climate control, 3 zones", "Automatic climate control, 4 zones", "Automatically dimming interior mirror", "Auxiliary heating", "Awning", "Battery certificate", "Bi-Xenon headlights", "Bidirectional Charging", "Biodiesel conversion", "Blind spot monitor", "Bluetooth", "Cab or rented Car", "Cargo barrier", "Catalytic Converter", "CD player", "Central door lock", "Central door lock with remote control", "Cruise control", "Daytime running lights", "Digital cockpit", "Digital radio", "Disabled accessible", "Distance warning system", "Driver drowsiness detection", "Driver-side airbag", "E10-enabled", "Electric backseat adjustment", "Electric tailgate", "Electrical side mirrors", "Electrically adjustable seats", "Electrically heated windshield", "Electronic parking brake", "Electronic stability control", "Emergency brake assistant", "Emergency system", "Emergency tyre", "Emergency tyre repair kit", "Fog lights", "Fold flat passenger seat", "Full-LED headlights", "Glare-free high beam headlights", "Hands-free equipment", "Head airbag", "Headlight washer system", "Heads-up display", "Heat Pump", "Heated steering wheel", "High beam assist", "Hill Holder", "Immobilizer", "Induction charging for smartphones", "Integrated music streaming", "Isofix", "Keyless central door lock", "Lane departure warning system", "Laser headlights", "Leather seats", "Leather steering wheel", "LED Daytime Running Lights", "LED Headlights", "Light sensor", "Lumbar support", "Massage seats", "MP3", "Multi-function steering wheel", "Navigation system", "Night view assist", "On-board computer", "Panorama roof", "Park Distance Control", "Parking assist system camera", "Parking assist system self-steering", "Parking assist system sensors front", "Parking assist system sensors rear", "Passenger-side airbag", "Power steering", "Power windows", "Radio", "Rain sensor", "Range extender", "Rear airbag", "Rear seat heating", "Right-hand drive", "Roof rack", "Seat heating", "Seat ventilation", "Shift paddles", "Side airbag", "Ski bag", "Sliding door", "Sliding door left", "Sliding door right", "Smoker's package", "Sound system", "Spare tyre", "Speed limit control system", "Split rear seats", "Spoiler", "Sport package", "Sport seats", "Sport suspension", "Start-stop system", "Steel wheels", "Summer tyres", "Sunroof", "Television", "Tinted windows", "Tire pressure monitoring system", "Touch screen", "Traction control", "Traffic sign recognition", "Trailer hitch", "Tuned car", "USB", "Voice Control", "Wind deflector", "Winter package", "Winter tyres", "WLAN / WiFi hotspot", "Xenon headlights" ] } }, "priceRatings": { "title": "Price rating", "uniqueItems": true, "type": "array", "description": "AutoScout24's own price badge. Pick one or more; empty means any. Once you pick one, cars the site hasn't rated are left out.", "items": { "type": "string", "enum": [ "top", "good", "fair", "somewhat-expensive", "expensive" ], "enumTitles": [ "Very good price", "Good price", "Fair price", "Above average price", "Expensive" ] } }, "vatDeductible": { "title": "VAT can be reclaimed", "type": "boolean", "description": "Cars sold with the VAT shown on the invoice, which a business buyer can reclaim. In practice these are dealers' cars." }, "onlineSince": { "title": "Listed in the last", "enum": [ "1", "2", "3", "4", "5", "6", "7", "14" ], "type": "string", "description": "Only listings that went up on AutoScout24 in that time." }, "financeRateFrom": { "title": "Monthly finance rate from (EUR)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "The monthly rate AutoScout24 lists for financing the car." }, "financeRateTo": { "title": "Monthly finance rate to (EUR)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Highest monthly finance rate, in euros." }, "leasingOnly": { "title": "Only cars with a leasing offer", "type": "boolean", "description": "The leasing fields below narrow the search to leasing offers on their own too." }, "leasingRateFrom": { "title": "Leasing rate from (EUR a month)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Lowest monthly leasing rate, in euros." }, "leasingRateTo": { "title": "Leasing rate to (EUR a month)", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Highest monthly leasing rate, in euros." }, "leasingMonthsFrom": { "title": "Leasing term from (months)", "minimum": 0, "maximum": 120, "type": "integer", "description": "Shortest leasing term, in months." }, "leasingMonthsTo": { "title": "Leasing term to (months)", "minimum": 0, "maximum": 120, "type": "integer", "description": "Longest leasing term, in months." }, "leasingMileageFrom": { "title": "Kilometres a year in the lease, at least", "minimum": 0, "maximum": 200000, "type": "integer", "description": "The fewest kilometres a year the lease has to include." }, "leasingAvailableNow": { "title": "Leasing car available now", "type": "boolean", "description": "Only leasing cars you can have straight away." }, "leasingTradeIn": { "title": "Leasing with a trade-in offer", "type": "boolean", "description": "The site's trade-in tick. It found no cars in our tests." }, "leasingEnvironmentBonus": { "title": "Leasing with the environmental bonus", "type": "boolean", "description": "The site's Umweltbonus tick. It found no cars in our tests." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }