{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Scraper — Used & New Cars in 8 EU Countries", "description": "AutoScout24 car listings for dealers, importers, pricing analysts and AI agents: 293 makes in 8 EU countries, filters for model version, price, year, mileage, power, fuel, gearbox, body, owners, seller and postcode radius. Typos in make/model are auto-corrected. Price rating, price per km.", "version": "0.1", "x-build-id": "Dh3YYNL8TQZc59DCe" }, "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). Typos and short names are auto-corrected (\"Volkswagon\", \"Mercedes\", \"VW\") and shown in the log. 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\"). Typos are auto-corrected against autoscout24's own model list (\"sendiro\" → \"sandero\", \"golff\" → \"golf\") and shown in the log; extra words go to Version (\"sandero stepway\"). A model with no close match fails the run with the list of valid slugs instead of silently returning every car of the make. Empty = all models." }, "version": { "title": "Version (trim)", "type": "string", "description": "Model version words, like the \"Model version\" box on autoscout24: \"stepway\", \"gti\", \"touring\", \"amg\". Every word must appear in the listing's version title. A misspelt word is corrected from real listing titles when nothing matches (shown in the log). Empty = all versions." }, "country": { "title": "Country", "enum": [ "", "A", "B", "D", "E", "F", "I", "L", "NL" ], "type": "string", "description": "Where the car is offered. Empty = all 8 autoscout24 countries (the default when the field is left out); use `countries` for several. Only the listed codes are accepted — Apify refuses any other value before the run starts.", "default": "" }, "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": "Postcode or town to search around, inside ONE selected country: \"80331\", \"München\", \"80331 München\", \"1012\" (NL). English names of big towns (Munich, Vienna, Milan) are sent as the local name. If autoscout24 ignores the place or reads it as another town, the run stops and saves nothing. 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, all required: e.g. \"Navigation system\", \"Trailer hitch\", \"37\" (Guarantee), \"49\" (full service history). Letter case, spaces and hyphens do not matter. 141 options in README → Reference → Equipment; an unknown name fails the run with the closest names instead of being ignored (ignoring it would return cars without that equipment).", "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`. With any sort except standard, the sponsored cars autoscout24 pins to the top of every page are skipped (they break the order and reappear organically at their sorted position); price, mileage and power are also re-checked client-side so the dataset is strictly ordered.", "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. Search only: about 600 cars per minute. With \"Open listing pages\" about 1.5 s per car, so the default 1-hour timeout fits about 2 300 cars — a run that reaches the timeout stops in time and keeps the cars it saved.", "default": 40 }, "maxPages": { "title": "Max pages", "minimum": 1, "maximum": 200, "type": "integer", "description": "Optional cap on search pages (20 cars per page). Empty = pages are read until maxItems cars are saved or the search ends (autoscout24 serves at most 200 pages). Set it to bound a priceLabels scan; the status message says when maxPages stopped the run before maxItems." }, "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 (about 1.5 s each). A car whose page cannot be opened is still saved, with `detailError`; if autoscout24 blocks listing pages, the run stops there and ends with a status that says so.", "default": false }, "dedupe": { "title": "Deduplicate", "type": "boolean", "description": "Skip listing ids already seen in this run (sponsored cars repeat across pages).", "default": true }, "fields": { "title": "Output fields", "type": "array", "description": "Keep only these columns, in this order (e.g. \"price\", \"year\", \"mileageKm\", \"sellerPhones\"). `id` and `url` are always kept and come first unless you list them elsewhere. Empty = every column. Letter case and small typos are corrected (shown in the status); unknown names are ignored with a warning; the run fails if none is a column. Columns: README → Output.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }