Skip to main content
Piloterr
Back to library

Autotrader Search API

Search AutoTrader UK listings from a car-search URL and retrieve prices, specs, photos, seller info, and pagination via browser rendering.

Active2 credits = 1 requestGET/v2/autotrader/search

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

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.

QuickstartLink to Quickstart

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.

ParametersLink to Parameters

Parameter Type Required Description
query string yes Full AutoTrader UK /car-search URL

Response fieldsLink to Response fields

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

NotesLink to Notes

  • 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.

Main use casesLink to Main use cases

  • 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

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included