PistonHeads UK Used Car Classifieds Scraper avatar

PistonHeads UK Used Car Classifieds Scraper

Pricing

from $0.49 / 1,000 results

Go to Apify Store
PistonHeads UK Used Car Classifieds Scraper

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

crawlyth forge

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

9 hours ago

Last modified

Features

Limited permissions

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 ID
  • listingUrl — direct link to the listing
  • title — listing headline
  • make, model, year
  • price, 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, colour
  • engineLitres, doors
  • sellerName, sellerType, sellerLocation
  • brandType — PistonHeads' own listing category flag
  • isFeatured — true for promoted listings
  • priceOnApplication — true when no fixed price is published
  • recordType ("carListing"), sourceUrl, scrapedAt

Input

FieldTypeDefaultDescription
modeselectsearchsearch (free-text, first word treated as make) or byMakeModel (structured make/model)
searchQuerystringford focusFree-text query used with mode=search; first word is the make, the rest is the model
makestring–Vehicle manufacturer, lowercase, used with mode=byMakeModel
modelstring–Vehicle model, lowercase/hyphenated, used with mode=byMakeModel
locationstring–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
sortOrderselectdatedate, price_asc, price_desc, relevance, mileage_asc
maxItemsinteger30Hard cap on emitted records

Example: free-text search, cheapest first

{
"mode": "search",
"searchQuery": "bmw 3 series",
"sortOrder": "price_asc",
"maxItems": 50
}
{
"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 sellerType to 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.