Extract vehicle listings from any AutoTrader UK search results page (autotrader.co.uk/car-search). Returns structured listings with price, mileage, year, location, seller type, photos, and pagination metadata.
AutoTrader UK search pages are React single-page applications (sauron-search-results-app). Listing cards (data-testid="advertCard-*") are injected after JavaScript runs. A plain HTTP request only returns an empty HTML shell. Piloterr uses website rendering to load the page in a browser, wait for listings to appear, and extract structured JSON from the rendered DOM.
GET https://api.piloterr.com/v2/autotrader/search?query=https://www.autotrader.co.uk/car-search?channel=cars&postcode=W1F%208EB&price_search_type=total&sort=relevance&page=1
Copy the full search URL from autotrader.co.uk. Append ?page=2 (or update the page query param) for pagination.
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Full AutoTrader UK /car-search URL |
| Field |
Type |
Description |
results |
array |
List of vehicle listings |
results[].id |
string |
AutoTrader advert ID |
results[].url |
string |
Car details URL |
results[].title |
string | null |
Make and model title |
results[].subtitle |
string | null |
Trim / derivative |
results[].price |
string | null |
Formatted price (e.g. £2,500) |
results[].price_amount |
integer | null |
Numeric price in GBP |
results[].year |
string | null |
Registration year (e.g. 2007 (07 reg)) |
results[].mileage |
string | null |
Mileage string |
results[].location |
string | null |
Seller location |
results[].seller_type |
string | null |
dealer or private |
results[].attention_grabber |
string | null |
Dealer highlight text |
results[].image |
string | null |
Main thumbnail URL |
results[].images |
array |
Gallery image URLs |
pagination.current |
integer |
Current page number |
pagination.next |
integer | null |
Next page number |
pagination.next_url |
string | null |
Next page URL |
pagination.total_pages |
integer |
Total pages |
pagination.total_count |
integer |
Total matching listings |
pagination.per_page |
integer |
Results on this page |
pagination.has_next_page |
boolean |
Whether a next page exists |
- Targets autotrader.co.uk (UK). US listings on autotrader.com are not supported.
- Filters in the URL (
postcode, make, price, sort, etc.) are respected.
- Some cards may return partial data depending on listing type.
- Pass a car details URL to the AutoTrader Ad endpoint for full specs, description, and seller contact.
- Monitor used car inventory and pricing across UK postcodes
- Build dealer lead lists with price, mileage, and location
- Feed automotive analytics pipelines with live market data
- Track pagination across AutoTrader search result pages
