{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Scraper - Car Listings, Prices, Mileage, Dealers", "description": "Scrape public AutoScout24 car listings without login: search by make, model, price, year, fuel or paste search and listing URLs. Price, mileage, first registration, power, dealer, location, photos. No cookies, no proxy needed.", "version": "0.1", "x-build-id": "G8GDT4fG19yG3jUou" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapefy~autoscout24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapefy-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/scrapefy~autoscout24-scraper/runs": { "post": { "operationId": "runs-sync-scrapefy-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/scrapefy~autoscout24-scraper/run-sync": { "post": { "operationId": "run-sync-scrapefy-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": { "searches": { "title": "Searches (make, model, filters)", "type": "array", "description": "List of search objects. Each object can have: country (de, at, it, es, fr, nl, be, lu or com for Europe-wide), make and model (as in the AutoScout24 URL, for example 'bmw' and '320' or 'mercedes-benz'), priceFrom, priceTo, yearFrom, yearTo (first registration), mileageTo (km), powerFromKw, fuelType (B petrol, D diesel, E electric, 2 hybrid petrol, 3 hybrid diesel, L LPG, C CNG), transmission (A automatic, M manual), condition (new, used, any), sort (standard, price, age, mileage, power) and descending (true or false). Each search returns up to 'Max listings per input' cars." }, "searchUrls": { "title": "Search result URLs", "type": "array", "description": "Links to AutoScout24 search result pages that you configured on the website, for example https://www.autoscout24.de/lst/audi/a3?fregfrom=2019&priceto=25000 (any country site: .de, .at, .it, .es, .fr, .nl, .be, .lu, .com). Filters in the link are kept; page and size are set by the Actor.", "items": { "type": "string" } }, "itemUrls": { "title": "Listing URLs", "type": "array", "description": "Links to single listings, for example https://www.autoscout24.de/angebote/jeep-avenger-...-0ca47865-31ae-416c-ac3a-87609affb34e, or just the listing id (UUID). Each link returns the full listing including description, equipment and coordinates.", "items": { "type": "string" } }, "maxItems": { "title": "Max listings per input", "minimum": 1, "maximum": 4000, "type": "integer", "description": "Maximum number of listings returned for each search or search URL (20 per page; AutoScout24 serves at most 200 pages, so 4,000 per search). Keeps the cost of a run predictable: you are charged per listing returned. Single listing URLs always return one listing.", "default": 50 }, "includeDetails": { "title": "Add full details to search results", "type": "boolean", "description": "Open each listing's own page for the full description, equipment list, body type, colour, doors, seats, owners, consumption, coordinates and listing date. Slower (one extra request per listing) and charged as an extra 'listing detail' event per listing. Listing URLs always include details.", "default": false }, "useProxy": { "title": "Use Apify proxy", "type": "boolean", "description": "Route requests through the Apify datacenter proxy. Not needed normally; turn it on only if AutoScout24 starts answering with 403 from your region.", "default": false } } }, "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 } } } } } } } } } }