{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Cars Scraper", "description": "AutoScout24 Cars Scraper SD - AutoScout24 Cars Scraper is a logged-out tool that extracts car listings from AutoScout24 searches and listing links across Europe: price, price rating, mileage, registration, power, fuel, equipment, description, images and dealer details.", "version": "1.0", "x-build-id": "0QXf8a9kenlm6vezN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neuro-scraper~autoscout24-cars-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neuro-scraper-autoscout24-cars-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/neuro-scraper~autoscout24-cars-scraper/runs": { "post": { "operationId": "runs-sync-neuro-scraper-autoscout24-cars-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/neuro-scraper~autoscout24-cars-scraper/run-sync": { "post": { "operationId": "run-sync-neuro-scraper-autoscout24-cars-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": { "startUrls": { "title": "Search or listing URLs", "type": "array", "description": "AutoScout24 links (autoscout24.de, .at, .it, .fr, .nl, .be, .es, .lu or .com): a search results page copied from the address bar - its own filters and sort are kept (https://www.autoscout24.de/lst/bmw/3er?atype=C&cy=D&pricefrom=5000) - or a single listing (https://www.autoscout24.de/angebote/...-). Labels such as fuel and equipment come in the site's language (autoscout24.com = English).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "make": { "title": "Make", "type": "string", "description": "Optional make as it appears in AutoScout24 links (lower case, spaces as '-'). Builds a search on the site chosen below with the filters below. Examples: bmw, volkswagen, mercedes-benz, alfa-romeo", "default": "" }, "model": { "title": "Model", "type": "string", "description": "Optional model of that make as it appears in AutoScout24 links. Examples: 3er (on .de), 3-series (on .com), golf, a4", "default": "" }, "domain": { "title": "Site for Make / filter searches", "enum": [ "de", "at", "it", "fr", "nl", "be", "es", "lu", "com" ], "type": "string", "description": "Which AutoScout24 site runs a Make / filter search. The site sets the language of labels and the default country filter. Search URLs keep their own site.", "default": "de" }, "countries": { "title": "Countries", "type": "array", "description": "Cars located in these countries (AutoScout24's 'cy' filter; any of them). Checked against the country list of the result page on every run. Empty = the site's default.", "items": { "type": "string", "enum": [ "D", "A", "B", "E", "F", "I", "L", "NL" ], "enumTitles": [ "Germany", "Austria", "Belgium", "Spain", "France", "Italy", "Luxembourg", "Netherlands" ] }, "default": [] }, "condition": { "title": "Condition", "enum": [ "any", "new", "used" ], "type": "string", "description": "New or used cars (AutoScout24 'ustate' filter).", "default": "any" }, "priceFrom": { "title": "Price from (EUR)", "minimum": 0, "type": "integer", "description": "Minimum price ('pricefrom'). Example: 5000" }, "priceTo": { "title": "Price to (EUR)", "minimum": 0, "type": "integer", "description": "Maximum price ('priceto'). Example: 45000" }, "yearFrom": { "title": "First registration from (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Earliest first-registration year ('fregfrom'). Example: 2018" }, "yearTo": { "title": "First registration to (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Latest first-registration year ('fregto'). Example: 2024" }, "mileageFrom": { "title": "Mileage from (km)", "minimum": 0, "type": "integer", "description": "Minimum mileage ('kmfrom'). Example: 10000" }, "mileageTo": { "title": "Mileage to (km)", "minimum": 0, "type": "integer", "description": "Maximum mileage ('kmto'). Example: 100000" }, "powerFromKw": { "title": "Power from (kW)", "minimum": 0, "type": "integer", "description": "Minimum power in kW ('powerfrom', powertype=kw). Example: 100" }, "powerToKw": { "title": "Power to (kW)", "minimum": 0, "type": "integer", "description": "Maximum power in kW ('powerto'). Example: 250" }, "fuelType": { "title": "Fuel type", "type": "array", "description": "Only these fuels ('fuel'; any of them). Empty = all.", "items": { "type": "string", "enum": [ "B", "D", "E", "2", "3", "L", "C", "M", "H", "O" ], "enumTitles": [ "Petrol", "Diesel", "Electric", "Hybrid (petrol/electric)", "Hybrid (diesel/electric)", "LPG", "CNG", "Ethanol", "Hydrogen", "Other" ] }, "default": [] }, "transmission": { "title": "Transmission", "type": "array", "description": "Only these gearboxes ('gear'; any of them). Empty = all.", "items": { "type": "string", "enum": [ "A", "M", "S" ], "enumTitles": [ "Automatic", "Manual", "Semi-automatic" ] }, "default": [] }, "bodyType": { "title": "Body type", "type": "array", "description": "Only these body types ('body'; any of them). Empty = all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "12", "13" ], "enumTitles": [ "Compact", "Convertible", "Coupe", "SUV / off-road / pick-up", "Station wagon", "Sedan", "Other", "Van", "Transporter" ] }, "default": [] }, "sellerType": { "title": "Seller type", "enum": [ "any", "dealer", "private" ], "type": "string", "description": "Dealers, private sellers or both ('custtype').", "default": "any" }, "zip": { "title": "Postcode", "type": "string", "description": "Search around this postcode ('zip'; use with Radius). Example: 10115", "default": "" }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Distance from the postcode ('zipr'). AutoScout24 offers 10, 20, 50, 100, 150, 200, 250, 300, 400 (checked on every run). Example: 50" }, "sort": { "title": "Sort order", "enum": [ "standard", "price", "age", "mileage", "year", "power", "make", "distance" ], "type": "string", "description": "AutoScout24's own result order (checked against the page's sort list on every run).", "default": "standard" }, "sortDescending": { "title": "Sort descending", "type": "boolean", "description": "Highest first ('desc=1'). Newest listings first = Sort 'Newest listings' + descending.", "default": false }, "customFilters": { "title": "More AutoScout24 filters", "type": "array", "description": "Any other AutoScout24 search parameter as name=value, copied from a search URL (one per line). Example: damaged_listing=include", "default": [], "items": { "type": "string" } }, "includeKeywords": { "title": "Include keywords", "type": "array", "description": "Keep only cars whose title, subtitle or description contains one of these words (checked by this Actor). Example: xenon", "default": [], "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop cars whose title, subtitle or description contains one of these words (checked by this Actor). Example: export", "default": [], "items": { "type": "string" } }, "maxAgeMinutes": { "title": "Max listing age (minutes)", "minimum": 0, "type": "integer", "description": "Keep only listings created within this many minutes (needs Include details; with Sort 'Newest listings' + descending the search stops at the first older page). 0 = no limit. Example: 1440", "default": 0 }, "includeDetails": { "title": "Include details", "type": "boolean", "description": "Open every listing for its description, body type, colours, seats, doors, equipment, accident and service history, owners, emission class, coordinates and creation date (one extra page per car).", "default": true }, "descriptionFormat": { "title": "Description format", "enum": [ "text", "html", "markdown", "all" ], "type": "string", "description": "Which description columns to fill (with Include details).", "default": "text" }, "descriptionMaxLength": { "title": "Description max length", "minimum": 0, "type": "integer", "description": "Cut descriptions to this many characters. 0 = full text. Example: 500", "default": 0 }, "maxItems": { "title": "Max items per search", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of cars per search URL or Make / filter search (listing URLs give one car each). Result pages (20 cars each) are read one after another until this number or the end of the results.", "default": 20 }, "splitLargeSearches": { "title": "Get more results (split by price)", "type": "boolean", "description": "AutoScout24 shows only a limited number of result pages per search (200 pages on a 63,421-car search, measured). When Max items asks for more, the search is split into price bands, each read to its end.", "default": true }, "maxConcurrency": { "title": "Parallel detail pages", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many listing pages are opened at the same time (each on its own proxy session).", "default": 3 }, "incrementalMode": { "title": "Incremental mode", "type": "boolean", "description": "Remember the cars seen in earlier runs (in a named key-value store) and mark each row NEW, PRICE_CHANGED or UNCHANGED. Unchanged cars are skipped unless 'Emit unchanged' is on.", "default": false }, "stateKey": { "title": "State key", "type": "string", "description": "Name of the incremental-mode memory, so different monitored searches keep separate states. Example: bmw-berlin", "default": "default" }, "emitUnchanged": { "title": "Emit unchanged listings", "type": "boolean", "description": "In incremental mode, also output cars that did not change since the last run.", "default": false }, "emitExpired": { "title": "Emit expired listings", "type": "boolean", "description": "In incremental mode, output a row (changeType EXPIRED) for every car of a search read to its end that is no longer listed.", "default": false }, "skipReposts": { "title": "Skip reposts", "type": "boolean", "description": "In incremental mode, skip cars that the same seller re-listed under a new listing id (same make, model, version, registration, mileage, power, fuel). Without it they are marked isRepost.", "default": false }, "compact": { "title": "Compact output", "type": "boolean", "description": "Only the main columns (id, URL, title, make, model, price, mileage, registration, fuel, gearbox, power, location, seller type, image, date).", "default": false }, "excludeEmptyFields": { "title": "Exclude empty fields", "type": "boolean", "description": "Leave out columns that are empty for a car (rows then differ in their columns).", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "AutoScout24 blocks many non-European and datacenter addresses (CloudFront 403). A German residential proxy is the default and was measured to work.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DE" } } } }, "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 } } } } } } } } } }