{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Scraper: Cars, Prices & Dealer Phones", "description": "AutoScout24 car listings across Europe: price and price rating, mileage, first registration, fuel, gearbox, power, location, dealer or private seller with phone numbers, photos, and optional full specs and description. Paste a search URL or pick make and model. Past the 4,000 cap. $0.0005 per car.", "version": "0.1", "x-build-id": "XDjPtLZdhKBKVu5EA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemint~autoscout24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemint-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/scrapemint~autoscout24-scraper/runs": { "post": { "operationId": "runs-sync-scrapemint-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/scrapemint~autoscout24-scraper/run-sync": { "post": { "operationId": "run-sync-scrapemint-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": { "searchUrls": { "title": "AutoScout24 search URLs", "type": "array", "description": "Search result pages copied from any AutoScout24 site (.com, .de, .it, .fr, .es, .nl, .be, .at) with any filters set. Each URL is one search.", "default": [], "items": { "type": "string" } }, "makes": { "title": "Make and model", "type": "array", "description": "Or build searches here, one per line: a make, or a make and model separated by a slash. E.g. Volkswagen / Golf, BMW / 3 Series, Mercedes-Benz / C-Class, Tesla.", "default": [], "items": { "type": "string" } }, "site": { "title": "Site", "enum": [ "com", "de", "it", "fr", "es", "nl", "be", "at" ], "type": "string", "description": "Which AutoScout24 site built searches use. Labels (fuel, gearbox) come in that site's language, and make and model names are matched the way that site writes them. Country sites also publish the price rating band; autoscout24.com does not.", "default": "com" }, "countries": { "title": "Countries", "type": "array", "description": "Where the car is. Empty means all eight.", "items": { "type": "string", "enum": [ "D", "A", "B", "E", "F", "I", "L", "NL" ], "enumTitles": [ "Germany", "Austria", "Belgium", "Spain", "France", "Italy", "Luxembourg", "Netherlands" ] }, "default": [] }, "offerTypes": { "title": "Condition", "type": "array", "description": "Empty means all.", "items": { "type": "string", "enum": [ "U", "N", "J", "D", "S", "O" ], "enumTitles": [ "Used", "New", "Employee's car", "Demonstration", "Pre-registered", "Classic" ] }, "default": [] }, "sellerType": { "title": "Seller", "enum": [ "", "D", "P" ], "type": "string", "description": "Dealer or private seller.", "default": "" }, "fuelTypes": { "title": "Fuel", "type": "array", "description": "Empty means all.", "items": { "type": "string", "enum": [ "B", "D", "E", "2", "3", "L", "C", "H", "M", "O" ], "enumTitles": [ "Petrol", "Diesel", "Electric", "Hybrid (electric/petrol)", "Hybrid (electric/diesel)", "LPG", "CNG", "Hydrogen", "Ethanol", "Other" ] }, "default": [] }, "gearbox": { "title": "Gearbox", "enum": [ "", "A", "M", "S" ], "type": "string", "description": "Transmission type.", "default": "" }, "priceFrom": { "title": "Price from (EUR)", "minimum": 0, "type": "integer", "description": "Optional." }, "priceTo": { "title": "Price to (EUR)", "minimum": 0, "type": "integer", "description": "Optional." }, "yearFrom": { "title": "First registration from (year)", "minimum": 1900, "type": "integer", "description": "Optional." }, "yearTo": { "title": "First registration to (year)", "minimum": 1900, "type": "integer", "description": "Optional." }, "mileageTo": { "title": "Mileage up to (km)", "minimum": 0, "type": "integer", "description": "Optional." }, "zip": { "title": "Postcode", "type": "string", "description": "Optional. With a radius, only cars within that distance. Use with one country.", "default": "" }, "radiusKm": { "title": "Radius (km)", "minimum": 1, "type": "integer", "description": "Used with the postcode." }, "includeDetails": { "title": "Full specs and description", "type": "boolean", "description": "Opens each listing for its description, equipment list, body type, colour, seats, doors, drivetrain, emissions, coordinates, market median price and listing date. Slower. $0.0015 per car instead of $0.0005.", "default": false }, "maxItemsPerSearch": { "title": "Max cars per search", "minimum": 1, "maximum": 200000, "type": "integer", "description": "Newest first. AutoScout24 shows 4,000 per search; bigger searches are split by price automatically.", "default": 1000 } } }, "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 } } } } } } } } } }