{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Scraper — Used Car Listings & Prices API | $0.49/1k", "description": "Scrape AutoScout24 used car listings from every European country site: price, price rating, make, model, first registration, mileage, fuel, gearbox, power, location, dealer name and photos. Search by URL or by make, model, price and year. No login. Export CSV, JSON or Excel.", "version": "0.1", "x-build-id": "9E0UpAcYcFvMyRZvv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/glasswing~autoscout24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-glasswing-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/glasswing~autoscout24-scraper/runs": { "post": { "operationId": "runs-sync-glasswing-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/glasswing~autoscout24-scraper/run-sync": { "post": { "operationId": "run-sync-glasswing-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": { "startUrls": { "title": "AutoScout24 search URLs", "uniqueItems": true, "type": "array", "description": "Search result pages copied from your browser on any AutoScout24 country site, e.g. https://www.autoscout24.com/lst/bmw/x5?cy=D&priceto=40000. Every filter in the URL is kept. Listing pages (/offers/...) and other sites are not supported and return one unbilled error row. You can leave the example in place when you use the search fields below: the untouched example is skipped automatically as soon as a search field is filled in.", "default": [ "https://www.autoscout24.com/lst/bmw?atype=C&cy=D&sort=standard&desc=0" ], "items": { "type": "string" } }, "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many listings have been saved, across all searches. Each saved listing with status `ok` is one billable result. The site serves 20 listings per page and at most 200 pages (4,000 listings) per search; split bigger pulls by price or year ranges.", "default": 20 }, "make": { "title": "Make", "type": "string", "description": "Car make as AutoScout24 writes it in its URLs, e.g. bmw, volkswagen, mercedes-benz, audi, fiat, land-rover. Spaces and capitals are fine (\"Mercedes-Benz\" works). An unknown make returns one unbilled not_found row instead of unrelated cars." }, "model": { "title": "Model", "type": "string", "description": "Model as AutoScout24 writes it in its URLs, e.g. x5, golf, a4, 500, clio. Needs Make. An unknown model returns one unbilled not_found row instead of every car of the make." }, "country": { "title": "Country", "enum": [ "DE", "AT", "BE", "ES", "FR", "IT", "LU", "NL" ], "type": "string", "description": "Only listings located in this country. Empty = all AutoScout24 countries." }, "priceFrom": { "title": "Price from (EUR)", "minimum": 1, "type": "integer", "description": "Lowest asking price in euros, e.g. `5000`." }, "priceTo": { "title": "Price up to (EUR)", "minimum": 1, "type": "integer", "description": "Highest asking price in euros, e.g. `20000`." }, "yearFrom": { "title": "First registration from (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Earliest year of first registration, e.g. 2018." }, "yearTo": { "title": "First registration up to (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Latest year of first registration, e.g. 2022." }, "mileageMax": { "title": "Mileage up to (km)", "minimum": 1, "type": "integer", "description": "Highest mileage in kilometres, e.g. `100000`." }, "fuel": { "title": "Fuel", "enum": [ "gasoline", "diesel", "electric", "hybrid-gasoline", "hybrid-diesel", "lpg", "cng", "hydrogen", "ethanol", "other" ], "type": "string", "description": "Fuel type." }, "bodyType": { "title": "Body type", "enum": [ "compact", "convertible", "coupe", "suv", "station-wagon", "sedan", "van", "transporter", "other" ], "type": "string", "description": "Body type. When set, every row carries it in `bodyType` (the search page does not print it per listing otherwise)." }, "sellerType": { "title": "Seller type", "enum": [ "dealer", "private" ], "type": "string", "description": "Only dealer listings or only private listings. Empty = both." }, "sort": { "title": "Sort order", "enum": [ "standard", "price_asc", "price_desc", "year_desc", "mileage_asc", "power_desc" ], "type": "string", "description": "Order of the search built from the fields above (URLs keep their own order).", "default": "standard" }, "domain": { "title": "Country site (language of the rows)", "enum": [ "com", "de", "at", "it", "fr", "es", "nl", "lu", "pl" ], "type": "string", "description": "Which AutoScout24 site runs the search built from the fields. It only changes the language of text fields such as fuel and transmission (autoscout24.de answers \"Benzin\", .com \"Gasoline\"); use Country to choose where the cars are.", "default": "com" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. The Actor works from Apify's datacenter without a proxy. Enable Apify Proxy (datacenter) only if you see blocked requests; residential proxies are not needed.", "default": { "useApifyProxy": 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 } } } } } } } } } }