PistonHeads UK Used Car Classifieds Scraper
Pricing
from $0.49 / 1,000 results
PistonHeads UK Used Car Classifieds Scraper
Search PistonHeads UK used-car listings by free text or by make and model, returning price, mileage, spec and seller details for each matching listing.
Pricing
from $0.49 / 1,000 results
Rating
0.0
(0)
Developer
crawlyth forge
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
9 hours ago
Last modified
Categories
Features
Share
PistonHeads is a UK car classifieds and enthusiast site with used-car listings by make and model. This actor reads PistonHeads' own listing data embedded in its search pages, so you get one structured record per car without visiting each listing individually.
What this actor does
- Searches PistonHeads listings either by free text ("ford focus") or by a structured make + model pair
- Resolves a model name to PistonHeads' own generation slugs (e.g. "3 series" to several BMW 3 Series generations) and pulls listings across all matching generations
- Sorts results by date, price or mileage before trimming to your requested count
- Returns make, model, year, price, mileage, spec and seller details for every matched listing
- Omits any field PistonHeads didn't publish for that listing — no blank or placeholder values
Output per listing
listingId— PistonHeads' internal advert IDlistingUrl— direct link to the listingtitle— listing headlinemake,model,yearprice,priceCurrency(GBP)description— listing summary text (up to 1000 characters)imageCount— number of photos on the listing (photo URLs are not included, see FAQ)mileage,mileageUnit(miles)fuelType,transmission,bodyType,colourengineLitres,doorssellerName,sellerType,sellerLocationbrandType— PistonHeads' own listing category flagisFeatured—truefor promoted listingspriceOnApplication—truewhen no fixed price is publishedrecordType("carListing"),sourceUrl,scrapedAt
Input
| Field | Type | Default | Description |
|---|---|---|---|
mode | select | search | search (free-text, first word treated as make) or byMakeModel (structured make/model) |
searchQuery | string | ford focus | Free-text query used with mode=search; first word is the make, the rest is the model |
make | string | – | Vehicle manufacturer, lowercase, used with mode=byMakeModel |
model | string | – | Vehicle model, lowercase/hyphenated, used with mode=byMakeModel |
location | string | – | Label attached to a record's sellerLocation only when PistonHeads doesn't publish a seller town for that listing; it does not filter results geographically |
sortOrder | select | date | date, price_asc, price_desc, relevance, mileage_asc |
maxItems | integer | 30 | Hard cap on emitted records |
Example: free-text search, cheapest first
{"mode": "search","searchQuery": "bmw 3 series","sortOrder": "price_asc","maxItems": 50}
Example: structured make/model search
{"mode": "byMakeModel","make": "volkswagen","model": "golf","sortOrder": "date","maxItems": 30}
Use cases
- Used car price research — compare asking prices for a make/model across current PistonHeads listings
- Market monitoring — track newly posted listings for a specific model on a schedule
- Spec comparisons — pull fuel type, transmission, engine size and mileage side by side for a shortlist
- Dealer vs private analysis — use
sellerTypeto separate trade and private-seller listings
FAQ
Is this affiliated with PistonHeads? No. This is an independent tool that reads PistonHeads' public listing pages; it is not operated by or affiliated with PistonHeads.
What's the real difference between search and byMakeModel? Both end up resolving the same make/model lookup internally — search just parses your free-text query into a make (first word) and model (remaining words) before running the identical search. Use whichever input shape is more convenient.
Why is there no imageUrl field? PistonHeads' image CDN blocks non-browser requests to its photo URLs, so photo links returned by this actor wouldn't actually load. imageCount tells you how many photos the listing has instead.
Does location filter results by area? No. PistonHeads' search here is organized by make/model, not postcode radius. location is only used to fill in sellerLocation on records where PistonHeads itself doesn't publish a seller town.
Why do some listings have no price? When a seller marks a listing "price on application" instead of a fixed figure, price is omitted and priceOnApplication is set to true.
Do I need a login, proxy or API key? No. PistonHeads' listing pages are public and the actor reads them directly.
What happens if my model doesn't match any PistonHeads generation? The actor logs a warning and falls back to a make-wide search instead of returning zero results.
Can I sort by mileage? Yes, set sortOrder to mileage_asc for lowest mileage first.