{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Scraper - Gebrauchtwagen Scraper & Price Monitor", "description": "Used car listings from autoscout24.de by make, model, price, mileage, year, fuel and ZIP radius: price, first registration, km, power, dealer and location in one row. New-listings and price-drop monitor for dealers, car buyers and market analysts.", "version": "1.0", "x-build-id": "kQRgjN8fcRBrPdkTe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kamerozkan~autoscout24-germany-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kamerozkan-autoscout24-germany-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/kamerozkan~autoscout24-germany-scraper/runs": { "post": { "operationId": "runs-sync-kamerozkan-autoscout24-germany-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/kamerozkan~autoscout24-germany-scraper/run-sync": { "post": { "operationId": "run-sync-kamerozkan-autoscout24-germany-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": { "make": { "title": "Make", "type": "string", "description": "Car make as written on autoscout24.de, for example \"BMW\", \"Volkswagen\", \"Mercedes-Benz\" or \"Audi\". Leave empty with a ZIP code to get all makes around a place.", "default": "BMW" }, "model": { "title": "Model", "type": "string", "description": "Model or model group as in the AutoScout24 URL, for example \"3er\", \"Golf\", \"C-Klasse\" or \"A4\". Leave empty for all models of the make.", "default": "3er" }, "country": { "title": "Country", "enum": [ "D", "A", "B", "E", "F", "I", "L", "NL" ], "type": "string", "description": "Country of the listings (AutoScout24 cy filter).", "default": "D" }, "searchUrls": { "title": "AutoScout24 search URLs", "type": "array", "description": "Optional. Result-list URLs copied from autoscout24.de (they start with https://www.autoscout24.de/lst), with any filters already applied. Read in addition to the make and model search; the filters below are added to them.", "items": { "type": "string" } }, "offerTypes": { "title": "Offer types", "type": "array", "description": "Leave empty for all: used, new, demonstration (Vorführwagen), pre-registered (Jahreswagen) and classic cars.", "items": { "type": "string", "enum": [ "used", "new", "demonstration", "pre-registered", "classic" ], "enumTitles": [ "Used (Gebrauchtwagen)", "New (Neuwagen)", "Demonstration car (Vorführwagen)", "Pre-registered (Jahreswagen)", "Classic (Oldtimer)" ] } }, "priceFrom": { "title": "Price from (EUR)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Minimum price in EUR." }, "priceTo": { "title": "Price to (EUR)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Maximum price in EUR." }, "mileageFromKm": { "title": "Mileage from (km)", "minimum": 0, "maximum": 2000000, "type": "integer", "description": "Minimum mileage in kilometres." }, "mileageToKm": { "title": "Mileage to (km)", "minimum": 0, "maximum": 2000000, "type": "integer", "description": "Maximum mileage in kilometres, for example 100000." }, "yearFrom": { "title": "First registration from (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Earliest first-registration year, for example 2018." }, "yearTo": { "title": "First registration to (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Latest first-registration year." }, "fuelTypes": { "title": "Fuel types", "type": "array", "description": "Leave empty for all fuel types.", "items": { "type": "string", "enum": [ "petrol", "diesel", "electric", "hybrid-petrol", "hybrid-diesel", "lpg", "cng", "hydrogen", "other" ], "enumTitles": [ "Petrol (Benzin)", "Diesel", "Electric", "Hybrid electric/petrol", "Hybrid electric/diesel", "LPG (Autogas)", "CNG (Erdgas)", "Hydrogen", "Other" ] } }, "transmission": { "title": "Transmission", "enum": [ "any", "manual", "automatic", "semi-automatic" ], "type": "string", "description": "Gearbox filter.", "default": "any" }, "bodyTypes": { "title": "Body types", "type": "array", "description": "Leave empty for all body types.", "items": { "type": "string", "enum": [ "compact", "convertible", "coupe", "suv", "station-wagon", "sedan", "transporter", "van", "other" ], "enumTitles": [ "Compact (Kleinwagen)", "Convertible (Cabrio)", "Coupe", "SUV / off-road", "Station wagon (Kombi)", "Sedan (Limousine)", "Transporter", "Van / minibus", "Other" ] } }, "powerFromKw": { "title": "Power from (kW)", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Minimum engine power in kW (1 kW is about 1.36 PS)." }, "powerToKw": { "title": "Power to (kW)", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Maximum engine power in kW." }, "zip": { "title": "ZIP code", "type": "string", "description": "Postal code of the search centre, for example 10115 (Berlin). Used with the radius below." }, "radiusKm": { "title": "Radius (km)", "minimum": 5, "maximum": 500, "type": "integer", "description": "Search radius around the ZIP code in kilometres. Used only when a ZIP code is set.", "default": 50 }, "sellerType": { "title": "Seller type", "enum": [ "any", "dealer", "private" ], "type": "string", "description": "Dealer listings, private listings or both.", "default": "any" }, "listedWithinDays": { "title": "Listed within (days)", "enum": [ "0", "1", "3", "7", "14", "30" ], "type": "string", "description": "Only listings published in the last N days (AutoScout24 steps: 1, 3, 7, 14, 30). Combine with Monitor mode and a schedule for a new-listings and price-drop feed.", "default": "0" }, "includeDamaged": { "title": "Include damaged cars", "type": "boolean", "description": "Off by default: accident and damaged vehicles are excluded like on the site.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "newest", "price-asc", "price-desc", "mileage-asc", "year-desc", "power-desc", "relevance" ], "type": "string", "description": "Order of the result list, as on the site. Newest first is the right choice for monitoring.", "default": "newest" }, "monitorMode": { "title": "Monitor mode (only new listings and price changes)", "type": "boolean", "description": "Remember the price of every delivered listing per search. Later runs with the same input return (and charge) only listings that are new or whose price changed, with isNew, previousPrice and priceChange on each row. Use with an Apify Schedule for a price-drop alert.", "default": false }, "historyKey": { "title": "History key", "type": "string", "description": "Optional name for the monitor history. Runs with the same key share one history. By default the key is derived from the searches and filters." }, "maxItems": { "title": "Max listings", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop after this many listings. You are charged per listing, so this also caps the cost of the run.", "default": 50 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy. By default the run uses datacenter proxy and switches to German residential proxy when AutoScout24 blocks it; choose proxy groups here to override.", "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 } } } } } } } } } }