{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Car Listings Scraper — EU Used & New Cars", "description": "AutoScout24 car listings for dealers, importers, pricing analysts and AI agents: 293 makes in 8 EU countries, filters for price, year, mileage, power, fuel, gearbox, body, owners, equipment, seller and postcode radius. Price rating, price per km, optional full vehicle pages.", "version": "0.1", "x-build-id": "ig7lCuOvnFzJRhvfz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yadroo~autoscout24-cars/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yadroo-autoscout24-cars", "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/yadroo~autoscout24-cars/runs": { "post": { "operationId": "runs-sync-yadroo-autoscout24-cars", "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/yadroo~autoscout24-cars/run-sync": { "post": { "operationId": "run-sync-yadroo-autoscout24-cars", "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": "Make slug, name or autoscout24 id: \"bmw\", \"mercedes-benz\", \"Volkswagen\", \"Lynk & Co\", \"13\". 293 makes supported (README → Reference → Makes). Empty = all makes." }, "model": { "title": "Model", "type": "string", "description": "Model slug as in the site URL https://www.autoscout24.com/lst//: a model (\"x5\", \"golf\", \"a4\", \"c-220\", \"id-4\") or a model line / series (\"3-series\", \"c-class\", \"range-rover-sport\"). Empty = all models. An unrecognised model fails the run with the list of valid slugs instead of silently returning every car of the make. Note: leave empty for all models of the make." }, "country": { "title": "Country", "enum": [ "", "A", "B", "D", "E", "F", "I", "L", "NL" ], "type": "string", "description": "Where the car is offered. Use `countries` for several.", "default": "D" }, "countries": { "title": "Countries (several)", "type": "array", "description": "Overrides `country` when not empty, e.g. [\"D\",\"A\",\"NL\"] for cross-border sourcing.", "items": { "type": "string", "enum": [ "A", "B", "D", "E", "F", "I", "L", "NL" ], "enumTitles": [ "Austria (A)", "Belgium (B)", "Germany (D)", "Spain (E)", "France (F)", "Italy (I)", "Luxembourg (L)", "Netherlands (NL)" ] } }, "zip": { "title": "Postcode", "type": "string", "description": "Search around a postcode inside the selected country (e.g. \"80331\" Munich). Enables sort=distance." }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Radius around `zip`. The site offers 10, 20, 50, 100, 150, 200, 250, 300, 400." }, "condition": { "title": "New / used", "enum": [ "all", "used", "new" ], "type": "string", "description": "autoscout24 `ustate`.", "default": "all" }, "offerTypes": { "title": "Offer types", "type": "array", "description": "Finer offer type (`offer`): N new, U used, J employee car, O classic, D demonstration, S pre-registered. Several = OR.", "items": { "type": "string", "enum": [ "N", "U", "J", "O", "D", "S" ], "enumTitles": [ "New (N)", "Used (U)", "Employee's car (J)", "Antique / Classic (O)", "Demonstration (D)", "Pre-registered (S)" ] } }, "priceFrom": { "title": "Price from (€)", "minimum": 0, "type": "integer", "description": "Minimum price in EUR." }, "priceTo": { "title": "Price to (€)", "minimum": 0, "type": "integer", "description": "Maximum price in EUR." }, "yearFrom": { "title": "First registration from (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "autoscout24 `fregfrom`." }, "yearTo": { "title": "First registration to (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "autoscout24 `fregto`." }, "mileageFrom": { "title": "Mileage from (km)", "minimum": 0, "type": "integer", "description": "autoscout24 `kmfrom`." }, "mileageTo": { "title": "Mileage to (km)", "minimum": 0, "type": "integer", "description": "autoscout24 `kmto`." }, "powerFrom": { "title": "Power from", "minimum": 0, "type": "integer", "description": "Minimum engine power in `powerUnit`." }, "powerTo": { "title": "Power to", "minimum": 0, "type": "integer", "description": "Maximum engine power in `powerUnit`." }, "powerUnit": { "title": "Power unit", "enum": [ "kw", "hp" ], "type": "string", "description": "Unit for powerFrom/powerTo.", "default": "kw" }, "fuel": { "title": "Fuel", "type": "array", "description": "autoscout24 `fuel`: B petrol, D diesel, E electric, 2 petrol hybrid, 3 diesel hybrid, L LPG, C CNG, H hydrogen, M ethanol, O other. Several = OR.", "items": { "type": "string", "enum": [ "2", "3", "B", "C", "D", "E", "H", "L", "M", "O" ], "enumTitles": [ "Electric/Gasoline (2)", "Electric/Diesel (3)", "Gasoline (B)", "CNG (C)", "Diesel (D)", "Electric (E)", "Hydrogen (H)", "LPG (L)", "Ethanol (M)", "Others (O)" ] } }, "gear": { "title": "Gearbox", "type": "array", "description": "autoscout24 `gear`: A automatic, M manual, S semi-automatic.", "items": { "type": "string", "enum": [ "A", "M", "S" ], "enumTitles": [ "Automatic (A)", "Manual (M)", "Semi-automatic (S)" ] } }, "body": { "title": "Body type", "type": "array", "description": "autoscout24 `body`: 1 compact, 2 convertible, 3 coupe, 4 SUV/off-road/pick-up, 5 station wagon, 6 sedan, 12 van, 13 transporter, 7 other.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "12", "13" ], "enumTitles": [ "Compact (1)", "Convertible (2)", "Coupe (3)", "SUV/Off-Road/Pick-Up (4)", "Station Wagon (5)", "Sedan (6)", "Other (7)", "Van (12)", "Transporter (13)" ] } }, "sellerType": { "title": "Seller", "enum": [ "all", "dealer", "private" ], "type": "string", "description": "autoscout24 `custtype`.", "default": "all" }, "bodyColors": { "title": "Body colour", "type": "array", "description": "autoscout24 `bcol`.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "10", "11", "12", "13", "14", "15", "16" ], "enumTitles": [ "Beige (1)", "Blue (2)", "Brown (3)", "Bronze (4)", "Yellow (5)", "Grey (6)", "Green (7)", "Red (10)", "Black (11)", "Silver (12)", "Violet (13)", "White (14)", "Orange (15)", "Gold (16)" ] } }, "emissionClass": { "title": "Emission class (minimum)", "enum": [ "", "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11" ], "type": "string", "description": "autoscout24 `emclass`.", "default": "" }, "maxPreviousOwners": { "title": "Max previous owners", "enum": [ "", "1", "2", "3", "4" ], "type": "string", "description": "autoscout24 `prevownersid`.", "default": "" }, "doorsFrom": { "title": "Doors from", "minimum": 2, "maximum": 7, "type": "integer", "description": "autoscout24 `doorfrom`." }, "doorsTo": { "title": "Doors to", "minimum": 2, "maximum": 7, "type": "integer", "description": "autoscout24 `doorto`." }, "seatsFrom": { "title": "Seats from", "minimum": 1, "maximum": 12, "type": "integer", "description": "autoscout24 `seatsfrom`." }, "seatsTo": { "title": "Seats to", "minimum": 1, "maximum": 12, "type": "integer", "description": "autoscout24 `seatsto`." }, "equipment": { "title": "Equipment (all required)", "type": "array", "description": "Equipment names or ids, e.g. \"Navigation system\", \"Trailer hitch\", \"37\" (Guarantee), \"49\" (full service history). 136 options in README → Reference.", "items": { "type": "string" } }, "priceLabels": { "title": "Price rating (client-side)", "type": "array", "description": "Keep only cars with these autoscout24 price ratings, e.g. [\"top-price\",\"good-price\"] for deal hunting. Applied after download, so more pages may be scanned.", "items": { "type": "string", "enum": [ "top-price", "good-price", "fair-price", "increased-price", "high-price", "toolow-price", "no-rating" ], "enumTitles": [ "Top price (top-price)", "Good price (good-price)", "Fair price (fair-price)", "Increased price (increased-price)", "High price (high-price)", "Suspiciously low price (toolow-price)", "No price rating (no-rating)" ] } }, "extraParams": { "title": "Extra URL parameters (advanced)", "type": "object", "description": "Any other autoscout24 /lst query parameter copied from a site URL, e.g. {\"eq\": \"37,49\"}. Overrides the fields above." }, "sort": { "title": "Sort", "enum": [ "standard", "price", "age", "mileage", "year", "power", "make", "distance" ], "type": "string", "description": "autoscout24 `sort`. Direction via `sortDescending`.", "default": "standard" }, "sortDescending": { "title": "Sort descending", "type": "boolean", "description": "Descending order (e.g. most expensive first). Default: ascending, except \"age\" which is newest first." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 4000, "type": "integer", "description": "Stop after this many cars. 20 per page; autoscout24 serves at most 200 pages (4 000 cars) per search.", "default": 40 }, "maxPages": { "title": "Max pages", "minimum": 1, "maximum": 200, "type": "integer", "description": "Safety cap on search pages. Raise it together with maxItems or when priceLabels filters out most cars.", "default": 20 }, "detail": { "title": "Open listing pages", "type": "boolean", "description": "Open each listing and add description, full equipment list, colour, body, seats/doors, cylinders, drivetrain, weight, emission class, CO₂ and consumption, previous owners, coordinates, listing creation date, VAT/negotiable flags. +1 request per car (~1 s each).", "default": false }, "dedupe": { "title": "Deduplicate", "type": "boolean", "description": "Skip listing ids already seen in this run (sponsored cars repeat across pages).", "default": true } } }, "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 } } } } } } } } } }