{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Scraper: Car Listings, Prices & Specs", "description": "Scrape AutoScout24 car listings from 8 European countries by search URL or simple make/model/price/year filters. Clean English fields: price, mileage, fuel, gearbox, power, location, dealer, AS24 price rating. Optional detail pages: equipment, description, images, VAT, market median. Unofficial.", "version": "0.1", "x-build-id": "DY5h7tVXYEY73thSM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kyungminlee~autoscout24-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kyungminlee-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/kyungminlee~autoscout24-listings-scraper/runs": { "post": { "operationId": "runs-sync-kyungminlee-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/kyungminlee~autoscout24-listings-scraper/run-sync": { "post": { "operationId": "run-sync-kyungminlee-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": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "AutoScout24 search result URLs copied from your browser, one per line, for example `https://www.autoscout24.de/lst/bmw/3er?fregfrom=2018&priceto=30000`. Every filter in the URL is kept. Works on autoscout24.com, .de, .at, .be, .fr, .it, .nl, .es and .lu. The URL must contain a make (…/lst/…); autoscout24.ch is a different platform and is not supported. You can use URLs, the filters below, or both.", "items": { "type": "string" } }, "make": { "title": "Make", "type": "string", "description": "Car make for a search without a URL, for example `BMW`, `Volkswagen`, `Mercedes-Benz`, `Alfa Romeo`. Leave empty if you only use search URLs." }, "model": { "title": "Model", "type": "string", "description": "Optional model or model range, for example `3 Series` (or `3er`, `Serie 3`), `Golf`, `C-Klasse`, `Model 3`. AutoScout24 understands the model name in any of its site languages. Leave empty for all models of the make." }, "countries": { "title": "Countries", "uniqueItems": true, "type": "array", "description": "Countries where the cars are offered. Pick several to search them together. Leave empty for the site's default (all 8 countries on autoscout24.com, the home country on the national sites).", "items": { "type": "string", "enum": [ "DE", "AT", "BE", "ES", "FR", "IT", "LU", "NL" ], "enumTitles": [ "Germany", "Austria", "Belgium", "Spain", "France", "Italy", "Luxembourg", "Netherlands" ] } }, "site": { "title": "Site language", "enum": [ "com", "de", "at", "be", "fr", "it", "nl", "es", "lu" ], "type": "string", "description": "Which AutoScout24 site to use for the filter search. It decides the language of free-text fields (equipment names, description, body type) and the domain of the listing URLs. Normalized fields such as `fuel`, `transmission` and `condition` are always in English.", "default": "com" }, "priceFrom": { "title": "Price from", "minimum": 0, "type": "integer", "description": "Minimum price in euros." }, "priceTo": { "title": "Price to", "minimum": 0, "type": "integer", "description": "Maximum price in euros." }, "yearFrom": { "title": "First registration from (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Earliest first-registration year, for example `2018`." }, "yearTo": { "title": "First registration to (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Latest first-registration year." }, "mileageFrom": { "title": "Mileage from", "minimum": 0, "type": "integer", "description": "Minimum mileage in kilometres." }, "mileageTo": { "title": "Mileage to", "minimum": 0, "type": "integer", "description": "Maximum mileage in kilometres, for example `100000`." }, "fuelTypes": { "title": "Fuel types", "uniqueItems": true, "type": "array", "description": "Only these fuel types. Leave empty for all.", "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" ] } }, "transmissions": { "title": "Transmission", "uniqueItems": true, "type": "array", "description": "Only these gearbox types. Leave empty for all.", "items": { "type": "string", "enum": [ "automatic", "manual", "semi-automatic" ], "enumTitles": [ "Automatic", "Manual", "Semi-automatic" ] } }, "bodyTypes": { "title": "Body types", "uniqueItems": true, "type": "array", "description": "Only these body types. Leave empty for all.", "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 / minibus", "Transporter", "Other" ] } }, "conditions": { "title": "Condition", "uniqueItems": true, "type": "array", "description": "Only these offer types. Leave empty for the site's default.", "items": { "type": "string", "enum": [ "used", "new", "employee-car", "classic", "demonstration", "pre-registered" ], "enumTitles": [ "Used", "New", "Employee's car (Jahreswagen)", "Classic", "Demonstration", "Pre-registered" ] } }, "powerFromKw": { "title": "Power from", "minimum": 0, "type": "integer", "description": "Minimum engine power in kW (1 kW = 1.36 hp)." }, "powerToKw": { "title": "Power to", "minimum": 0, "type": "integer", "description": "Maximum engine power in kW." }, "sellerType": { "title": "Seller type", "enum": [ "any", "dealer", "private" ], "type": "string", "description": "Only dealer or only private listings. Private sellers' names and phone numbers are never collected either way.", "default": "any" }, "zip": { "title": "Postal code", "type": "string", "description": "Optional postal code to search around, for example `10115` (Berlin). Use it with one country so the code is unambiguous." }, "radiusKm": { "title": "Radius around postal code", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Search radius around the postal code. AutoScout24 offers 10, 20, 50, 100, 150, 200, 250, 300 and 400 km.", "default": 50 }, "sort": { "title": "Sort order", "enum": [ "newest", "standard", "price-asc", "price-desc", "mileage-asc", "year-desc" ], "type": "string", "description": "Order of the filter search. Search URLs keep the sort order that is in the URL.", "default": "newest" }, "maxListingsPerSearch": { "title": "Maximum listings per search", "minimum": 1, "maximum": 100000, "type": "integer", "description": "How many listings to save for each search URL and for the filter search. AutoScout24 shows at most 4,000 listings per search; above that the Actor splits the search into price bands (see below). The run's maximum charge can stop it earlier.", "default": 500 }, "splitLargeSearches": { "title": "Split large searches by price", "type": "boolean", "description": "When a search has more than 4,000 results and you ask for more than 4,000 listings, split it into price bands that each stay under the limit, so you can collect all of them. Listings without a price (price on request) are not included in price bands.", "default": true }, "includeDetails": { "title": "Include listing details", "type": "boolean", "description": "Also open every listing page and add the equipment list, full description, all image URLs, VAT information, AutoScout24's market median price and price bands, previous owners, accident and service history, colour, body type, emissions and more. One extra request per listing (slower) and charged as an extra `listing-detail` event.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify datacenter proxy (default) spreads requests over several IPs and switches to a fresh IP if AutoScout24 slows one down. You can turn it off; requests then come from the run's own IP at a slower pace.", "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 } } } } } } } } } }