{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Scraper", "description": "Scrape AutoScout24 cars, motorbikes, vans and campers across 8 EU countries: price, price rating, mileage, year, power, fuel, dealer name and phone numbers, photos. Every site filter, any make or model, past the 4,000 cap. Optional details: equipment, owners, service history, VAT.", "version": "1.0", "x-build-id": "L0787AajvaLOzb95n" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~autoscout24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-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/normdata~autoscout24-scraper/runs": { "post": { "operationId": "runs-sync-normdata-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/normdata~autoscout24-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-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": { "maxItems": { "title": "Maximum vehicles", "minimum": 1, "type": "integer", "description": "Stop after this many vehicles. Leave empty for no limit (every listing that matches, even past AutoScout24's 4,000-result cap). The Apify Free plan is always capped at 10." }, "vehicles": { "title": "Makes and models", "type": "array", "description": "Start with the make, then optionally a model, a model series or version words: \"BMW\", \"BMW 320\", \"BMW 3 Series\", \"Volkswagen Golf GTI\", \"Mercedes-Benz G 63 AMG\", \"Tesla\". Each line is its own search.", "items": { "type": "string" } }, "urls": { "title": "...or paste links", "type": "array", "description": "AutoScout24 search pages with all their filters (e.g. autoscout24.com/lst/bmw/320?fregfrom=2020, or autoscout24.de, .it, .fr, .es, .nl, .be, .at) or single listings (autoscout24.com/offers/...). Links keep their own filters; the filters below apply to Makes and models.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "vehicleType": { "title": "Vehicle type", "enum": [ "car", "motorbike", "van", "caravan", "trailer" ], "type": "string", "description": "Cars, motorbikes, vans and transporters, motorhomes and caravans, or trailers.", "default": "car" }, "countries": { "title": "Countries", "type": "array", "description": "Where the vehicle is sold. Leave empty for all eight AutoScout24 countries.", "items": { "type": "string", "enum": [ "AT", "BE", "DE", "ES", "FR", "IT", "LU", "NL" ], "enumTitles": [ "Austria", "Belgium", "Germany", "Spain", "France", "Italy", "Luxembourg", "Netherlands" ] } }, "location": { "title": "Near (city or postcode)", "type": "string", "description": "A city or postcode, e.g. \"Berlin\", \"80331\", \"Milano\", \"Lyon\". Add a country code when the name exists in several countries: \"Valencia, ES\". Uses the radius below." }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Distance around the place above. Default 50 km." }, "minPrice": { "title": "Min price (€)", "minimum": 0, "type": "integer", "description": "Leave empty for any." }, "maxPrice": { "title": "Max price (€)", "minimum": 0, "type": "integer", "description": "Leave empty for no limit." }, "minYear": { "title": "Registered from (year)", "minimum": 0, "type": "integer", "description": "First registration year, e.g. 2018." }, "maxYear": { "title": "Registered until (year)", "minimum": 0, "type": "integer", "description": "First registration year, e.g. 2023." }, "minMileage": { "title": "Min mileage (km)", "minimum": 0, "type": "integer", "description": "Leave empty for any." }, "maxMileage": { "title": "Max mileage (km)", "minimum": 0, "type": "integer", "description": "Leave empty for no limit." }, "minPowerHp": { "title": "Min power (hp)", "minimum": 0, "type": "integer", "description": "Horsepower." }, "maxPowerHp": { "title": "Max power (hp)", "minimum": 0, "type": "integer", "description": "Horsepower." }, "fuel": { "title": "Fuel", "type": "array", "description": "Keep only ANY of these fuels.", "items": { "type": "string", "enum": [ "petrol", "diesel", "electric", "hybrid_petrol", "hybrid_diesel", "lpg", "cng", "hydrogen", "ethanol", "other" ], "enumTitles": [ "Petrol", "Diesel", "Electric", "Hybrid (electric/petrol)", "Hybrid (electric/diesel)", "LPG", "CNG", "Hydrogen", "Ethanol", "Other" ] } }, "transmission": { "title": "Gearbox", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "automatic", "manual", "semi_automatic" ], "enumTitles": [ "Automatic", "Manual", "Semi-automatic" ] } }, "bodyTypes": { "title": "Body type", "type": "array", "description": "Keep only ANY of these (cars).", "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" ] } }, "offerTypes": { "title": "Condition", "type": "array", "description": "Keep only ANY of these offer types. Leave empty for new and used.", "items": { "type": "string", "enum": [ "used", "new", "pre_registered", "demo", "employee_car", "classic" ], "enumTitles": [ "Used", "New", "Pre-registered", "Demonstration", "Employee's car", "Antique / classic" ] } }, "sellerType": { "title": "Seller", "enum": [ "all", "dealer", "private" ], "type": "string", "description": "Dealers, private sellers or both.", "default": "all" }, "priceRatings": { "title": "Price rating", "type": "array", "description": "Keep only listings with ANY of these AutoScout24 price ratings (its own market comparison), e.g. Top price + Good price for deals.", "items": { "type": "string", "enum": [ "top_price", "good_price", "fair_price", "somewhat_expensive", "expensive" ], "enumTitles": [ "Top price", "Good price", "Fair price", "Somewhat expensive", "Expensive" ] } }, "onlineSince": { "title": "Listed within", "enum": [ "1", "2", "3", "7", "14" ], "type": "string", "description": "Only listings put online in this window. Great for daily monitoring." }, "keywords": { "title": "Keywords", "type": "string", "description": "AutoScout24's own text search over the listing, e.g. \"Pano\", \"AMG Line\", \"Wankel\"." }, "minDoors": { "title": "Min doors", "minimum": 0, "type": "integer", "description": "Leave empty for any." }, "maxDoors": { "title": "Max doors", "minimum": 0, "type": "integer", "description": "Leave empty for any." }, "minSeats": { "title": "Min seats", "minimum": 0, "type": "integer", "description": "Leave empty for any." }, "maxSeats": { "title": "Max seats", "minimum": 0, "type": "integer", "description": "Leave empty for any." }, "maxPreviousOwners": { "title": "Max previous owners", "minimum": 1, "maximum": 4, "type": "integer", "description": "1, 2, 3, or 4 for 4 or more." }, "accidentVehicles": { "title": "Accident-damaged vehicles", "enum": [ "exclude", "include", "only" ], "type": "string", "description": "AutoScout24 hides accident-damaged vehicles by default.", "default": "exclude" }, "bodyColors": { "title": "Exterior colour", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "beige", "black", "blue", "bronze", "brown", "gold", "green", "grey", "orange", "red", "silver", "violet", "white", "yellow" ], "enumTitles": [ "Beige", "Black", "Blue", "Bronze", "Brown", "Gold", "Green", "Grey", "Orange", "Red", "Silver", "Violet", "White", "Yellow" ] } }, "metallicOnly": { "title": "Metallic paint only", "type": "boolean", "description": "Keep only vehicles with metallic paint.", "default": false }, "interiorColors": { "title": "Interior colour", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "beige", "black", "blue", "brown", "green", "grey", "orange", "red", "white", "yellow", "other" ], "enumTitles": [ "Beige", "Black", "Blue", "Brown", "Green", "Grey", "Orange", "Red", "White", "Yellow", "Other" ] } }, "upholstery": { "title": "Upholstery", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "full_leather", "part_leather", "alcantara", "cloth", "velour", "other" ], "enumTitles": [ "Full leather", "Part leather", "Alcantara", "Cloth", "Velour", "Other" ] } }, "equipment": { "title": "Must have equipment", "type": "array", "description": "Keep only vehicles with ALL of these, e.g. Apple CarPlay, Heads-up display, Panorama roof, Trailer hitch, Full service history.", "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", "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", "guarantee", "hands_free_equipment", "head_airbag", "headlight_washer_system", "heads_up_display", "heat_pump", "heated_steering_wheel", "high_beam_assist", "hill_holder", "hu_au_new", "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", "non_smoking_vehicle", "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", "particulate_filter", "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", "with_full_service_history", "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", "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", "Guarantee", "Hands-free equipment", "Head airbag", "Headlight washer system", "Heads-up display", "Heat Pump", "Heated steering wheel", "High beam assist", "Hill Holder", "HU/AU new", "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", "Non-smoking vehicle", "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", "Particulate filter", "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", "With full service history", "WLAN / WiFi hotspot", "Xenon headlights" ] } }, "driveTrain": { "title": "Drive", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "4x4", "front", "rear" ], "enumTitles": [ "4x4 / all-wheel drive", "Front-wheel drive", "Rear-wheel drive" ] } }, "cylinders": { "title": "Cylinders", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "3", "4", "6", "8", "10plus" ], "enumTitles": [ "3", "4", "6", "8", "10 or more" ] } }, "minEngineSize": { "title": "Min engine size (cc)", "minimum": 0, "type": "integer", "description": "Displacement in cm³." }, "maxEngineSize": { "title": "Max engine size (cc)", "minimum": 0, "type": "integer", "description": "Displacement in cm³." }, "emissionClass": { "title": "Emission class", "enum": [ "euro1", "euro2", "euro3", "euro4", "euro5", "euro6", "euro6b", "euro6c", "euro6d_temp", "euro6d", "euro6e" ], "type": "string", "description": "Minimum Euro emission class." }, "emissionSticker": { "title": "German emission sticker", "enum": [ "red", "yellow", "green", "blue" ], "type": "string", "description": "Minimum Umweltplakette (Germany)." }, "minElectricRange": { "title": "Min electric range (km)", "minimum": 0, "type": "integer", "description": "For electric and plug-in hybrid vehicles." }, "batteryOwnership": { "title": "Battery", "enum": [ "included", "rented", "excluded" ], "type": "string", "description": "For electric vehicles: is the battery included in the price?" }, "superDealsOnly": { "title": "Super deals only", "type": "boolean", "description": "Keep only listings AutoScout24 marks as Super deal (recent price cut).", "default": false }, "priceDropOnly": { "title": "Price drops only", "type": "boolean", "description": "Keep only listings showing a previous, higher price.", "default": false }, "vatDeductibleOnly": { "title": "VAT deductible only", "type": "boolean", "description": "Keep only listings with deductible VAT (for business buyers).", "default": false }, "leasingOnly": { "title": "Leasing offers only", "type": "boolean", "description": "Keep only listings that offer leasing.", "default": false }, "withPhoneOnly": { "title": "With phone number only", "type": "boolean", "description": "Keep only listings that show a phone number.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "newest", "price_low", "price_high", "mileage_low", "year_new", "power_high", "distance" ], "type": "string", "description": "Order of the results. Matters most when you set a Maximum.", "default": "relevance" }, "onlyNew": { "title": "New listings only", "type": "boolean", "description": "For scheduled runs: save only listings this same search has not saved before. The first run saves everything; later runs save just what was added since. Kept per search (makes, links and filters).", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional. Give \"New listings only\" a fixed name to keep its memory even after you change the filters." }, "includeDetails": { "title": "Full details", "type": "boolean", "description": "Reads each full listing and adds: description, full equipment list, all photos, body type, seats, doors, colours, upholstery, gears, cylinders, drive, weight, electric range, emission class, previous owners, accident, service history, non-smoker, inspection and service dates, warranty, HSN/TSN, net price, VAT, negotiable, GPS, seller score, Carfax link and listing date. Paid add-on: one extra charge per vehicle saved with details (see Pricing).", "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 } } } } } } } } } }