{ "openapi": "3.0.1", "info": { "title": "Used Car Market Tracker: Prices, Mileage & Deals", "description": "What a used car model really sells for across Europe: how many are listed, the median price by age band, typical mileage, dealer versus private share, fuel and gearbox mix, and the listings priced below the market. From AutoScout24; no login.", "version": "0.1", "x-build-id": "cb821XQewC4ZNf9vL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/precious_bathmat~used-car-market-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-precious_bathmat-used-car-market-tracker", "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/precious_bathmat~used-car-market-tracker/runs": { "post": { "operationId": "runs-sync-precious_bathmat-used-car-market-tracker", "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/precious_bathmat~used-car-market-tracker/run-sync": { "post": { "operationId": "run-sync-precious_bathmat-used-car-market-tracker", "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", "required": [ "models" ], "properties": { "models": { "title": "Cars", "type": "array", "description": "One car per line: a make and model (\"BMW 3 Series\"), or just a make (\"Porsche\") for the whole brand.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "ALL", "DE", "AT", "BE", "ES", "FR", "IT", "LU", "NL" ], "type": "string", "description": "Which market to measure. All countries covers the whole AutoScout24 marketplace at once.", "default": "ALL" }, "maxListingsPerModel": { "title": "Cars to read per model", "minimum": 20, "maximum": 1000, "type": "integer", "description": "How many of the most recently listed cars to read for the price, mileage and deal figures. The market totals come from AutoScout24's own counts and do not depend on this.", "default": 200 }, "yearFrom": { "title": "First registered from", "minimum": 1950, "maximum": 2030, "type": "integer", "description": "Only count cars first registered in this year or later. Leave empty for all." }, "yearTo": { "title": "First registered up to", "minimum": 1950, "maximum": 2030, "type": "integer", "description": "Only count cars first registered in this year or earlier." }, "onlyElectric": { "title": "Electric cars only", "type": "boolean", "description": "Measure only the electric version of each model.", "default": false }, "includeNewCars": { "title": "Include new and demo cars", "type": "boolean", "description": "Off by default, so every figure describes the used market. On, brand-new stock listed by dealers is counted too.", "default": false }, "includeListings": { "title": "Also return every car as a row", "type": "boolean", "description": "A second table with each car read: price, mileage, year, fuel, transmission, seller, location and a link. Charged per car; turn it off to pay for the reports only.", "default": 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 } } } } } } } } } }