{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Scraper & Monitor", "description": "Scrape AutoScout24 car listings in 7 European markets: price, price rating, mileage, first registration, power, and dealer phone. Monitor mode returns only new listings since the last run.", "version": "0.1", "x-build-id": "qgnU0Bn7PnYgTGte5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/seasoned_seaurchin~autoscout24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-seasoned_seaurchin-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/seasoned_seaurchin~autoscout24-scraper/runs": { "post": { "operationId": "runs-sync-seasoned_seaurchin-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/seasoned_seaurchin~autoscout24-scraper/run-sync": { "post": { "operationId": "run-sync-seasoned_seaurchin-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": "Search URLs", "type": "array", "description": "AutoScout24 result page URLs (copy the URL after searching on autoscout24.de/.at/.it/.nl/.be/.es/.fr). All filters in the URL are preserved. Works for any market.", "items": { "type": "string" } }, "make": { "title": "Make (alternative to search URLs)", "type": "string", "description": "Car make, e.g. BMW, Audi, Volkswagen." }, "model": { "title": "Model", "type": "string", "description": "Model, e.g. 320, A4, Golf. Optional — leave empty for all models." }, "country": { "title": "Market", "enum": [ "DE", "AT", "IT", "NL", "BE", "ES", "FR", "EU" ], "type": "string", "description": "Which AutoScout24 market to search when using make/model.", "default": "DE" }, "priceFrom": { "title": "Price from (EUR)", "type": "integer", "description": "Minimum price in EUR." }, "priceTo": { "title": "Price to (EUR)", "type": "integer", "description": "Maximum price in EUR." }, "yearFrom": { "title": "First registration from (year)", "type": "integer", "description": "Only cars first registered in or after this year." }, "mileageTo": { "title": "Max mileage (km)", "type": "integer", "description": "Maximum mileage in kilometres." }, "fuel": { "title": "Fuel", "enum": [ "", "B", "D", "E", "M", "L", "H" ], "type": "string", "description": "Fuel" }, "maxItems": { "title": "Max listings", "type": "integer", "description": "Stop after this many listings per search. Default 200.", "default": 200 }, "maxPagesPerSearch": { "title": "Max pages per search", "type": "integer", "description": "Each page holds 20 listings. Default 10 pages (= 200 listings).", "default": 10 }, "onlyNew": { "title": "Monitor mode: only new listings", "type": "boolean", "description": "Return only listings not seen in previous runs. Schedule this Actor (e.g. every hour) to catch new cars and price drops. Runs with no new listings produce no results and are not charged per listing.", "default": false }, "notifyWebhook": { "title": "Webhook URL (optional)", "type": "string", "description": "If set, a JSON payload with the new listings is POSTed to this URL whenever new listings are found. Works with n8n, Make, Zapier, Slack incoming webhooks, or your own endpoint. No request is sent when nothing is new." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Defaults to Apify residential proxy (recommended — AutoScout24 blocks most datacenter IPs)." } } }, "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 } } } } } } } } } }