{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Scraper & API - Car Listings, Prices & Dealers", "description": "Use this to get car listings from AutoScout24 (DE, AT, BE, ES, FR, IT, LU, NL). Input: make, model, countries, filters (price, year, km, fuel, gearbox, body, seller) or AutoScout24 URLs. One result = one listing: title, year, km, fuel, gearbox, power, price with rating, seller, URL. $0.29 per 1,000.", "version": "1.0", "x-build-id": "DjvI0wc6r6rFeMeGZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rel8ble~autoscout24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rel8ble-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/rel8ble~autoscout24-scraper/runs": { "post": { "operationId": "runs-sync-rel8ble-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/rel8ble~autoscout24-scraper/run-sync": { "post": { "operationId": "run-sync-rel8ble-autoscout24-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "make": { "title": "Make", "type": "string", "description": "Car make as AutoScout24 writes it: \"Volkswagen\", \"BMW\", \"Mercedes-Benz\", \"Audi\", \"Land Rover\", \"Citroen\", \"Skoda\". Leave empty to search every make (then give at least one filter below)." }, "model": { "title": "Model", "type": "string", "description": "Optional. Model as the English site (autoscout24.com) writes it: \"Golf\", \"A4\", \"3 Series\", \"C 220\", \"X3\", \"Model 3\", \"Fiesta\". Model lines like \"3 Series\" or \"C-Class\" work too. If AutoScout24 does not recognise the model, the run warns and returns the whole make. Needs a make." }, "searches": { "title": "More make / model lines", "type": "array", "description": "Optional. Extra searches, one per line, written as \"Make Model\" or \"Make | Model\": \"BMW X3\", \"Audi | A6\", \"Tesla Model 3\", \"Porsche\" (make only). All lines use the same countries and filters as the fields below. Typical: 1-50 lines.", "items": { "type": "string" } }, "startUrls": { "title": "AutoScout24 URLs", "type": "array", "description": "Optional. AutoScout24 listing-search URLs copied from any country site, e.g. \"https://www.autoscout24.de/lst/audi/a4?atype=C&cy=D&fregfrom=2019&priceto=30000\", or single offer pages (\".../angebote/...\" / \".../offers/...\"). A search URL is used with its own filters exactly as copied (the filter fields below are NOT applied to URLs). An offer URL gives one full row (details included).", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Which AutoScout24 markets to search: DE Germany (default, the biggest), AT Austria, BE Belgium, ES Spain, FR France, IT Italy, LU Luxembourg, NL Netherlands. Several = one combined search. Prices are in EUR everywhere.", "items": { "type": "string", "enum": [ "DE", "AT", "BE", "ES", "FR", "IT", "LU", "NL" ], "enumTitles": [ "Germany", "Austria", "Belgium", "Spain", "France", "Italy", "Luxembourg", "Netherlands" ] }, "default": [ "DE" ] }, "vehicleType": { "title": "Vehicle type", "enum": [ "car", "motorbike" ], "type": "string", "description": "\"car\" (default) or \"motorbike\" (AutoScout24's motorbike listings: make, model, price, mileage, first registration, power).", "default": "car" }, "offerTypes": { "title": "Offer type (new / used)", "type": "array", "description": "Optional. Any of \"new\", \"used\", \"pre-registered\", \"demonstration\", \"employee-car\", \"classic\". Empty = new and used (AutoScout24's default).", "items": { "type": "string", "enum": [ "new", "used", "pre-registered", "demonstration", "employee-car", "classic" ], "enumTitles": [ "New", "Used", "Pre-registered (day registration)", "Demonstration vehicle", "Employee's car (one year old)", "Classic car (oldtimer)" ] } }, "priceFrom": { "title": "Price from (EUR)", "type": "string", "description": "Optional. Lowest price in EUR, e.g. \"5000\"." }, "priceTo": { "title": "Price to (EUR)", "type": "string", "description": "Optional. Highest price in EUR, e.g. \"30000\"." }, "yearFrom": { "title": "First registration from (year)", "type": "string", "description": "Optional. Earliest first-registration year, e.g. \"2018\"." }, "yearTo": { "title": "First registration to (year)", "type": "string", "description": "Optional. Latest first-registration year, e.g. \"2022\"." }, "mileageFrom": { "title": "Mileage from (km)", "type": "string", "description": "Optional. Minimum mileage in kilometres." }, "mileageTo": { "title": "Mileage to (km)", "type": "string", "description": "Optional. Maximum mileage in kilometres, e.g. \"100000\"." }, "fuels": { "title": "Fuel", "type": "array", "description": "Optional. Any of \"petrol\", \"diesel\", \"electric\", \"hybrid-petrol\", \"hybrid-diesel\", \"lpg\", \"cng\", \"hydrogen\", \"ethanol\", \"other\". Empty = all fuels.", "items": { "type": "string", "enum": [ "petrol", "diesel", "electric", "hybrid-petrol", "hybrid-diesel", "lpg", "cng", "hydrogen", "ethanol", "other" ], "enumTitles": [ "Petrol (gasoline)", "Diesel", "Electric", "Hybrid (electric/petrol)", "Hybrid (electric/diesel)", "LPG (autogas)", "CNG (natural gas)", "Hydrogen", "Ethanol", "Other" ] } }, "gearboxes": { "title": "Gearbox", "type": "array", "description": "Optional. Any of \"automatic\", \"manual\", \"semi-automatic\". Empty = all.", "items": { "type": "string", "enum": [ "automatic", "manual", "semi-automatic" ], "enumTitles": [ "Automatic", "Manual", "Semi-automatic" ] } }, "bodyTypes": { "title": "Body type", "type": "array", "description": "Optional (cars). Any of \"compact\", \"convertible\", \"coupe\", \"suv\", \"station-wagon\", \"sedan\", \"van\", \"transporter\", \"other\". Empty = all.", "items": { "type": "string", "enum": [ "compact", "convertible", "coupe", "suv", "station-wagon", "sedan", "van", "transporter", "other" ], "enumTitles": [ "Compact / small car", "Convertible", "Coupe", "SUV / off-road / pickup", "Station wagon (estate)", "Sedan (saloon)", "Van / minibus", "Transporter", "Other" ] } }, "sellerType": { "title": "Seller type", "enum": [ "any", "dealer", "private" ], "type": "string", "description": "\"any\" (default), \"dealer\" (dealers only, with company name, rating and phone) or \"private\" (private sellers only; no names or phone numbers are collected for private sellers).", "default": "any" }, "powerFrom": { "title": "Power from (kW)", "type": "string", "description": "Optional. Minimum engine power in kW (1 kW = 1.36 hp), e.g. \"100\"." }, "powerTo": { "title": "Power to (kW)", "type": "string", "description": "Optional. Maximum engine power in kW." }, "onlineSinceDays": { "title": "Listed within (days)", "type": "string", "description": "Optional. Only listings published in the last N days: 1 (today), 2, 3, 4, 5, 6, 7 or 14. Use 1 with a daily schedule to collect new listings only." }, "sort": { "title": "Sort order", "enum": [ "relevance", "price-asc", "price-desc", "mileage-asc", "mileage-desc", "year-desc", "year-asc", "power-desc", "power-asc", "newest" ], "type": "string", "description": "Order of the results (= order of the rows): \"relevance\" (AutoScout24's best results), \"price-asc\", \"price-desc\", \"mileage-asc\", \"mileage-desc\", \"year-desc\", \"year-asc\", \"power-desc\", \"power-asc\", \"newest\" (newest listings first).", "default": "relevance" }, "includeSponsored": { "title": "Include sponsored listings", "type": "boolean", "description": "Default true: sponsored / boosted listings are kept and flagged isSponsored. False = drop them.", "default": true }, "includeDetails": { "title": "Include offer details", "type": "boolean", "description": "Default false. True opens every listing's offer page (one extra request per listing, about 0.5 MB each) and adds: description, body type, doors, seats, colour, paint, upholstery, cylinders, drive train, emission class, consumption, CO2, previous owners, accident flag, service history, inspection, warranty, equipment list, market median price, VAT / net price, coordinates, listed-at time, all images. Prices are the same; it only takes longer.", "default": false }, "deepSearch": { "title": "Deep search past 4,000 listings", "type": "boolean", "description": "AutoScout24 serves at most 200 pages (4,000 listings) for one search. Default true: a bigger search is split automatically into price bands (then registration years, then mileage bands) and merged without duplicates, so \"all used Volkswagen Golf in Germany\" (20,000+) comes back complete. False = stop at 4,000. URL searches are never split.", "default": true }, "maxItemsPerSearch": { "title": "Max listings per search", "minimum": 0, "type": "integer", "description": "Stop each search (each make/model line or URL) after this many listings. 0 = no limit (everything AutoScout24 has). Default 1000; the form starts at 20 so a first try finishes in seconds.", "default": 1000 }, "maxItems": { "title": "Max listings in total", "minimum": 0, "type": "integer", "description": "Stop the whole run after this many listings. 0 = no limit. Default 5000 (= $1.45). The run also stops cleanly at the \"Maximum cost per run\" you set.", "default": 5000 }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many pages to fetch at once. Default 4; lower it to 2 if you see rate-limit warnings.", "default": 4 }, "maxRequestRetries": { "title": "Retries per page", "minimum": 0, "maximum": 20, "type": "integer", "description": "How often a failed page is retried on a new session before it is given up. Default 5.", "default": 5 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Default: Apify Proxy (datacenter) for IP rotation. AutoScout24 serves datacenter IPs; residential proxies are not needed.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }