{ "openapi": "3.0.1", "info": { "title": "AutoScout24 CH car listings", "description": "Scrape AutoScout24 vehicle listings by make and model with price, mileage, year, and full detail filters. Returns flattened, structured records ready for analysis.", "version": "0.0", "x-build-id": "nKCE32bsBqftXJAJp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_dino~autoscout24-ch/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_dino-autoscout24-ch", "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/data_dino~autoscout24-ch/runs": { "post": { "operationId": "runs-sync-data_dino-autoscout24-ch", "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/data_dino~autoscout24-ch/run-sync": { "post": { "operationId": "run-sync-data_dino-autoscout24-ch", "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": [ "make", "model" ], "properties": { "make": { "title": "Vehicle make", "type": "string", "description": "Make name or key, e.g. 'Tesla' or 'tesla'. The scraper resolves human-readable names to API keys automatically.", "default": "Tesla" }, "model": { "title": "Vehicle model", "type": "string", "description": "Model name or key, e.g. 'Model S' or 'model-s'. The scraper resolves human-readable names to API keys automatically.", "default": "Model S" }, "domain": { "title": "Country domain", "enum": [ "ch" ], "type": "string", "description": "Country domain to scrape, matching autoscout24.. Only 'ch' is confirmed to work as of this writing.", "default": "ch" }, "category": { "title": "Vehicle category", "enum": [ "car", "motorcycle" ], "type": "string", "description": "Vehicle category to search: car or motorcycle.", "default": "car" }, "detail": { "title": "Fetch full details", "type": "boolean", "description": "When enabled, visit each listing's detail endpoint to extract every field the API returns (battery, range, VIN, colors, equipment, description, etc.). When disabled, keep only the summary fields from search results (faster, fewer fields).", "default": true }, "priceFrom": { "title": "Minimum price (CHF)", "type": "integer", "description": "Minimum price in CHF (inclusive). Leave empty for no lower bound." }, "priceTo": { "title": "Maximum price (CHF)", "type": "integer", "description": "Maximum price in CHF (inclusive). Leave empty for no upper bound." }, "mileageFrom": { "title": "Minimum mileage (km)", "type": "integer", "description": "Minimum mileage in km (inclusive). Leave empty for no lower bound." }, "mileageTo": { "title": "Maximum mileage (km)", "type": "integer", "description": "Maximum mileage in km (inclusive). Leave empty for no upper bound." }, "yearFrom": { "title": "Earliest registration year", "type": "integer", "description": "Earliest first-registration year (inclusive). Leave empty for no lower bound." }, "yearTo": { "title": "Latest registration year", "type": "integer", "description": "Latest first-registration year (inclusive). Leave empty for no upper bound." }, "delay": { "title": "Request delay (seconds)", "minimum": 0, "type": "number", "description": "Delay in seconds between HTTP requests to the AutoScout24 API. Lower values are faster but may trigger rate limiting.", "default": 0.4 } } }, "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 } } }, "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 } } } } } } } } } }