{ "openapi": "3.0.1", "info": { "title": "Carwow UK Scraper — Used Car Listings & Prices", "description": "Scrape Carwow UK used-car listings by make or model. Get prices, mileage, year, trim,\nderivative, fuel, transmission and body type, with optional dealer, registration, equipment and\ngallery images. Export structured data to JSON, CSV, Excel, or use it through the Apify API.", "version": "1.9", "x-build-id": "52MKxrI5yYEBoNYyS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/miladamirzadeh~carwow-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-miladamirzadeh-carwow-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/miladamirzadeh~carwow-scraper/runs": { "post": { "operationId": "runs-sync-miladamirzadeh-carwow-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/miladamirzadeh~carwow-scraper/run-sync": { "post": { "operationId": "run-sync-miladamirzadeh-carwow-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", "required": [ "makes", "proxyConfiguration" ], "properties": { "makes": { "title": "Car Makes or Models", "minItems": 1, "type": "array", "description": "Carwow makes or make/model searches. Examples: 'audi', 'bmw 3 series', 'mercedes-benz cla'.", "items": { "type": "string", "minLength": 1 }, "default": [ "audi" ] }, "min_year": { "title": "Minimum Year", "minimum": 1900, "type": "integer", "description": "Filter results by minimum manufacture year (e.g., 2015).", "default": 2015 }, "max_year": { "title": "Maximum Year", "minimum": 1900, "type": "integer", "description": "Filter results by maximum manufacture year. If omitted, the Actor automatically uses the current UTC year." }, "fuel_type": { "title": "Fuel Type", "enum": [ "", "diesel", "petrol", "hybrid", "electric" ], "type": "string", "description": "Filter results by fuel type. Leave as 'Any' for all types.", "default": "" }, "transmission": { "title": "Transmission", "enum": [ "", "automatic", "manual" ], "type": "string", "description": "Filter results by transmission type. Leave as 'Any' for all types.", "default": "" }, "max_items": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "Maximum results for the run, distributed as evenly as possible across the requested make/model searches. A search can return fewer only when Carwow exposes fewer eligible unique listings or its requests remain unavailable after bounded retries.", "default": 10 }, "deep_mode": { "title": "Deep Mode", "type": "boolean", "description": "Fetch each vehicle detail page for registration plate, seller, color, up to 50 filtered equipment items, source body type, and up to 20 image URLs. Disable for faster inventory/price runs.", "default": true }, "perform_data_cleaning": { "title": "Smart Data Normalization", "type": "boolean", "description": "Validate body type against Carwow's current make/model taxonomy. In Deep Mode, the original listing value is also kept as source_body_type.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Residential proxy is enabled by default and recommended for reliable access to Carwow. Disabling proxy protection may lead to blocked or empty responses.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }