{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Scraper — Cars, Bikes & Vans in 8 Countries", "description": "Scrape AutoScout24 in 8 countries: cars, bikes, vans and motorhomes, every site filter, price rating, price history, dealer data, price tracking. Export to JSON, CSV or Excel.", "version": "0.0", "x-build-id": "Fec85Hy2JTchJmeXQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nice_dev~autoscout24-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nice_dev-autoscout24-listings-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/nice_dev~autoscout24-listings-scraper/runs": { "post": { "operationId": "runs-sync-nice_dev-autoscout24-listings-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/nice_dev~autoscout24-listings-scraper/run-sync": { "post": { "operationId": "run-sync-nice_dev-autoscout24-listings-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": { "startUrls": { "title": "Start URLs", "maxItems": 1000, "type": "array", "description": "AutoScout24 links, pasted as they are in your browser, from any AutoScout24 site (.de .at .it .fr .es .nl .be .lu .com): a search (`https://www.autoscout24.de/lst/bmw/3er?atype=C&cy=D&fregfrom=2020…`, every filter set on the site is kept), a listing (`https://www.autoscout24.de/angebote/…-`) or a dealer page (`https://www.autoscout24.de/haendler/` = its cars, or the vehicle type of the link: ?atype=B = motorbikes). When this list is not empty, the search fields below (vehicle type, make, keywords, locations, countries) and the **Vehicle filters** are ignored: set them on AutoScout24 before copying the link. The Actor's own filters (dates, words to exclude, phone only), the caps and monitoring still apply. autoscout24.ch is a different platform and is not supported. Max 1 000 URLs.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "vehicleType": { "title": "Vehicle type", "enum": [ "C", "B", "X", "N", "L" ], "type": "string", "description": "The AutoScout24 section to search. Some filters below exist only for some vehicle types (a filter a section does not have is ignored by the site, and the run log says so).", "default": "C" }, "make": { "title": "Make", "maxLength": 100, "type": "string", "description": "Make as written on AutoScout24, e.g. `BMW`, `Volkswagen`, `Mercedes-Benz` (case and accents ignored) or its AutoScout24 id (`13`). An unknown make stops the run with the list of close names, instead of silently searching every make. Empty = all makes." }, "model": { "title": "Model", "maxLength": 100, "type": "string", "description": "Model of the make above, as on AutoScout24: a single model (`320`, `Golf`) or a model series (`3 Series` / `3er`, `A-Class` = all its models), or its AutoScout24 id. Needs **Make**. Empty = all models of the make." }, "modelVersion": { "title": "Version", "maxLength": 100, "type": "string", "description": "Words of the version searched by AutoScout24 with **Make** + **Model** (its « Version » field), e.g. `xDrive`, `GTI`, `Competition`. Needs **Make**. Empty = any version." }, "models": { "title": "More makes / models", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several make + model searches in one run, one per line: `BMW 3 Series`, `Audi A4`, `Tesla` (make alone = all its models); with **Make** filled, a line that starts with no make (`Golf`, `3 Series`) is a model of that make. Added to **Make** / **Model**; each line is a separate search (times each keyword and location below, max 500 searches); a listing found by several searches is saved once.", "default": [], "items": { "type": "string" } }, "query": { "title": "Search keyword", "maxLength": 200, "type": "string", "description": "Free text searched by AutoScout24 in the listing (title, description, equipment), e.g. `panorama`, `scheckheft`. Empty = no keyword." }, "searchQueries": { "title": "More search keywords", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several keywords in one run: one search per keyword (times each make / model and location). Added to **Search keyword**; listings found by several searches are saved once.", "default": [], "items": { "type": "string" } }, "countries": { "title": "Countries", "uniqueItems": true, "type": "array", "description": "Countries where the vehicles are offered: AutoScout24 covers 8 countries. Empty = all 8 countries.", "items": { "type": "string", "enum": [ "D", "A", "B", "E", "F", "I", "L", "NL" ], "enumTitles": [ "Germany", "Austria", "Belgium", "Spain", "France", "Italy", "Luxembourg", "Netherlands" ] }, "default": [] }, "location": { "title": "Location", "maxLength": 200, "type": "string", "description": "Centre of a radius search: a postcode (`80331`; a postcode needs exactly one **Country** ticked, the country it belongs to) or GPS coordinates `48.137,11.575` (any number of countries). Used with **Radius**. Empty = everywhere." }, "locations": { "title": "More locations", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several locations in one run: every search is run around every location (3 models × 4 locations = 12 searches, max 500). Added to **Location**. Same rule: a postcode needs exactly one **Country** ticked, GPS coordinates work with several.", "default": [], "items": { "type": "string" } }, "radiusKm": { "title": "Radius", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Distance around each location, in km.", "default": 50 }, "sellerIds": { "title": "Dealers / sellers", "maxItems": 500, "uniqueItems": true, "type": "array", "description": "Every vehicle of these sellers: the seller id this Actor returns (`sellerId`, e.g. `6189`) or a dealer page URL (`https://www.autoscout24.de/haendler/`). Each seller is one search; the filters below still apply.", "default": [], "items": { "type": "string" } }, "listingIds": { "title": "Listing IDs", "maxItems": 1000, "uniqueItems": true, "type": "array", "description": "Fetch these listings directly, by AutoScout24 id (`990bcad7-c393-49a2-ab60-18ef4850cc95`) or listing URL. Always added to the searches above; fetched 100 at a time.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max listings", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Maximum number of listings to save for the whole run (after deduplication and filters). 0 = no limit.", "default": 100 }, "maxItemsPerQuery": { "title": "Max listings per search", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Cap for EACH search (make / model × keyword × location, seller, or start URL), so that the first search cannot use up the whole **Max listings** budget. 0 = no per-search cap.", "default": 0 }, "splitLargeSearches": { "title": "Go past 4 000 listings per search", "type": "boolean", "description": "AutoScout24 returns at most 4 000 listings per search. On: a bigger search is cut into price bands, each under 4 000, so that every listing is reached (free, a few more requests); the bands add up to the search total. Off: the first 4 000.", "default": true }, "extractDetails": { "title": "Extract details", "type": "boolean", "description": "Add the full listing: seller's description, every equipment item, all technical data (WLTP consumption and CO₂, weight, gears, cylinders, last service, next inspection, damage, origin), warranty, financing and leasing offers, quality seals, Carfax report link, running costs. Read in the same request as the search (no extra page), charged per listing as **Listing details**, on top of the listing (see Pricing). Off = the main fields: price, AutoScout24 price rating and its ranges, mileage, year, power, fuel, gearbox, body, colour, seller name and address, dates, views and favourites.", "default": false }, "includePriceHistory": { "title": "Price history", "type": "boolean", "description": "Every price the listing has had on AutoScout24, with the date of each change (`priceHistory`), and the first price seen (`firstPrice`). It comes with the search, from the first run. Charged per listing whose price changed at least once, as **Price history** (see Pricing); a listing still at its first price costs nothing extra.", "default": false }, "includePhones": { "title": "Seller phone numbers", "type": "boolean", "description": "Fill `sellerPhone`, `sellerPhones` and the dealer's contact person (`sellerContactPerson`). Charged per listing as **Phone number found**, once per listing delivered with at least one number (however many it has), on top of the listing (see Pricing); a listing without a number costs nothing extra. Read with the search (no extra page). Off = the phone fields are always empty.", "default": false }, "includeEmails": { "title": "Dealer e-mail", "type": "boolean", "description": "Fill `sellerEmail` with the dealer's e-mail address published on AutoScout24 (most dealers have one; private sellers only have a contact form). Charged per listing delivered with an e-mail, as **E-mail found** (see Pricing). Read with the search (no extra page).", "default": false }, "includeCoordinates": { "title": "GPS coordinates", "type": "boolean", "description": "Fill `latitude` / `longitude` of the vehicle's location. They are only on the listing page: 1 extra request per listing, charged per listing with coordinates found as **GPS coordinates** (see Pricing).", "default": false }, "includeDealerProfiles": { "title": "Dealer profiles (imprint, VAT id, reviews)", "type": "boolean", "description": "For each dealer, read its AutoScout24 dealer pages once per run: imprint (legal name, managing directors, trade register, VAT id, e-mail), own website, opening hours, makes sold, services, branches and, with **Dealer reviews per dealer**, its customer reviews. Charged per dealer as **Dealer profile** (see Pricing), when its number of vehicles for sale and the reviews asked are all read (a dealer whose figure or reviews could not be read is not charged on that listing); private sellers have no dealer page.", "default": false }, "reviewLimit": { "title": "Dealer reviews per dealer", "minimum": 0, "maximum": 100, "type": "integer", "description": "With **Dealer profiles**: also return up to this many of the latest customer reviews of each dealer (`sellerReviews`: date, rating and sub-ratings, text, dealer reply). AutoScout24 serves the 10 reviews of the dealer page, then the reviews from the 21st on, in lots of 10 (some of the 11th to 20th are never served), so a dealer can give up to 10 fewer than asked. Included in the **Dealer profile** charge. 0 = no reviews.", "default": 0 }, "priceFrom": { "title": "Min price", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Lowest price in euros." }, "priceTo": { "title": "Max price", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Highest price in euros." }, "yearFrom": { "title": "Min first registration year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Registered in this year or later." }, "yearTo": { "title": "Max first registration year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Registered in this year or earlier." }, "modelYearFrom": { "title": "Min model year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Model year (not registration year) this one or later." }, "modelYearTo": { "title": "Max model year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Model year this one or earlier." }, "mileageFrom": { "title": "Min mileage", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Lowest mileage in km." }, "mileageTo": { "title": "Max mileage", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Highest mileage in km." }, "powerFrom": { "title": "Min power", "minimum": 0, "maximum": 3000, "type": "integer", "description": "Lowest engine power, in the **Power unit** below." }, "powerTo": { "title": "Max power", "minimum": 0, "maximum": 3000, "type": "integer", "description": "Highest engine power, in the **Power unit** below." }, "powerUnit": { "title": "Power unit", "enum": [ "kw", "hp" ], "type": "string", "description": "Unit of **Min power** / **Max power**.", "default": "kw" }, "fuelTypes": { "title": "Fuel types", "uniqueItems": true, "type": "array", "description": "Keep any of these fuels. Empty = all.", "items": { "type": "string", "enum": [ "2", "3", "B", "C", "D", "E", "H", "L", "M", "O" ], "enumTitles": [ "Electric/Gasoline", "Electric/Diesel", "Gasoline", "CNG", "Diesel", "Electric", "Hydrogen", "LPG", "Ethanol", "Others" ] }, "default": [] }, "transmission": { "title": "Transmission", "uniqueItems": true, "type": "array", "description": "Keep any of these gearboxes. Empty = all.", "items": { "type": "string", "enum": [ "A", "M", "S" ], "enumTitles": [ "Automatic", "Manual", "Semi-automatic" ] }, "default": [] }, "bodyTypes": { "title": "Body types", "uniqueItems": true, "type": "array", "description": "Keep any of these body types (each vehicle type has its own list: pick those of the **Vehicle type** searched). Empty = all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "12", "13", "7", "101", "102", "103", "104", "105", "106", "108", "109", "110", "111", "112", "113", "114", "115", "116", "117", "118", "119", "120", "121", "122", "204", "302", "303", "304", "305", "306", "307", "308", "309", "310", "311", "312", "313", "314", "315", "316", "317", "318", "319", "320", "321", "201", "202", "203", "205", "206", "207", "208", "210", "401", "407", "408", "411", "419", "420", "426" ], "enumTitles": [ "Cars: Compact", "Cars: Convertible", "Cars: Coupe", "Cars: SUV/Off-Road/Pick-Up", "Cars: Station Wagon", "Cars: Sedan", "Van", "Cars: Transporter", "Other", "Motorbikes: Supersport", "Motorbikes: Sport touring", "Motorbikes: Chopper/Cruiser", "Motorbikes: Touring Enduro", "Motorbikes: Streetfighter", "Motorbikes: Enduro Bike", "Motorbikes: Motocrosser", "Motorbikes: Sidecar", "Motorbikes: Classic", "Motorbikes: Three Wheeler", "Motorbikes: Scooter", "Motorbikes: Moped", "Motorbikes: Super Moto", "Motorbikes: Minibike", "Motorbikes: Other", "Motorbikes: Naked Bike", "Motorbikes: Quad", "Motorbikes: Rally", "Motorbikes: Trials Bike", "Motorbikes: Racing", "Motorbikes: Tourer", "Vans & trucks: Panel van", "Vans & trucks: Roll-off tipper", "Vans & trucks: Breakdown truck", "Vans & trucks: Dumper truck", "Vans & trucks: Truck-mounted crane", "Vans & trucks: Car transport", "Vans & trucks: Three-sided tipper", "Vans & trucks: Chassis", "Vans & trucks: Mobile Shop / Food truck", "Vans & trucks: Refrigerated truck", "Vans & trucks: Armored truck", "Vans & trucks: Beverages van", "Vans & trucks: Glass transport superstructure", "Vans & trucks: Hydraulic work platform", "Vans & trucks: Van-high roof", "Vans & trucks: Tipper", "Vans & trucks: Box", "Vans & trucks: Station wagon/van", "Vans & trucks: Cattle carrier", "Vans & trucks: Flatbed van", "Vans & trucks: Flatbed+tarpaulin", "Motorhomes & caravans: Alcove", "Motorhomes & caravans: Integrated", "Motorhomes & caravans: Semi-Integrated", "Motorhomes & caravans: Cabin", "Motorhomes & caravans: Pick-up camper", "Motorhomes & caravans: Other campers", "Motorhomes & caravans: Caravan", "Motorhomes & caravans: Mobile Home", "Trailers: Reefer/Isolated/Freeze", "Trailers: Car trailer", "Trailers: Motorcycle trailer", "Trailers: Boat trailer", "Trailers: Platform", "Trailers: Flatbed open", "Trailers: Vending trailer" ] }, "default": [] }, "condition": { "title": "Condition", "uniqueItems": true, "type": "array", "description": "Keep any of these conditions (new, used, employee's car, classic, demonstration, pre-registered). Empty = all.", "items": { "type": "string", "enum": [ "N", "U", "J", "O", "D", "S" ], "enumTitles": [ "New", "Used", "Employee's car", "Antique / Classic", "Demonstration", "Pre-registered" ] }, "default": [] }, "sellerType": { "title": "Seller type", "enum": [ "ANY", "D", "P" ], "type": "string", "description": "Dealers, private sellers, or both.", "default": "ANY" }, "exteriorColors": { "title": "Exterior colours", "uniqueItems": true, "type": "array", "description": "Keep any of these colours. Empty = all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "10", "11", "12", "13", "14", "15", "16" ], "enumTitles": [ "Beige", "Blue", "Brown", "Bronze", "Yellow", "Grey", "Green", "Red", "Black", "Silver", "Violet", "White", "Orange", "Gold" ] }, "default": [] }, "paintTypes": { "title": "Paint", "uniqueItems": true, "type": "array", "description": "Keep any of these paint finishes (metallic, mica, others). Empty = all.", "items": { "type": "string", "enum": [ "M", "O", "S" ], "enumTitles": [ "Metallic", "Others", "Mica (Stoned)" ] }, "default": [] }, "interiorColors": { "title": "Interior colours", "uniqueItems": true, "type": "array", "description": "Keep any of these interior colours. Empty = all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11" ], "enumTitles": [ "Beige", "Black", "Grey", "Brown", "Other", "Blue", "Red", "Green", "Yellow", "Orange", "White" ] }, "default": [] }, "upholstery": { "title": "Upholstery", "uniqueItems": true, "type": "array", "description": "Keep any of these upholstery types. Empty = all.", "items": { "type": "string", "enum": [ "AL", "CL", "FL", "OT", "PL", "VL" ], "enumTitles": [ "Alcantara", "Cloth", "Full leather", "Other", "Part leather", "Velour" ] }, "default": [] }, "priceRatings": { "title": "Price ratings", "uniqueItems": true, "type": "array", "description": "Keep only listings with one of these AutoScout24 price ratings (e.g. `Very good price` + `Good price` = the deals). Empty = all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "99" ], "enumTitles": [ "Very good price", "Good price", "Fair price", "Increased price", "High price", "No rating" ] }, "default": [] }, "maxPreviousOwners": { "title": "Max previous owners", "minimum": 1, "maximum": 4, "type": "integer", "description": "At most this many previous owners (1 to 3; 4 = 4 or more)." }, "seatsFrom": { "title": "Min seats", "minimum": 1, "maximum": 99, "type": "integer", "description": "At least this many seats." }, "seatsTo": { "title": "Max seats", "minimum": 1, "maximum": 99, "type": "integer", "description": "At most this many seats." }, "doorsFrom": { "title": "Min doors", "minimum": 2, "maximum": 7, "type": "integer", "description": "At least this many doors." }, "doorsTo": { "title": "Max doors", "minimum": 2, "maximum": 7, "type": "integer", "description": "At most this many doors." }, "driveType": { "title": "Drive type", "uniqueItems": true, "type": "array", "description": "Keep any of these drive types. Empty = all.", "items": { "type": "string", "enum": [ "4", "F", "R" ], "enumTitles": [ "4x4", "Front Wheel Drive", "Rear Wheel Drive" ] }, "default": [] }, "cylinders": { "title": "Cylinders", "uniqueItems": true, "type": "array", "description": "Keep any of these numbers of cylinders. Empty = all.", "items": { "type": "string", "enum": [ "3", "4", "6", "8", "10plus" ], "enumTitles": [ "3 cylinder", "4 cylinder", "6 cylinder", "8 cylinder", "10+ cylinder" ] }, "default": [] }, "emissionClass": { "title": "Emission class", "enum": [ "1", "2", "3", "4", "5", "6", "11", "7", "8", "9", "10" ], "type": "string", "description": "This Euro emission class or a better one (e.g. Euro 6 also keeps Euro 6c, 6d-TEMP and 6d)." }, "emissionSticker": { "title": "Emission sticker", "enum": [ "2", "3", "4", "5" ], "type": "string", "description": "German low-emission zone sticker (Umweltplakette): this sticker or a better one (yellow also keeps green)." }, "engineSizeFrom": { "title": "Min engine size", "minimum": 0, "maximum": 30000, "type": "integer", "description": "Lowest cubic capacity in cm³." }, "engineSizeTo": { "title": "Max engine size", "minimum": 0, "maximum": 30000, "type": "integer", "description": "Highest cubic capacity in cm³." }, "electricRangeFrom": { "title": "Min electric range", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Lowest electric range in km (electric and plug-in hybrid vehicles)." }, "electricRangeTo": { "title": "Max electric range", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Highest electric range in km." }, "batteryOwnership": { "title": "Battery", "enum": [ "1", "2", "3" ], "type": "string", "description": "Electric vehicles: battery included in the price, rented, or excluded." }, "features": { "title": "Required equipment", "uniqueItems": true, "type": "array", "description": "Keep only vehicles with ALL of these equipment items (AutoScout24's own list, e.g. navigation system, heated seats, tow bar, full service history, warranty). Empty = no requirement.", "items": { "type": "string", "enum": [ "187", "11", "1", "133", "118", "180", "5", "144", "18", "211", "15", "219", "222", "221", "134", "30", "241", "242", "243", "225", "188", "52", "174", "181", "251", "230", "250", "170", "158", "122", "111", "178", "226", "29", "132", "17", "47", "195", "183", "193", "104", "192", "107", "38", "115", "172", "224", "138", "36", "204", "232", "203", "201", "146", "2", "173", "198", "233", "108", "139", "121", "16", "135", "240", "42", "148", "149", "216", "217", "19", "229", "239", "214", "37", "124", "46", "190", "123", "249", "136", "189", "137", "106", "120", "26", "223", "228", "125", "261", "153", "109", "157", "213", "6", "142", "141", "140", "126", "199", "143", "145", "175", "43", "114", "200", "23", "147", "110", "41", "171", "246", "50", "40", "130", "131", "128", "129", "53", "3", "12", "13", "10", "127", "237", "45", "186", "248", "48", "27", "177", "34", "154", "182", "151", "32", "247", "184", "119", "262", "202", "152", "244", "245", "218", "205", "155", "215", "227", "21", "238", "112", "117", "116", "113", "212", "210", "4", "194", "160", "54", "150", "105", "159", "31", "162", "20", "197", "28", "196", "161", "156", "179", "44", "103", "231", "25", "49", "220", "39" ], "enumTitles": [ "360° camera", "4WD", "ABS", "Adaptive Cruise Control", "Adaptive headlights", "Additional 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 air conditioning", "Auxiliary heating", "Awning", "Bath", "Battery certificate", "Bi-Xenon headlights", "Bidirectional Charging", "Biodiesel conversion", "Blind spot monitor", "Bluetooth", "Cab or rented Car", "Cable winch", "Cargo barrier", "Catalytic Converter", "CD player", "Central door lock", "Central door lock with remote control", "Centre pivot plate", "Circular seating arrangement", "Cooling unit", "Cover panel", "Crane", "Crash bar", "Cruise control", "Daytime running lights", "Differential lock", "Digital cockpit", "Digital radio", "Disabled accessible", "Disc brake", "Distance warning system", "Divider", "Double cabin", "Driver drowsiness detection", "Driver-side airbag", "E10-enabled", "EBS", "Electric backseat adjustment", "Electric Starter", "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", "Guarantee", "Hands-free equipment", "Head airbag", "Headlight washer system", "Heads-up display", "Heat Pump", "Heated steering wheel", "High beam assist", "Hill Holder", "Hot bar end", "HU/AU new", "Immobilizer", "Induction charging for smartphones", "Integrated music streaming", "Isofix", "Jacob", "Keyless central door lock", "Kickstarter", "Lane departure warning system", "Laser headlights", "Leather seats", "Leather steering wheel", "LED Daytime Running Lights", "LED Headlights", "Light sensor", "Low noise", "Lumbar support", "Massage seats", "Middle seating arrangement", "MP3", "Multi-function steering wheel", "Municipal vehicle", "Navigation system", "Night view assist", "Non-smoking vehicle", "On-board computer", "On-board kitchen", "Overrun brake", "Panorama roof", "Park Distance Control", "Parking assist system camera", "Parking assist system self-steering", "Parking assist system sensors front", "Parking assist system sensors rear", "Particulate filter", "Passenger-side airbag", "Power steering", "Power windows", "Radio", "Rain sensor", "Range extender", "Rear airbag", "Rear garage", "Rear seat heating", "Right-hand drive", "Roof rack", "Satellite antenna", "Seat heating", "Seat ventilation", "Separate shower", "Shift paddles", "Side airbag", "Side Panniers", "Side seating arrangement", "Ski bag", "Skirt", "Sleeping berth", "Sliding door", "Sliding door left", "Sliding door right", "Smoker's package", "Solar array", "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", "Tail-lift", "Television", "Tinted windows", "Tire pressure monitoring system", "Topcase", "Touch screen", "Traction control", "Traffic sign recognition", "Trailer hitch", "Tubular Tracks (Meat)", "Tuned car", "Uploader", "USB", "Voice Control", "WC", "Wind deflector", "Windshield", "Winter package", "Winter tyres", "With full service history", "WLAN / WiFi hotspot", "Xenon headlights" ] }, "default": [] }, "qualitySeals": { "title": "Quality seals", "uniqueItems": true, "type": "array", "description": "Only used vehicles with one of these manufacturer or inspection seals (certified used cars). Empty = all.", "items": { "type": "string", "enum": [ "83", "102", "117", "127", "140", "141", "144", "160", "196", "218", "244", "256", "257", "275", "292", "293", "322", "331", "337", "388", "392" ], "enumTitles": [ "Dekra Siegel", "Audi Gebrauchtwagen:plus", "LexusSelect", "BMW Premium Selection", "MINI NEXT", "Renault 7 Sterne", "Mercedes-Benz Junge Sterne", "VOLVO SELEKT", "jung@smart", "Certified by Bentley", "Mercedes-Benz Junge Sterne Transporter", "NISSANCOLLECTION", "Aston Martin Timeless", "Skoda Plus", "Hyundai Promise ", "Lamborghini Certified Pre-Owned", "SPOTICAR", "Volkswagen Zertifizierte Gebrauchtwagen", "Toyota Geprüfte Gebrauchtwagen", "Polestar Certified Pre-owned", "SPOTICAR Premium" ] }, "default": [] }, "includeDamaged": { "title": "Include damaged vehicles", "type": "boolean", "description": "AutoScout24 hides vehicles with unrepaired damage by default; tick to include them (`damageConditions` says which damage).", "default": false }, "vatDeductible": { "title": "VAT deductible only", "type": "boolean", "description": "Only listings where the VAT can be reclaimed (net price shown), for business buyers.", "default": false }, "priceReducedOnly": { "title": "Price reduced only", "type": "boolean", "description": "Only listings whose price was lowered (AutoScout24 « super deal », with the old price: `previousPrice`).", "default": false }, "onlineSince": { "title": "Online since", "enum": [ "1", "2", "3", "4", "5", "6", "7", "14" ], "type": "string", "description": "Only listings put online in the last N days, filtered by AutoScout24 itself (for any other period use **Posted after**)." }, "leasingOnly": { "title": "Leasing offers only", "type": "boolean", "description": "Only listings that carry a leasing offer (`leasing` and `leasingRateMonthly` in the results).", "default": false }, "leasingTarget": { "title": "Leasing for", "enum": [ "P", "B" ], "type": "string", "description": "With **Leasing offers only**: offers for private or business customers." }, "maxLeasingRate": { "title": "Max leasing rate", "minimum": 0, "maximum": 100000, "type": "integer", "description": "With **Leasing offers only**: highest monthly leasing rate, in euros." }, "maxFinanceRate": { "title": "Max financing rate", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Highest monthly financing instalment, in euros (listings with a financing offer)." }, "customFilters": { "title": "Other AutoScout24 filters", "type": "object", "description": "Any other filter of the AutoScout24 search, as `parameter: value` (a list for several values), with the parameter names of AutoScout24 links: e.g. `{\"newdriver\": \"true\", \"lsdufrom\": 24, \"ocs_listing\": \"exclude\"}`. The README lists every parameter; an unknown parameter stops the run (AutoScout24 would silently ignore it and return everything). Like the AutoScout24 page, the Actor sends `damaged_listing=exclude`, `ocs_listing=include`, `lm_premium=true` and `specialconditions=true` by default, so totals match the site: set them here to change them. `page`, `size`, `slug`, `sort` and `desc` are refused (use **Sort by** and the caps).", "default": {} }, "sortBy": { "title": "Sort by", "enum": [ "NEWEST", "RELEVANCE", "PRICE_ASC", "PRICE_DESC", "MILEAGE_ASC", "MILEAGE_DESC", "YEAR_DESC", "YEAR_ASC", "POWER_DESC", "POWER_ASC", "MAKE", "DISTANCE" ], "type": "string", "description": "Order in which AutoScout24 returns the listings. Newest first is the default and the one used to stop early with **Only new listings**. With a cap, the order decides WHICH listings you get. Distance needs **Location** as GPS coordinates `lat,lon`; with a postcode the order falls back to best results (with a warning).", "default": "NEWEST" }, "postedAfter": { "title": "Posted after", "type": "string", "description": "Only listings first put online on AutoScout24 on or after this date (`publishedAt`, not a later price change or renewal): `2026-09-01`, or a period before now such as `7 days`, `2 weeks`, `1 month` (API: `24 hours` and full ISO date-times work too)." }, "postedBefore": { "title": "Posted before", "type": "string", "description": "Only listings first put online on or before this date (the whole day is included), or older than a period such as `30 days`." }, "excludeKeywords": { "title": "Exclude keywords", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Drop the listings whose title or version contains one of these words (case and accents ignored), e.g. `Motorschaden`, `Export`, `defekt`, or a model to leave out (`M3`). A word also counts inside a longer word.", "default": [], "items": { "type": "string" } }, "requirePhone": { "title": "With phone only", "type": "boolean", "description": "Keep only the listings whose seller shows a phone number. Works on its own: the numbers are returned (and billed) only when **Seller phone numbers** is ticked.", "default": false }, "minRating": { "title": "Min seller rating", "pattern": "^$|^[1-5](\\.[0-9])?$", "maxLength": 3, "type": "string", "description": "Keep only listings of dealers whose exact average rating (`sellerRatingAverage`, e.g. 4.05; not the stars rounded up to the half) is at least this value, from 1 to 5, e.g. `4.5`; private sellers and dealers without a rating are dropped. Empty = no rating filter." }, "onlyNew": { "title": "Only new listings", "type": "boolean", "description": "Skip the listings that a previous run (same **Memory key**) already delivered: they are not saved and not charged. First run = everything is new.", "default": false }, "stateKey": { "title": "Memory key", "pattern": "^[a-zA-Z0-9_-]{1,64}$", "maxLength": 64, "type": "string", "description": "Name of the memory used by **Only new listings**. Give each schedule / task its own key (e.g. `x1-munich`) so that they do not share their memory. Letters, digits, `-` and `_`.", "default": "default" }, "resetState": { "title": "Reset the memory", "type": "boolean", "description": "Forget everything remembered under this **Memory key** before the run: this run returns (and charges) every listing again. Untick it afterwards.", "default": false }, "includePriceChanges": { "title": "Report price changes", "type": "boolean", "description": "Needs **Only new listings**. A listing already delivered under this **Memory key** comes back, whole, when its price has changed since the run that delivered it: `changeType` = `PRICE_CHANGED`, with `lastDeliveredPrice`, `priceChange`, `priceChangePct` and `priceChangedAt`. Charged per listing as **Price change**, on top of the listing (see Pricing); a listing whose price did not move is not saved. The search is read past the new listings, as far as the listings already delivered go (up to **Max listings** delivered), because an older listing can change its price: each listing already delivered and re-checked is charged a small **Price check** (see Pricing), and the run stops when its maximum cost cannot pay one.", "default": false }, "minPriceChangePercent": { "title": "Min price change", "minimum": 0, "maximum": 100, "type": "integer", "description": "With **Report price changes**: ignore a price change smaller than this percentage (up or down). 0 = every change.", "default": 0 }, "language": { "title": "Language", "enum": [ "en", "de", "it", "fr", "es", "nl" ], "type": "string", "description": "Language of the texts AutoScout24 writes (fuel, gearbox, body, colour, equipment, damage labels) and AutoScout24 site of the listing URLs. The codes and numbers are the same in every language; the listings found do not depend on it.", "default": "en" }, "imageSize": { "title": "Photo size", "enum": [ "small", "medium", "large", "original" ], "type": "string", "description": "Size of the photo URLs returned.", "default": "large" }, "includeRaw": { "title": "Include raw data", "type": "boolean", "description": "Add a `raw` field with the untouched JSON of AutoScout24 for the listing. Useful to recover a field this Actor does not map yet; makes the data much bigger.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy or your own proxies. Keep the default: it is included in the price. The residential Apify proxy is not available in this Actor (not needed for AutoScout24).", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of requests processed in parallel.", "default": 8 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 10, "maximum": 2000, "type": "integer", "description": "Most requests to AutoScout24 in any 60 seconds, all of them counted: searches (up to 400 listings each), listing pages (GPS) and dealer pages. A budget, not an even pace (spread them with the minimum delay below). Lower it if the log shows HTTP 429 / 403.", "default": 120 }, "minRequestIntervalMs": { "title": "Min delay between requests", "minimum": 0, "maximum": 60000, "type": "integer", "description": "Smallest gap between two requests, in milliseconds. Unlike the per-minute rate, this spreads the requests evenly instead of letting them go out in a burst. 0 = no gap.", "default": 0 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 20, "type": "integer", "description": "Retries per request before it is marked as failed. Behind a proxy, a request the site turns away is also retried on a new proxy session up to 10 times without using up these retries.", "default": 5 }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Include debug messages in the run log.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }