{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Scraper: Past the 4,000 Limit", "description": "Every car of an AutoScout24 search in 8 countries, past the 4,000 the site shows, checked against its count. $1 per 1,000 cars. Price, mileage, specs, dealer and phone; car pages optional.", "version": "0.1", "x-build-id": "7OGlS3ZnFvf0z4dLb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/luzivanlt~autoscout24-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-luzivanlt-autoscout24-listings-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/luzivanlt~autoscout24-listings-scraper/runs": { "post": { "operationId": "runs-sync-luzivanlt-autoscout24-listings-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/luzivanlt~autoscout24-listings-scraper/run-sync": { "post": { "operationId": "run-sync-luzivanlt-autoscout24-listings-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": "Search links", "type": "array", "description": "AutoScout24 results links, copied from your browser after you set the make, model, country, price, year, mileage and any other filters you want, on autoscout24.de, .at, .be, .es, .fr, .it, .lu, .nl or .com. Each link keeps all of its filters and its sort order, and is read from its first page. A link to one car or to a dealer's page is refused. Example: https://www.autoscout24.de/lst/bmw/x3?atype=C&cy=D", "items": { "type": "string" } }, "make": { "title": "Make", "type": "string", "description": "Instead of a link: the make to search, as AutoScout24 writes it in a link (bmw, mercedes-benz, volkswagen, land-rover). The filters below apply to this search, read on autoscout24.com in English. Leave empty when you only paste links. Example: audi" }, "model": { "title": "Model", "type": "string", "description": "The model of the make above, as AutoScout24.com writes it in its links (a4, x3, golf, 3-series). Needs a make. When you are not sure of the spelling, set the search up on autoscout24.com and paste its link under Search links instead. Example: a4" }, "countries": { "title": "Countries", "type": "array", "description": "The countries whose cars to read, for the make and filters above: Germany, Austria, Belgium, Spain, France, Italy, Luxembourg and the Netherlands. All eight together when you leave it empty. Links keep their own countries. Example: DE", "items": { "type": "string", "enum": [ "DE", "AT", "BE", "ES", "FR", "IT", "LU", "NL" ], "enumTitles": [ "Germany", "Austria", "Belgium", "Spain", "France", "Italy", "Luxembourg", "Netherlands" ] } }, "minPrice": { "title": "Lowest price (€)", "minimum": 0, "maximum": 9999999, "type": "integer", "description": "Only cars priced at or above this many euros, for the make and filters above. Leave empty for no lower limit. Search links keep the price filter set in the link itself, if any. Example: 10000" }, "maxPrice": { "title": "Highest price (€)", "minimum": 0, "maximum": 9999999, "type": "integer", "description": "Only cars priced at or below this many euros, for the make and filters above. Leave empty for no upper limit. Search links keep the price filter set in the link itself, if any. Example: 30000" }, "minYear": { "title": "First registered from (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only cars first registered in this year or later, for the make and filters above. Leave empty for no limit. Search links keep the registration filter set in the link itself, if any. Example: 2019" }, "maxYear": { "title": "First registered until (year)", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only cars first registered in this year or earlier, for the make and filters above. Leave empty for no limit. Search links keep the registration filter set in the link itself, if any. Example: 2023" }, "maxMileage": { "title": "Highest mileage (km)", "minimum": 0, "maximum": 2000000, "type": "integer", "description": "Only cars with at most this many kilometres on the clock, for the make and filters above. Leave empty for any mileage. Search links keep the mileage filter set in the link itself, if any. Example: 100000" }, "fuelType": { "title": "Fuel", "enum": [ "all", "petrol", "diesel", "electric", "electric-petrol", "electric-diesel", "lpg", "cng", "hydrogen", "ethanol", "other" ], "type": "string", "description": "One fuel, for the make and filters above: petrol, diesel, electric, the two hybrids, LPG, CNG, hydrogen, ethanol or other. All fuels by default. Search links keep their own fuel filter. Example: diesel", "default": "all" }, "gearbox": { "title": "Gearbox", "enum": [ "all", "automatic", "manual", "semi-automatic" ], "type": "string", "description": "Automatic, manual or semi-automatic gearbox, for the make and filters above; any gearbox by default. Search links keep the gearbox filter set in the link itself, if any. Example: automatic", "default": "all" }, "bodyType": { "title": "Body type", "enum": [ "all", "compact", "convertible", "coupe", "suv", "station-wagon", "sedan", "van", "transporter", "other" ], "type": "string", "description": "One body type, for the make and filters above: compact, convertible, coupé, SUV, station wagon, sedan, van, transporter or other. Any by default. Search links keep their own body filter. Example: suv", "default": "all" }, "sellerType": { "title": "Seller", "enum": [ "all", "dealer", "private" ], "type": "string", "description": "Dealers only, private sellers only, or both (the default), for the make and filters above. Search links keep the seller filter set in the link itself, if any. Example: private", "default": "all" }, "maxCarsPerSearch": { "title": "Max cars per search", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop each search after this many cars, from 1 to 100,000 (1,000 by default). AutoScout24's own site shows at most 4,000 cars for one search; this Actor goes past that to the cars AutoScout24 counts, so set this above the search's count to get them all. You pay per car saved, so this also caps what each search costs. Example: 10000", "default": 1000 }, "includeDetails": { "title": "Include car pages", "type": "boolean", "description": "Also open each car's own page for its description, full equipment list, body type, colour, seats and doors, previous owners, accident and service history, next inspection, emission class and sticker, consumption and CO₂, the market price range, map point, every picture in large size, and the dealer's rating details, opening hours and website. One more page per car, so a run takes longer. Off by default. Example: true", "default": false }, "includeDealerPages": { "title": "Include dealer pages", "type": "boolean", "description": "Also open each dealer's own page and add its profile to the dealer's cars: about us, legal notice, address, phone and fax, website, contact people, the brands and services it offers, opening hours, branches, its rating by category and its newest 10 reviews. One more page per dealer for each results page, so a run takes longer. Private sellers have no dealer page. Off by default. Example: true", "default": 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 } } } } } } } } } }