{ "openapi": "3.0.1", "info": { "title": "PistonHeads UK Car Classifieds Scraper", "description": "Scrape UK performance and enthusiast car listings from PistonHeads.com. Returns prices, mileage, specs, seller details and image galleries. Filter by make, model, price, year, body, fuel.", "version": "0.0", "x-build-id": "sSTs2p6rNm1e0kbLZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~pistonheads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-pistonheads-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/parseforge~pistonheads-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-pistonheads-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/parseforge~pistonheads-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-pistonheads-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": { "searchUrl": { "title": "Search URL (optional)", "type": "string", "description": "Paste a PistonHeads.com search URL to use the exact filters from your browser. Examples: https://www.pistonheads.com/buy/search?priceMax=50000&yearMin=2020 or https://www.pistonheads.com/buy/aston-martin/db9. Leave blank to use the filter fields below." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "makeUrlName": { "title": "Make", "enum": [ "abarth", "ac", "adler", "ajs", "alfa-romeo", "allard", "alpina", "alpine", "alta", "alvis", "american-motors", "amilcar", "amphicar", "andre", "ariel", "arkley", "armstrong-siddeley", "arrol-aster", "asaido", "ascari", "ascot", "aston-martin", "atalanta", "auburn", "audi", "austin", "austin-healey", "austro-daimler", "autocraft", "autovia", "bac", "ballot", "bantam", "batten", "bedford", "bentley", "berkeley", "beverley", "bianchi", "bike-powered-cars", "bitter", "bizzarrini", "bmw", "bond", "borgward", "boring-stuff", "bowler", "brabham", "bristol", "britannia", "british-salmson", "brooke", "brough-superior", "buckler", "bugatti", "buick", "burney", "byd", "cadillac", "caparo", "carver", "caterham", "chenard-walcker", "chevrolet", "chrysler", "cisitalia", "citroen", "clan", "cleco", "clement", "colt", "connaught", "cord", "cornet", "costin", "coventry-victor", "cransac", "crossley", "cupra", "dacia", "daewoo", "daf", "daihatsu", "daimler", "darracq", "datsun", "davarian", "de-soto", "de-tomaso", "delage", "delahaye", "delaunay-belleville", "dellow", "delorean", "denza", "derby", "dkw", "dodge", "donnet", "dri-sleeve", "ds-automobiles", "duesenberg", "dutton", "elemental", "elva", "enfield", "erskine", "essex", "evante", "excalibur", "excelsior", "facel-vega", "fairthorpe", "falcon", "farbio", "ferrari", "fiat", "fisker", "ford", "franklin", "frazer-nash", "frazer-tickford", "frisky", "gardner-douglas", "gb-roadster", "genesis", "georges-irat", "gilbern", "ginetta", "gitane", "gk", "glas", "gmc", "graham", "great-british-sports-cars", "great-wall", "grinnall", "gsm", "gumpert", "hampton", "hansa", "healey", "heinkel", "heron", "hillman", "hispano-suiza", "hmc", "holden", "hommell", "honda", "horch", "hotchkiss", "hrg", "hudson", "humber", "hummer", "hupmobile", "hyundai", "imperia", "ineos", "infiniti", "innocenti", "invicta", "iso", "isotta-fraschini", "isuzu", "itala", "iveco", "jaguar", "javan", "jeep", "jensen", "jewel", "jmb", "jouffret", "jowett", "kia", "kieft", "kit-cars", "koenigsegg", "ktm", "la-salle", "lada", "lagonda", "lamborghini", "lammas", "lanchester", "lancia", "land-rover", "lavie", "lea-francis", "left-hand-drive", "leidart", "lexus", "leyland", "light-car-company", "lincoln", "lister", "lloyd", "lmb", "lola", "london-taxis-international", "lorraine-dietrich", "lotus", "lpg-alternative-fuels", "man", "marauder", "marcos", "marendaz", "marlin", "marmon", "marquette", "maserati", "mathis", "matra", "matra-simca", "maxus", "maxwell", "maybach", "mazda", "mclaren", "mercedes-benz", "mercury", "messerschmitt", "metropolitan", "mg", "micro", "midas", "minerva", "mini", "mini-classic", "mini-marcos", "minijem", "mitsubishi", "mitsuoka", "monica", "monteverdi", "moon", "morgan", "morris", "moskvich", "mosler", "moveo", "mst", "nash", "nash-healey", "nissan", "noble", "nsu", "ogle", "oldsmobile", "om", "opel", "opperman", "opus-hrf", "other-makes", "packard", "pagani", "panhard", "panther", "paramount", "peel", "peerless", "peugeot", "peykan", "pgo", "pierce-arrow", "piper", "plymouth", "polestar", "polski-fiat", "pontiac", "porsche", "powerdrive", "princess", "prodrive", "proton", "puma", "qoros", "quadzilla", "radical", "railton", "ram-trucks", "rapier", "reliant", "renault", "reo", "replica", "rhode", "riley", "rimac", "rivian", "rochdale", "rochet-schneider", "rockne", "rodley", "rolls-royce", "rover", "russon", "rytecraft", "saab", "salmson", "saturn", "scootacar", "scorpion", "seat", "sebring", "secma", "shelby", "siata", "simca", "singer", "skoda", "smart-car", "spartan", "spectre", "speedwell", "spire", "spyker", "squire", "ss", "ssangyong", "standard", "star", "stealth", "steyr", "steyr-puch", "strathcarron", "studebaker", "stutz", "subaru", "sunbeam", "superformance", "suzuki", "swallow", "swift", "talbot", "talbot-lago", "tata", "tatra", "terraplane", "tesla", "tiger", "tojeiro", "tommykaira", "tornado", "tourette", "toyota", "trabant", "tracta", "trident", "triumph", "trojan", "turner", "tvr", "ultima", "unipower", "vale-special", "vanden-plas", "vauxhall", "venturi", "veritas", "vignale-fiat", "voisin", "volga", "volkswagen", "volvo", "vuhl", "wanderer", "wartburg", "warwick", "westfield", "whitlock", "wiesmann", "william", "willys", "willys-knight", "wolseley", "zagato", "zaporozhets", "zenos" ], "type": "string", "description": "Filter listings by manufacturer (e.g. aston-martin, porsche, bmw)." }, "modelKeyword": { "title": "Model keyword", "type": "string", "description": "Filter by model name (free-text keyword search). Examples: '911', 'M3', 'Defender'." }, "priceMin": { "title": "Minimum price (GBP)", "minimum": 0, "type": "integer", "description": "Minimum asking price in pounds." }, "priceMax": { "title": "Maximum price (GBP)", "minimum": 0, "type": "integer", "description": "Maximum asking price in pounds." }, "yearMin": { "title": "Minimum year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Earliest registration year." }, "yearMax": { "title": "Maximum year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Latest registration year." }, "mileageMin": { "title": "Minimum mileage", "minimum": 0, "type": "integer", "description": "Minimum odometer reading in miles." }, "mileageMax": { "title": "Maximum mileage", "minimum": 0, "type": "integer", "description": "Maximum odometer reading in miles." }, "keywords": { "title": "Keywords", "type": "string", "description": "Free-text keyword search in headlines and listings (e.g. 'manual', 'rs', 'gt3')." }, "fuelTypeCodes": { "title": "Fuel type", "type": "array", "description": "Filter by fuel type. Multi-select allowed.", "items": { "type": "string", "enum": [ "PTL", "DSL", "ELE", "HYB", "LPG", "OTH" ], "enumTitles": [ "Petrol", "Diesel", "Electric", "Hybrid", "LPG", "Other" ] } }, "transmission": { "title": "Transmission", "type": "array", "description": "Filter by gearbox type. Multi-select allowed.", "items": { "type": "string", "enum": [ "ATO", "MAN", "OTH" ], "enumTitles": [ "Automatic", "Manual", "Other" ] } }, "bodyTypeCodes": { "title": "Body type", "type": "array", "description": "Filter by body style. Multi-select allowed.", "items": { "type": "string", "enum": [ "CON", "COU", "EST", "SUV", "HTC", "SAL", "MPV", "PKU", "OTH" ], "enumTitles": [ "Convertible", "Coupe", "Estate", "SUV", "Hatchback", "Saloon", "MPV", "Pick Up", "Other" ] } }, "colourCodes": { "title": "Colour", "type": "array", "description": "Filter by exterior colour. Multi-select allowed.", "items": { "type": "string", "enum": [ "BLA", "BLU", "GRN", "GRY", "RED", "SIL", "WHI", "YEL", "BEI", "BRO", "BRZ", "CRE", "GOL", "MAR", "MUL", "ORA", "PNK", "PPL", "TUR" ], "enumTitles": [ "Black", "Blue", "Green", "Grey", "Red", "Silver", "White", "Yellow", "Beige", "Brown", "Bronze", "Cream", "Gold", "Maroon", "Multi colour", "Orange", "Pink", "Purple", "Turquoise" ] } }, "driveTrain": { "title": "Drivetrain", "type": "array", "description": "Filter by drivetrain layout. Multi-select allowed.", "items": { "type": "string", "enum": [ "FRO", "REA", "AWD", "OTH" ], "enumTitles": [ "Front-wheel drive", "Rear-wheel drive", "4-wheel drive", "Other" ] } }, "noDoors": { "title": "Number of doors", "type": "array", "description": "Filter by number of doors.", "items": { "type": "string", "enum": [ "002", "003", "004", "005", "006" ], "enumTitles": [ "2", "3", "4", "5", "6" ] } }, "seats": { "title": "Number of seats", "type": "array", "description": "Filter by number of seats.", "items": { "type": "string", "enum": [ "2", "3", "4", "5", "6", "7", "8", "9" ], "enumTitles": [ "2", "3", "4", "5", "6", "7", "8", "9" ] } }, "sellerType": { "title": "Seller type", "enum": [ "", "Private", "Trade" ], "type": "string", "description": "Filter by seller category." }, "postcode": { "title": "Postcode", "type": "string", "description": "UK postcode for distance-based search (use together with the Distance field)." }, "distance": { "title": "Distance from postcode", "enum": [ "", "10", "25", "50", "100", "200" ], "type": "string", "description": "Search radius around the postcode in miles.", "default": "" }, "sortOption": { "title": "Sort order", "enum": [ "mostRelevant", "mostRecent", "priceAsc", "priceDesc", "distance", "mileage", "yearDesc", "yearAsc" ], "type": "string", "description": "Sort order of the results.", "default": "mostRelevant" }, "includeSold": { "title": "Include sold cars", "type": "boolean", "description": "Include listings that are already sold.", "default": false }, "pricingModels": { "title": "Listing type", "type": "array", "description": "Restrict to specific listing types (auctions, classifieds, or part-exchange).", "items": { "type": "string", "enum": [ "Visible", "OnApplication", "OnlineAuction", "AuctionHouse" ], "enumTitles": [ "Visible price", "Price on application", "Online auction", "Auction house" ] } } } }, "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 } } } } } } } } } }