{ "openapi": "3.0.1", "info": { "title": "Autohero Scraper — Used Car Listings Across 9 EU Countries", "description": "Scrape used-car listings from Autohero.com (Auto1 Group) in Germany, France, Spain, Italy, Austria, Netherlands, Belgium, Poland, and Sweden. Get prices, mileage, year, fuel, gearbox, damage history, and optionally VIN, equipment, and service records. No login, no cookies. Export JSON, CSV, Excel.", "version": "0.1", "x-build-id": "BR8be7PDbdWbG0YtR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~autohero-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-autohero-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~autohero-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-autohero-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~autohero-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-autohero-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": { "country": { "title": "Country", "enum": [ "de", "fr", "es", "it", "at", "nl", "be", "pl", "se" ], "type": "string", "description": "Autohero country store to scrape. Each country has its own inventory (Germany is the largest with ~7,500 cars).", "default": "de" }, "make": { "title": "Make", "type": "string", "description": "Filter by car make, e.g. 'BMW', 'Volkswagen', 'Mercedes-Benz', 'Renault'. Case-insensitive; common aliases like 'VW' or 'Mercedes' work too. Leave empty for all makes." }, "model": { "title": "Model", "type": "string", "description": "Filter by model name as Autohero lists it, e.g. 'X1', 'Golf', 'C-Klasse', 'Clio'. Case-insensitive exact match. Leave empty for all models." }, "maxPrice": { "title": "Max Price", "minimum": 1, "type": "integer", "description": "Maximum price in the country's currency (EUR; PLN in Poland, SEK in Sweden). Example: 15000." }, "minYear": { "title": "Min Year", "minimum": 1990, "type": "integer", "description": "Minimum first-registration year, e.g. 2020." }, "maxMileage": { "title": "Max Mileage (km)", "minimum": 1, "type": "integer", "description": "Maximum mileage in kilometres, e.g. 50000." }, "fuelType": { "title": "Fuel Type", "enum": [ "petrol", "diesel", "electric", "hybrid", "lpg", "cng", "hydrogen", "ethanol", "other" ], "type": "string", "description": "Filter by fuel type. Leave empty for all." }, "gearType": { "title": "Gearbox", "enum": [ "manual", "automatic", "semi-automatic" ], "type": "string", "description": "Filter by gearbox type. Leave empty for all." }, "fetchDetails": { "title": "Fetch Details (VIN, equipment, service history)", "type": "boolean", "description": "Enrich each car with its VIN, full equipment list (first 30 items), service-history records, and total image count. Costs one extra request per car: 100 cars is quick, but a full country catalogue means thousands of extra requests and a much longer run. Leave off for fast listing scrapes.", "default": false }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Maximum number of cars to return. The full EU inventory is roughly 20,000 cars; Germany alone is ~7,500.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. The Autohero API is public and open, so default Apify proxies work well." } } }, "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 } } } } } } } } } }