{ "openapi": "3.0.1", "info": { "title": "Autotrader UK Scraper", "description": "Extract structured UK car listings from Autotrader search URLs. Collect prices, mileage, specs, images, running costs, vehicle history, dealer profiles, reviews, other stock, delivery and finance data. Fast feed summaries or full vehicle profiles.", "version": "0.0", "x-build-id": "0VMgBj9fhyqyZe9Yf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/calm_builder~autotrader-uk-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-calm_builder-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/calm_builder~autotrader-uk-scraper/runs": { "post": { "operationId": "runs-sync-calm_builder-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/calm_builder~autotrader-uk-scraper/run-sync": { "post": { "operationId": "run-sync-calm_builder-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": [ "startUrls" ], "properties": { "startUrls": { "title": "Search URLs", "minItems": 1, "type": "array", "description": "One or more Autotrader UK car search URLs (car-search pages). Each URL must include a postcode (for example postcode=EC1A1BB) — this is the buyer location used for search results, pricing context, and distance. Copy a URL directly from your search on autotrader.co.uk after setting make, model, filters, and postcode.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxListings": { "title": "Maximum listings per search URL", "minimum": 1, "maximum": 100000, "type": "integer", "description": "How many listings to collect from each search URL. Total results can be up to this value multiplied by the number of URLs. Duplicate listings are removed within each URL only — the same vehicle may appear in the output more than once if it is returned by multiple search URLs.", "default": 10 }, "fetchDetails": { "title": "Full vehicle details", "type": "boolean", "description": "Fetch complete data for each vehicle: specifications, features, images, history checks, running costs, and description. If disabled, only summary fields from the search results are saved.", "default": false }, "fetchSellerProfile": { "title": "Dealer profile", "type": "boolean", "description": "Include dealer name, distance from the search postcode, and review summary. Private sellers are skipped automatically.", "default": false }, "fetchSellerReviews": { "title": "Dealer reviews", "type": "boolean", "description": "Include individual dealer reviews (text, rating, date). Requires Dealer profile to be enabled.", "default": false }, "maxReviewsPerSeller": { "title": "Maximum reviews per dealer", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many dealer reviews to collect per dealer. Requires Dealer reviews to be enabled.", "default": 10 }, "fetchSellerOtherListings": { "title": "Dealer other listings", "type": "boolean", "description": "Include other vehicles currently listed by the same dealer. Requires Dealer profile to be enabled.", "default": false }, "maxOtherListingsPerSeller": { "title": "Maximum other listings per dealer", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many additional dealer listings to collect per dealer. Requires Dealer other listings to be enabled.", "default": 10 }, "attachSellerToListings": { "title": "Attach dealer data to each listing", "type": "boolean", "description": "When enabled, dealer profile, reviews, and other listings are copied onto every car from that dealer. When disabled, dealer data is written as separate dataset records (recommended for large runs) — each record includes a record type so you can tell listings apart from seller profiles (for example listing or seller). Requires Dealer profile to be enabled.", "default": false }, "fetchDeliveryOptions": { "title": "Delivery and collection", "type": "boolean", "description": "Include home delivery, click-and-collect, and collection location options for the buyer postcode on each listing.", "default": false }, "fetchFinanceQuotes": { "title": "Finance quotes", "type": "boolean", "description": "Include finance calculator quotes (monthly payments, terms) for each vehicle where available.", "default": false }, "financeDeposit": { "title": "Finance deposit", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Deposit amount in GBP used for finance quote calculations. Requires Finance quotes to be enabled.", "default": 1000 }, "financeTermMonths": { "title": "Finance term", "minimum": 12, "maximum": 120, "type": "integer", "description": "Loan term in months used for finance quote calculations. Requires Finance quotes to be enabled.", "default": 48 }, "financeAnnualMileage": { "title": "Finance annual mileage", "minimum": 1000, "maximum": 500000, "type": "integer", "description": "Annual mileage used for finance quote calculations. Requires Finance quotes to be enabled.", "default": 10000 } } }, "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 } } } } } } } } } }