Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

postcode
string
required

UK postcode to anchor the search, e.g. 'SW1A 1AA'

Minimum string length: 1
radius
integer

Search radius in miles

Required range: x <= 9007199254740991
make
string

Vehicle make, e.g. 'BMW'

Minimum string length: 1
model
string

Vehicle model, e.g. '3 Series'

Minimum string length: 1
year_from
integer

Minimum registration year

Required range: 1900 <= x <= 9007199254740991
year_to
integer

Maximum registration year

Required range: 1900 <= x <= 9007199254740991
exclude_writeoffs
boolean

Exclude write-off category vehicles

page
integer

Result page number

Required range: x <= 9007199254740991
geo
string

Country to use when submitting the request, e.g. 'gb', 'us', 'de'

Required string length: 2 - 64

Response

Structured AutoTrader search results.

provider
enum<string>
required
Available options:
autotrader
page_type
enum<string>
required
Available options:
search
snapshot_at
string
required
query_context
object
required
meta_data
object
required
results
object[]
required