{ "openapi": "3.0.1", "info": { "title": "Auto24.ee Scraper - Estonian Car Listings & Prices", "description": "Scrape car listings from Auto24.ee, Estonia's largest car marketplace. Extract prices, specs, mileage, fuel type, transmission, power, seller info, and images. Filter by make, model, year, price range, and fuel type. No login or cookies required.", "version": "0.1", "x-build-id": "k94TDAbgTvYIzaI7C" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~auto24-ee-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-auto24-ee-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/studio-amba~auto24-ee-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-auto24-ee-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/studio-amba~auto24-ee-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-auto24-ee-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": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Free-text search for make or keyword (e.g., 'volkswagen', 'audi', 'SUV'). Used when make is not set." }, "make": { "title": "Make", "type": "string", "description": "Car manufacturer (e.g., Volkswagen, BMW, Toyota, Audi, Mercedes-Benz, Skoda, Volvo, Ford, Opel, Hyundai)." }, "model": { "title": "Model", "type": "string", "description": "Car model (e.g., Golf, Passat, 3 Series, A4). Requires make to be set." }, "vehicleCategory": { "title": "Vehicle category", "enum": [ "passenger-and-suv", "passenger", "suv", "commercial" ], "type": "string", "description": "Which auto24.ee category to search. 'Passenger cars and SUVs' is the site's own Cars tab. Pick 'Commercial vehicles' for vans and light commercials (Toyota ProAce, VW Transporter, Ford Transit). Before version 0.1.15 the actor searched passenger cars only, so SUVs and vans were missing.", "default": "passenger-and-suv" }, "yearFrom": { "title": "Year From", "minimum": 1950, "maximum": 2030, "type": "integer", "description": "Minimum first registration year (e.g., 2018)." }, "yearTo": { "title": "Year To", "minimum": 1950, "maximum": 2030, "type": "integer", "description": "Maximum first registration year (e.g., 2024)." }, "priceFrom": { "title": "Price From (EUR)", "minimum": 0, "type": "integer", "description": "Minimum price in EUR." }, "priceTo": { "title": "Price To (EUR)", "minimum": 0, "type": "integer", "description": "Maximum price in EUR." }, "fuelType": { "title": "Fuel Type", "enum": [ "", "petrol", "diesel", "lpg", "electric", "hybrid", "cng" ], "type": "string", "description": "Filter by fuel type." }, "transmission": { "title": "Transmission", "enum": [ "", "manual", "automatic" ], "type": "string", "description": "Filter by transmission type." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of car listings to return.", "default": 100 }, "fetchDetails": { "title": "Fetch listing details (off by default, one extra page per listing)", "type": "boolean", "description": "Off by default. When off, the output holds only what the search results show, and every field listed here is null with detailStatus 'not-requested'. When on, the actor opens every listing's own page on auto24.ee and adds: the exact VAT wording and rate ('includes VAT 24%' or 'VAT 0% (no VAT accrue)'), the regular price when a bargain price is advertised (priceBeforeDiscount; price stays the current asking price), seller type and name, vehicle location, vehicle type, body type, first registration month and year, colour, registration status, CO2 in g/km with the source label and method (WLTP or NEDC only when the label says so), seats, doors, engine displacement in cm3, power in kW, curb weight, gross weight, payload, the 'Bought from' country, and the VIN and registration number exactly as visible (auto24.ee masks both behind a CAPTCHA, so these are usually a prefix with status 'partial'). One extra page load per listing through the unblocking service, run 4 at a time, so a run takes roughly 2 to 5 seconds longer per listing.", "default": false }, "detailUrls": { "title": "Listing URLs (optional, skips the search)", "maxItems": 2000, "type": "array", "description": "Read these auto24.ee listing pages directly instead of running a search, e.g. https://eng.auto24.ee/vehicles/4262149 (www.auto24.ee/soidukid/ links work too). Always returns the full listing-page fields, as with fetchDetails. Search filters are ignored when this is set. Capped by maxResults, at most 2000 URLs.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. RESIDENTIAL proxies recommended for Auto24.ee.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "EE" } } } }, "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 } } } } } } } } } }