{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Scraper: Car Listings, New Ads & Price Drops", "description": "Scrape AutoScout24 car listings in Germany, Italy, France, Netherlands, Belgium, Austria, Spain and Luxembourg. Paste a search link or use make, model, price, year, mileage and fuel filters. Schedule it daily: only new listings and price drops.", "version": "0.1", "x-build-id": "H3jncuBip8MS6wbYl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapewise~autoscout24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapewise-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/scrapewise~autoscout24-scraper/runs": { "post": { "operationId": "runs-sync-scrapewise-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/scrapewise~autoscout24-scraper/run-sync": { "post": { "operationId": "run-sync-scrapewise-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 links", "type": "array", "description": "Search results links from any AutoScout24 site (autoscout24.de, .it, .fr, .nl, .be, .at, .es, .lu, .com), one per line. Set your filters on the site, copy the link from the address bar and paste it here: every filter in the link is kept. Listing links (one car) also work and return the full listing page. Leave empty to search with the fields below.", "items": { "type": "string" } }, "make": { "title": "Make", "type": "string", "description": "Car make as AutoScout24 shows it, for example BMW, Volkswagen, Mercedes-Benz, Tesla." }, "model": { "title": "Model", "type": "string", "description": "Model or model range as AutoScout24 shows it, for example 3 Series, 320, Golf, C-Class, Model 3. Needs a make. If a name is not found, the error row lists valid names." }, "countries": { "title": "Countries", "type": "array", "description": "Where the cars are. Empty = all eight AutoScout24 countries.", "items": { "type": "string", "enum": [ "DE", "AT", "BE", "ES", "FR", "IT", "LU", "NL" ], "enumTitles": [ "Germany", "Austria", "Belgium", "Spain", "France", "Italy", "Luxembourg", "Netherlands" ] } }, "priceMin": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Only cars at or above this price." }, "priceMax": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Only cars at or below this price." }, "yearMin": { "title": "First registration from (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only cars first registered in this year or later, for example 2018." }, "yearMax": { "title": "First registration to (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only cars first registered in this year or earlier." }, "mileageMax": { "title": "Maximum mileage (km)", "minimum": 0, "type": "integer", "description": "Only cars with at most this many kilometers." }, "mileageMin": { "title": "Minimum mileage (km)", "minimum": 0, "type": "integer", "description": "Only cars with at least this many kilometers." }, "fuelTypes": { "title": "Fuel", "type": "array", "description": "Only these fuel types. Empty = any.", "items": { "type": "string", "enum": [ "gasoline", "diesel", "electric", "hybridGasoline", "hybridDiesel", "lpg", "cng", "hydrogen", "ethanol", "other" ], "enumTitles": [ "Gasoline", "Diesel", "Electric", "Hybrid (electric/gasoline)", "Hybrid (electric/diesel)", "LPG", "CNG", "Hydrogen", "Ethanol", "Other" ] } }, "bodyTypes": { "title": "Body type", "type": "array", "description": "Only these body types. Empty = any.", "items": { "type": "string", "enum": [ "compact", "convertible", "coupe", "suv", "stationWagon", "sedan", "van", "transporter", "other" ], "enumTitles": [ "Compact", "Convertible", "Coupe", "SUV / off-road / pick-up", "Station wagon", "Sedan", "Van", "Transporter", "Other" ] } }, "transmission": { "title": "Transmission", "enum": [ "any", "automatic", "manual", "semiAutomatic" ], "type": "string", "description": "Gearbox type.", "default": "any" }, "sellerType": { "title": "Seller", "enum": [ "any", "dealer", "private" ], "type": "string", "description": "Dealers only, private sellers only, or both.", "default": "any" }, "offerTypes": { "title": "Condition", "type": "array", "description": "Used, new, demonstration and so on. Empty = any.", "items": { "type": "string", "enum": [ "used", "new", "employeesCar", "classic", "demonstration", "preRegistered" ], "enumTitles": [ "Used", "New", "Employee's car", "Classic", "Demonstration", "Pre-registered" ] } }, "zipCode": { "title": "Postal code", "type": "string", "description": "Search around this postal code, for example 10115 (Berlin). Needs exactly one country above." }, "radiusKm": { "title": "Radius around the postal code (km)", "minimum": 1, "type": "integer", "description": "Distance from the postal code, for example 50. Default 50." }, "sortBy": { "title": "Sort by", "enum": [ "standard", "newest", "priceLowToHigh", "priceHighToLow", "mileageLowToHigh", "yearNewest" ], "type": "string", "description": "AutoScout24's own orders. With a limit it also decides which listings you get. onlyNew always uses newest first.", "default": "standard" }, "maxItems": { "title": "Max listings per search", "minimum": 0, "maximum": 4000, "type": "integer", "description": "Stop each search (each link, and the field search) after this many listings. AutoScout24 shows at most 4,000 per search. 0 = as many as the site shows.", "default": 50 }, "onlyNew": { "title": "Only new listings since the last run", "type": "boolean", "description": "For scheduled runs. Remembers which listings each search (with its filters) already returned, in a named key-value store in your account ('autoscout24-scraper-memory'), and delivers only listings never returned before. Seen listings are not delivered and not charged. Uses the newest-first order. A run with nothing new costs nothing. Delete the store to start over.", "default": false }, "trackPriceChanges": { "title": "Track price changes", "type": "boolean", "description": "Remembers the last price of every listing per search (same key-value store) and adds previousPrice, priceChange, priceChangePct and isPriceDrop to each row. Together with 'Only new listings', a run delivers new listings plus listings whose price changed since the last run.", "default": false }, "onlyPriceDrops": { "title": "Price changes: only drops", "type": "boolean", "description": "With both options above on, listings you already have come back only when their price went down (price increases are skipped and not charged).", "default": false }, "includeDetails": { "title": "Full listing page", "type": "boolean", "description": "Also read each listing's own page: full description, equipment list, power, body type, color, doors, seats, previous owners, consumption, CO2, warranty and the date the listing went online. One extra request per listing, charged as a separate event.", "default": false }, "site": { "title": "Site for the fields search", "enum": [ "com", "de", "it", "fr", "nl", "be", "at", "es", "lu" ], "type": "string", "description": "Which AutoScout24 site runs the search built from the fields above. autoscout24.com returns labels (fuel, transmission, body) in English; a country site returns them in its language. Links you paste always use their own site.", "default": "com" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy, default group. If AutoScout24 keeps refusing it, the Actor switches to a stronger proxy group by itself.", "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 } } } } } } } } } }