{ "openapi": "3.0.1", "info": { "title": "Nettiauto Scraper: Finnish Used Cars, EV Battery & Price Drops", "description": "Scrape Nettiauto.com used cars by make, model, year, price, mileage, fuel, region and seller. Get VIN, equipment, EV battery and range, charging speeds, dealer details and deal scores, plus a monitor for new listings, price drops and sold cars. Export JSON, CSV or Excel.", "version": "0.2", "x-build-id": "kEaGhaHvGe4kvI6Lk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~nettiauto-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-nettiauto-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/getascraper~nettiauto-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-nettiauto-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/getascraper~nettiauto-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-nettiauto-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": "Nettiauto links (optional)", "type": "array", "description": "Paste links copied from nettiauto.com: a search page, a make or model page, a quick-link list such as electric cars, or the link of a single car. Links with a free-text search are not read. Leave empty to use the search form below.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "make": { "title": "Make", "type": "string", "description": "Car make, for example Toyota, Volkswagen or Mercedes-Benz. Leave empty for all makes.", "default": "" }, "model": { "title": "Model", "type": "string", "description": "Car model, for example Corolla or Golf. Needs a make.", "default": "" }, "fuelType": { "title": "Fuel type", "enum": [ "", "electric", "plug_in_hybrid", "hybrid", "petrol", "diesel", "gas" ], "type": "string", "description": "Only cars with this fuel. Electric, diesel, gas and plug-in hybrid are read from Nettiauto's own complete lists when no make is set.", "default": "" }, "transmission": { "title": "Gearbox", "enum": [ "", "automatic", "manual" ], "type": "string", "description": "Only cars with this gearbox.", "default": "" }, "bodyType": { "title": "Body type", "enum": [ "", "estate", "hatchback", "sedan", "suv", "mpv", "coupe", "convertible", "pickup", "other" ], "type": "string", "description": "Only cars with this body style.", "default": "" }, "priceMin": { "title": "Minimum price (EUR)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Only cars priced at or above this amount." }, "priceMax": { "title": "Maximum price (EUR)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Only cars priced at or below this amount." }, "yearMin": { "title": "Minimum model year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only cars from this model year or newer." }, "yearMax": { "title": "Maximum model year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only cars from this model year or older." }, "mileageMin": { "title": "Minimum mileage (km)", "minimum": 0, "maximum": 5000000, "type": "integer", "description": "Only cars with at least this odometer reading." }, "mileageMax": { "title": "Maximum mileage (km)", "minimum": 0, "maximum": 5000000, "type": "integer", "description": "Only cars with at most this odometer reading." }, "sellerType": { "title": "Seller type", "enum": [ "", "dealer", "private" ], "type": "string", "description": "Only cars sold by dealers or by private sellers.", "default": "" }, "region": { "title": "Region", "enum": [ "", "uusimaa", "varsinais-suomi", "pirkanmaa", "pohjois-pohjanmaa", "keski-suomi", "pohjois-savo", "paijat-hame", "satakunta", "kymenlaakso", "kanta-hame", "pohjanmaa", "etela-pohjanmaa", "lappi", "etela-karjala", "etela-savo", "pohjois-karjala", "kainuu", "keski-pohjanmaa", "ahvenanmaa" ], "type": "string", "description": "Only cars located in this region.", "default": "" }, "listingAge": { "title": "Listing age", "enum": [ "", "new", "updated" ], "type": "string", "description": "Only cars newly listed, or only cars whose listing was recently updated.", "default": "" }, "sortBy": { "title": "Order", "enum": [ "newest", "price_asc", "price_desc", "year_desc", "mileage_asc", "oldest" ], "type": "string", "description": "Newest first is best for monitoring. Other orders return the first matching cars in that order.", "default": "newest" }, "includeDetails": { "title": "Full vehicle details", "type": "boolean", "description": "Open every car's own page to add equipment list, battery and charging data, power, weights, CO2, registration and inspection data, dealer address and website, description and all photos. Slower, because each car needs one more page.", "default": false }, "marketStats": { "title": "Add deal score", "type": "boolean", "description": "Compare each car with similar cars collected in the same run: median price, how far above or below it sits, and a deal rating. Shown only when at least 5 similar cars were collected, so use a make and model for best results.", "default": true }, "convertTo": { "title": "Also show price in", "enum": [ "", "USD", "SEK" ], "type": "string", "description": "Adds the price in US dollars or Swedish kronor using the European Central Bank daily reference rate. Euro prices are always included.", "default": "" }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Give this search a name to turn on monitor mode. Each run then marks cars as NEW, PRICE_DROP, PRICE_RISE, UPDATED or REMOVED_OR_SOLD and keeps a price history. Reuse the same name on every scheduled run. The first run is the baseline. Leave empty for a one-off run.", "default": "" }, "onlyChanges": { "title": "Return only changes", "type": "boolean", "description": "In monitor mode, return only new, changed and removed cars. Unchanged cars are not returned and not charged.", "default": true }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of cars to return. Large searches are read page by page until this number is reached.", "default": 25 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Nettiauto normally answers direct requests, so no proxy is used by default. If direct requests are refused, the Actor tries other Apify proxy routes by itself.", "default": { "useApifyProxy": 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 } } } } } } } } } }