{ "openapi": "3.0.1", "info": { "title": "AutoTrader UK Scraper", "description": "[💰 $0.8 / 1K] Extract used and new car listings from AutoTrader.co.uk — price, mileage, year, specs, dealer info, finance quotes, and high-res images. Search by postcode + radius or paste any AutoTrader URL.", "version": "1.0", "x-build-id": "USpIhaihHNRo7T1oe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~autotrader-co-uk-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-autotrader-co-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/solidcode~autotrader-co-uk-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-autotrader-co-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/solidcode~autotrader-co-uk-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-autotrader-co-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", "properties": { "startUrls": { "title": "AutoTrader URLs", "type": "array", "description": "Paste AutoTrader.co.uk search result URLs or individual car-detail URLs (e.g. 'https://www.autotrader.co.uk/car-search?postcode=SW1A1AA&make=BMW' or 'https://www.autotrader.co.uk/car-details/202504251717568'). When provided, these are used directly and the search filters below are ignored. Useful when you already have a saved search.", "items": { "type": "string" } }, "postcode": { "title": "Postcode", "type": "string", "description": "UK postcode to search around, e.g. 'SW1A 1AA' or 'M1 1AE'. Used together with Search Radius. Ignored when AutoTrader URLs are provided." }, "radius": { "title": "Search Radius (miles)", "enum": [ "1", "5", "10", "15", "20", "30", "50", "75", "100", "200", "1500" ], "type": "string", "description": "How far around the postcode to search, in miles. Use 'Nationwide' to search the whole UK. When calling the actor via API, quote the value as a string (e.g. `\"30\"`, not `30`) — the Apify dropdown editor requires string values here.", "default": "200" }, "make": { "title": "Make", "type": "string", "description": "Manufacturer name as shown on AutoTrader, e.g. 'BMW', 'Volkswagen', 'Ford'. Leave empty for all makes." }, "model": { "title": "Model", "type": "string", "description": "Model name as shown on AutoTrader (must match the chosen Make), e.g. '3 Series', 'Golf', 'Focus'. Leave empty for all models." }, "condition": { "title": "Condition", "enum": [ "any", "new", "used" ], "type": "string", "description": "Filter to new, used, or any car condition. Filtering is applied to the search results as they are returned, so 'New' or 'Used' may yield fewer rows per page than the unfiltered total shown by AutoTrader.", "default": "any" }, "bodyType": { "title": "Body Type", "uniqueItems": true, "type": "array", "description": "Filter by one or more body types. Leave empty for all body types.", "items": { "type": "string", "enum": [ "Hatchback", "Saloon", "Estate", "SUV", "Coupe", "Convertible", "MPV", "Pickup", "Van", "Camper", "Limousine" ], "enumTitles": [ "Hatchback", "Saloon", "Estate", "SUV", "Coupe", "Convertible", "MPV", "Pickup", "Van", "Camper", "Limousine" ] }, "default": [] }, "fuelType": { "title": "Fuel Type", "uniqueItems": true, "type": "array", "description": "Filter by one or more fuel types. Leave empty for all fuel types.", "items": { "type": "string", "enum": [ "Petrol", "Diesel", "Electric", "Hybrid", "Plug-in Hybrid", "LPG", "Bi-Fuel" ], "enumTitles": [ "Petrol", "Diesel", "Electric", "Hybrid", "Plug-in Hybrid", "LPG", "Bi-Fuel" ] }, "default": [] }, "gearbox": { "title": "Gearbox", "enum": [ "any", "Manual", "Automatic" ], "type": "string", "description": "Transmission type.", "default": "any" }, "priceMin": { "title": "Minimum Price (GBP)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only include cars at or above this price in pounds. Leave empty for no lower bound." }, "priceMax": { "title": "Maximum Price (GBP)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only include cars at or below this price in pounds. Leave empty for no upper bound." }, "yearMin": { "title": "Minimum Year", "minimum": 1950, "maximum": 2030, "type": "integer", "description": "Only include cars first registered in or after this year (e.g. 2018). Leave empty for any age." }, "yearMax": { "title": "Maximum Year", "minimum": 1950, "maximum": 2030, "type": "integer", "description": "Only include cars first registered in or before this year. Leave empty for any age." }, "mileageMax": { "title": "Maximum Mileage", "minimum": 0, "maximum": 500000, "type": "integer", "description": "Only include cars with at most this many miles on the clock. Leave empty for any mileage." }, "sellerType": { "title": "Seller Type", "enum": [ "any", "trade", "private" ], "type": "string", "description": "Filter listings by who is selling.", "default": "any" }, "sortBy": { "title": "Sort By", "enum": [ "relevance", "priceAsc", "priceDesc", "yearDesc", "yearAsc", "mileageAsc", "distance", "datestamp" ], "type": "string", "description": "How to order the search results. Defaults to AutoTrader's relevance ranking.", "default": "relevance" }, "includeListingDetails": { "title": "Include full listing details", "type": "boolean", "description": "When enabled, every search-result row is enriched with the full listing page (specifications, finance quotes, dealer profile, all images, vehicle history, features). Disable for a faster, lighter run that only returns the search-result fields.", "default": true }, "maxResults": { "title": "Maximum Results", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum number of car listings to return per search query or URL. The actor may return a few extra from the final page — it stops requesting new pages once the cap is reached. Set to 0 for unlimited (subject to AutoTrader's pagination ceiling).", "default": 100 } } }, "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 } } } } } } } } } }