{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Scraper — All EU Countries, Price Drop Alerts", "description": "Scrape AutoScout24 car listings in Germany, Italy, France, Netherlands, Belgium, Austria, Spain, Luxembourg or all of Europe: price, mileage, registration, power, fuel, gearbox, dealer, phone, location, images. Alerts for new listings and price drops.", "version": "0.1", "x-build-id": "GfHShyzWH4LCOATG7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/istmobot~autoscout24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-istmobot-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/istmobot~autoscout24-scraper/runs": { "post": { "operationId": "runs-sync-istmobot-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/istmobot~autoscout24-scraper/run-sync": { "post": { "operationId": "run-sync-istmobot-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", "type": "array", "description": "Optional. Paste any search results URL from autoscout24.de, .it, .fr, .nl, .be, .at, .es, .lu or .com (the page that lists cars, with /lst/ in the URL), with all the filters you set on the website. When you add URLs, the country and filter fields below are ignored.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Country sites to search when you use the filters below (one search per country). \"All Europe\" searches every country at once on autoscout24.com.", "items": { "type": "string", "enum": [ "DE", "AT", "BE", "ES", "FR", "IT", "LU", "NL", "EU" ], "enumTitles": [ "Germany (autoscout24.de)", "Austria (.at)", "Belgium (.be)", "Spain (.es)", "France (.fr)", "Italy (.it)", "Luxembourg (.lu)", "Netherlands (.nl)", "All Europe (.com)" ] } }, "make": { "title": "Make", "type": "string", "description": "Car make as shown on AutoScout24, e.g. BMW, Volkswagen, Mercedes-Benz, Fiat. Leave empty for all makes." }, "model": { "title": "Model", "type": "string", "description": "Optional. A model line (\"3 Series\", \"Golf\", \"C-Class\") or a single model (\"320\", \"Golf GTI\"). The local name used by that country site also works (\"3er\", \"Serie 3\"). If the model is unknown, the error row lists the available names." }, "priceMin": { "title": "Price from (EUR)", "minimum": 0, "type": "integer", "description": "Minimum price in euros." }, "priceMax": { "title": "Price up to (EUR)", "minimum": 0, "type": "integer", "description": "Maximum price in euros." }, "yearMin": { "title": "First registration from (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "e.g. 2018" }, "yearMax": { "title": "First registration up to (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "e.g. 2024" }, "mileageMax": { "title": "Max mileage (km)", "minimum": 0, "type": "integer", "description": "Maximum mileage in kilometres." }, "fuel": { "title": "Fuel", "type": "array", "description": "Any of these fuel types. Empty = all.", "items": { "type": "string", "enum": [ "gasoline", "diesel", "electric", "hybrid-gasoline", "hybrid-diesel", "lpg", "cng", "hydrogen", "ethanol", "other" ], "enumTitles": [ "Gasoline", "Diesel", "Electric", "Hybrid (electric/gasoline)", "Hybrid (electric/diesel)", "LPG", "CNG", "Hydrogen", "Ethanol", "Other" ] } }, "gearbox": { "title": "Gearbox", "type": "array", "description": "Any of these gearbox types. Empty = all.", "items": { "type": "string", "enum": [ "automatic", "manual", "semi-automatic" ], "enumTitles": [ "Automatic", "Manual", "Semi-automatic" ] } }, "sellerType": { "title": "Seller type", "enum": [ "any", "dealer", "private" ], "type": "string", "description": "Only dealer listings, only private sellers, or both.", "default": "any" }, "maxResults": { "title": "Max results per search", "minimum": 1, "type": "integer", "description": "Maximum listings for each search URL and each country. AutoScout24 shows at most 4,000 listings per search; above that, the Actor splits the search into price bands automatically to get more.", "default": 100 }, "includeDetails": { "title": "Include listing details", "type": "boolean", "description": "Opens each listing to add body type, color, GPS coordinates, listing date, full description, full equipment list, doors, seats, previous owners, accident-free flag, emission class and the market median price. Extra $0.00015 per listing.", "default": false }, "onlyNew": { "title": "Only new listings and price changes (monitoring mode)", "type": "boolean", "description": "Return only listings not seen by previous runs of the same search, plus listings whose price changed since then (with previousPrice and priceChanged). Schedule the Actor (e.g. daily) and connect it to Slack, email, Google Sheets or a webhook.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy is used to avoid rate limits. The Actor rotates to a fresh IP when a request is blocked.", "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 } } } } } } } } } }