{ "openapi": "3.0.1", "info": { "title": "Autotrader UK Scraper: Used Car Listings", "description": "Scrape Autotrader.co.uk car listings by make, model, price, year, mileage, fuel and seller type near a UK postcode. Price and price rating, year, registration, mileage, condition, seller type, location, distance and photos. Unofficial.", "version": "0.1", "x-build-id": "FiJyaKAWc6y6qw64L" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reventadata~autotrader-uk-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reventadata-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/reventadata~autotrader-uk-scraper/runs": { "post": { "operationId": "runs-sync-reventadata-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/reventadata~autotrader-uk-scraper/run-sync": { "post": { "operationId": "run-sync-reventadata-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", "properties": { "make": { "title": "Make", "type": "string", "description": "Car make as Autotrader spells it, for example \"BMW\" or \"Ford\". Leave empty for all makes. A make the site does not know returns 0 results." }, "model": { "title": "Model", "type": "string", "description": "Car model as Autotrader spells it, for example \"3 Series\". Needs a make. Leave empty for all models." }, "minPrice": { "title": "Minimum price (GBP)", "minimum": 0, "type": "integer", "description": "Optional. Lowest asking price in pounds. Left out of the request when empty." }, "maxPrice": { "title": "Maximum price (GBP)", "minimum": 0, "type": "integer", "description": "Optional. Highest asking price in pounds. Left out of the request when empty." }, "minYear": { "title": "Earliest year", "minimum": 1900, "type": "integer", "description": "Optional. Earliest year of manufacture, for example 2015." }, "maxYear": { "title": "Latest year", "minimum": 1900, "type": "integer", "description": "Optional. Latest year of manufacture, for example 2020." }, "maxMileage": { "title": "Maximum mileage", "minimum": 0, "type": "integer", "description": "Optional. Highest mileage in miles, for example 50000." }, "fuelType": { "title": "Fuel type", "enum": [ "Petrol", "Diesel" ], "type": "string", "description": "Optional. Only the two fuel types that were tested are offered; leave empty for every fuel." }, "sellerType": { "title": "Seller", "enum": [ "any", "private", "trade" ], "type": "string", "description": "Any seller, private sellers only, or trade (dealers) only.", "default": "any" }, "postcode": { "title": "Postcode", "type": "string", "description": "UK postcode the search is measured from, for example \"SW1A 1AA\". The site needs one; without it the Actor uses SW1A 1AA. On its own it does not limit results: cars from all over the UK are returned, with the distance from this postcode in each row.", "default": "SW1A 1AA" }, "distance": { "title": "Distance (miles)", "minimum": 1, "type": "integer", "description": "Optional. Only cars within this many miles of the postcode, for example 50. Left out of the request when empty, which means the whole UK." }, "sortBy": { "title": "Sort order", "enum": [ "relevance", "price_asc" ], "type": "string", "description": "Relevance (the site default) or cheapest first.", "default": "relevance" }, "maxItems": { "title": "Maximum rows", "minimum": 1, "type": "integer", "description": "Hard cap on rows pushed. The site serves at most 2,000 ads (100 pages of 20) per search; narrow the filters to reach more.", "default": 1000 }, "maxPages": { "title": "Maximum pages", "minimum": 1, "maximum": 100, "type": "integer", "description": "Optional cap on result pages (20 cars each, at most 100). Without it the run walks every page the site reports for the search, or stops at Maximum rows." }, "includeDetails": { "title": "Add detail-page fields", "type": "boolean", "description": "Also open each car's page to add the description, seller name, phone, email and address (as the seller published them), fuel, gearbox, body type, engine size, doors, seats, colour, owners, registration date, running costs, performance figures and the feature list. One extra request per row, so the run is slower.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Left off by default; turn it on only if you see request failures.", "default": { "useApifyProxy": false } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }