{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Scraper: Used Cars in 8 Countries, Deals & Alerts", "description": "AutoScout24 scraper & used car API: car listings from AutoScout24 in Germany, France, Italy, Spain, Netherlands, Belgium, Austria, Luxembourg in one run. Price, mileage, year, fuel, dealer or private, market price of similar cars, deal score, cheapest country, new-listing and price-drop alerts.", "version": "0.1", "x-build-id": "bDyHRJldgI6LAd2IX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/euroscrape~autoscout24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-euroscrape-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/euroscrape~autoscout24-scraper/runs": { "post": { "operationId": "runs-sync-euroscrape-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/euroscrape~autoscout24-scraper/run-sync": { "post": { "operationId": "run-sync-euroscrape-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", "required": [ "searches" ], "properties": { "searches": { "title": "Searches", "type": "array", "description": "One car per line: make and model as written on AutoScout24 (\"BMW 320\", \"Volkswagen Golf\", \"Tesla Model 3\", \"Mercedes-Benz C 220\"), or a make alone (\"Dacia\"), or a full AutoScout24 results URL with your own filters.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "AutoScout24 country sites to search. Prices are in euros everywhere.", "items": { "type": "string", "enum": [ "DE", "AT", "BE", "ES", "FR", "IT", "LU", "NL" ], "enumTitles": [ "Germany", "Austria", "Belgium", "Spain", "France", "Italy", "Luxembourg", "Netherlands" ] }, "default": [ "DE", "AT", "BE", "ES", "FR", "IT", "LU", "NL" ] }, "maxListingsPerSearchAndCountry": { "title": "Max listings per search and country", "minimum": 1, "maximum": 400, "type": "integer", "description": "Up to 400 (AutoScout24 shows 20 pages of 20). The market summary is computed on everything collected.", "default": 50 }, "sortBy": { "title": "Sort", "enum": [ "relevance", "price_asc", "price_desc", "newest", "mileage_asc", "year_desc" ], "type": "string", "description": "Order of the site's results, which decides which listings are collected when the cap is reached.", "default": "relevance" }, "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": "E.g. 2018." }, "yearTo": { "title": "First registration to (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Latest first-registration year to keep, e.g. 2022." }, "mileageFrom": { "title": "Mileage from (km)", "minimum": 0, "type": "integer", "description": "Minimum mileage in km." }, "mileageTo": { "title": "Mileage to (km)", "minimum": 0, "type": "integer", "description": "E.g. 100000." }, "powerFromKw": { "title": "Power from (kW)", "minimum": 0, "type": "integer", "description": "Minimum engine power in kW (e.g. 100 kW = 136 hp)." }, "fuelTypes": { "title": "Fuel types", "type": "array", "description": "Leave empty for all.", "items": { "type": "string", "enum": [ "petrol", "diesel", "electric", "hybrid", "lpg", "cng", "hydrogen", "ethanol" ], "enumTitles": [ "Petrol", "Diesel", "Electric", "Hybrid (petrol or diesel)", "LPG", "CNG", "Hydrogen", "Ethanol" ] }, "default": [] }, "gearbox": { "title": "Gearbox", "enum": [ "any", "manual", "automatic" ], "type": "string", "description": "Manual, automatic or both.", "default": "any" }, "sellerType": { "title": "Seller type", "enum": [ "any", "dealer", "private" ], "type": "string", "description": "Dealers, private sellers or both.", "default": "any" }, "condition": { "title": "Condition", "enum": [ "any", "used", "new" ], "type": "string", "description": "New cars, used cars or both.", "default": "any" }, "includeDamaged": { "title": "Include damaged cars", "type": "boolean", "description": "Accident-damaged cars are excluded by default (they distort market prices).", "default": false }, "minDealScore": { "title": "Minimum deal score", "minimum": 0, "maximum": 100, "type": "integer", "description": "Keep only listings priced below similar cars: 60 = at least 10% under the market price of comparable cars, 50 = at market price. Leave empty to keep everything." }, "includeMarketSummary": { "title": "Market summary", "type": "boolean", "description": "One free row per search: median price, mileage and year per country, cheapest and priciest country, dealers vs private sellers, by fuel, by year, top deals.", "default": true }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Name this search and schedule the Actor (e.g. every morning): each run then returns only NEW listings and PRICE DROPS since the previous run, with alerts below. The first run saves the baseline." }, "alertOn": { "title": "Monitor: what to return", "enum": [ "new_and_price_drops", "new", "price_drops" ], "type": "string", "description": "In monitor mode, what each run returns and alerts on.", "default": "new_and_price_drops" }, "telegramBotToken": { "title": "Telegram bot token", "type": "string", "description": "Alerts on Telegram: create a bot with @BotFather and paste its token." }, "telegramChatId": { "title": "Telegram chat ID", "type": "string", "description": "Your chat ID (send a message to your bot, then open api.telegram.org/bot/getUpdates)." }, "discordWebhookUrl": { "title": "Discord webhook", "type": "string", "description": "Alerts in a Discord channel: Channel settings → Integrations → Webhooks." }, "slackWebhookUrl": { "title": "Slack webhook", "type": "string", "description": "Alerts in Slack: create an Incoming Webhook for your channel." }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Receives one POST per run with the new listings and price drops (Make, Zapier, n8n…)." }, "maxNotifications": { "title": "Max alerts per run", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of alert messages per run.", "default": 30 }, "proxy": { "title": "Proxy", "type": "object", "description": "Apify Proxy is recommended: datacenter IPs first, residential only if AutoScout24 blocks the request.", "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 } } } } } } } } } }