{ "openapi": "3.0.1", "info": { "title": "Autotrader UK Scraper + Instant Results", "description": "Scrape Autotrader UK (United Kingdom) vehicles by make, model, year, price, and mileage. Features exact listing dates, smart age filtering, and deduplication. Optimized for lowest cost per run using advanced extraction techniques. Get instant vehicle results with filtering for private listings only.", "version": "0.0", "x-build-id": "cCWdPIprwaahUtONN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/raidr-api~autotrader-uk-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-raidr-api-autotrader-uk-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/raidr-api~autotrader-uk-scraper/runs": { "post": { "operationId": "runs-sync-raidr-api-autotrader-uk-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/raidr-api~autotrader-uk-scraper/run-sync": { "post": { "operationId": "run-sync-raidr-api-autotrader-uk-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": [ "postcode" ], "properties": { "postcode": { "title": "πŸ“ Postcode", "type": "string", "description": "UK postcode used as the centre of the search (e.g. \"E1 6AN\").", "default": "E1 6AN" }, "radius": { "title": "πŸ—ΊοΈ Radius (miles)", "minimum": 0, "type": "integer", "description": "Distance around the postcode, in miles. Leave empty (or 0) for a national search." }, "channel": { "title": "πŸš— Vehicle Type", "enum": [ "cars", "vans", "trucks", "bikes", "motorhomes", "caravans" ], "type": "string", "description": "Which AutoTrader marketplace to search.", "default": "cars" }, "maxItems": { "title": "πŸ“¦ Maximum Results", "minimum": 1, "type": "integer", "description": "Maximum number of unique listings to save. Each results page returns ~20 listings, so the default keeps runs small β€” increase it to pull more.", "default": 40 }, "sort": { "title": "↕️ Sort Results By", "enum": [ "relevance", "price-asc", "price-desc", "year-desc", "year-asc", "mileage-asc", "mileage-desc" ], "type": "string", "description": "Ordering for results.", "default": "relevance" }, "fetchDetails": { "title": "πŸ”Ž Fetch Full Details", "type": "boolean", "description": "Also open each advert's detail page to add the full specification (fuel, gearbox, engine, doors, seats, colour), performance figures, running costs (COβ‚‚, tax, insurance group, MPG), history check, feature list, seller description, and the complete image set. Slower and uses more proxy bandwidth (one extra ~0.25 MB page per advert).", "default": false }, "make": { "title": "🚘 Makes", "type": "array", "description": "Filter by make, e.g. [\"Audi\", \"BMW\"]. Leave empty for all makes.", "items": { "type": "string" } }, "model": { "title": "πŸš™ Models", "type": "array", "description": "Filter by model, e.g. [\"A3\", \"Golf\"]. Most useful with a single make selected.", "items": { "type": "string" } }, "minPrice": { "title": "πŸ’΅ Minimum Price (Β£)", "minimum": 0, "type": "integer", "description": "Minimum price in GBP. Leave empty for no minimum." }, "maxPrice": { "title": "πŸ’° Maximum Price (Β£)", "minimum": 0, "type": "integer", "description": "Maximum price in GBP. Leave empty for no maximum." }, "minYear": { "title": "πŸ“… Minimum Year", "minimum": 1900, "type": "integer", "description": "Earliest registration year. Leave empty for no minimum." }, "maxYear": { "title": "πŸ“… Maximum Year", "minimum": 1900, "type": "integer", "description": "Latest registration year. Leave empty for no maximum." }, "minMileage": { "title": "🧭 Minimum Mileage", "minimum": 0, "type": "integer", "description": "Minimum odometer reading. Leave empty for no minimum." }, "maxMileage": { "title": "🧭 Maximum Mileage", "minimum": 0, "type": "integer", "description": "Maximum odometer reading. Leave empty for no limit." }, "minEngineSize": { "title": "πŸ”§ Minimum Engine Size (litres)", "minimum": 0, "type": "integer", "description": "Minimum engine size in litres (e.g. 1). Leave empty for no minimum." }, "maxEngineSize": { "title": "πŸ”§ Maximum Engine Size (litres)", "minimum": 0, "type": "integer", "description": "Maximum engine size in litres (e.g. 3). Leave empty for no maximum." }, "bodyType": { "title": "πŸš™ Body Types", "uniqueItems": true, "type": "array", "description": "Filter by body type. Leave empty to include all.", "items": { "type": "string", "enum": [ "Convertible", "Coupe", "Estate", "Hatchback", "MPV", "Pickup", "Saloon", "SUV", "Camper", "Car Derived Van", "Combi Van", "Limousine", "Minibus", "Panel Van", "Window Van" ] } }, "fuelType": { "title": "β›½ Fuel Types", "uniqueItems": true, "type": "array", "description": "Filter by fuel type. Leave empty to include all.", "items": { "type": "string", "enum": [ "Petrol", "Diesel", "Electric", "Hybrid", "Petrol Plug-in Hybrid", "Diesel Plug-in Hybrid", "Petrol Hybrid", "Diesel Hybrid", "Bi Fuel", "Hydrogen", "Natural Gas" ] } }, "transmission": { "title": "βš™οΈ Transmission", "uniqueItems": true, "type": "array", "description": "Filter by transmission. Leave empty to include all.", "items": { "type": "string", "enum": [ "Automatic", "Manual" ] } }, "colour": { "title": "🎨 Colours", "uniqueItems": true, "type": "array", "description": "Filter by colour. Leave empty to include all.", "items": { "type": "string", "enum": [ "Black", "Blue", "Grey", "White", "Silver", "Red", "Green", "Beige", "Bronze", "Brown", "Gold", "Multicolour", "Orange", "Pink", "Purple", "Yellow" ] } }, "drivetrain": { "title": "πŸ›ž Drivetrains", "uniqueItems": true, "type": "array", "description": "Filter by drivetrain. Leave empty to include all.", "items": { "type": "string", "enum": [ "Four Wheel Drive", "Front Wheel Drive", "Rear Wheel Drive" ] } }, "doors": { "title": "πŸšͺ Doors", "uniqueItems": true, "type": "array", "description": "Filter by number of doors. Leave empty to include all.", "items": { "type": "string", "enum": [ "2", "3", "4", "5" ] } }, "seats": { "title": "πŸ’Ί Seats", "uniqueItems": true, "type": "array", "description": "Filter by number of seats. Leave empty to include all.", "items": { "type": "string", "enum": [ "2", "3", "4", "5", "6", "7", "8" ] } }, "sellerType": { "title": "πŸ§‘β€πŸ’Ό Seller Type", "uniqueItems": true, "type": "array", "description": "Filter by seller type. Leave empty to include all.", "items": { "type": "string", "enum": [ "private", "trade" ], "enumTitles": [ "Private Seller", "Trade / Dealer" ] } }, "keywords": { "title": "πŸ”‘ Keywords", "type": "array", "description": "Free-text keywords the advert must contain, e.g. [\"heated seats\"].", "items": { "type": "string" } }, "proxyConfiguration": { "title": "🌐 Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies are strongly recommended (AutoTrader UK is behind Cloudflare; some IPs are challenged).", "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 } } } } } } } } } }