docs / autotrader

AutoTrader

New and used car listings with prices and specs.

base /autotrader/v12 endpoints

post/autotrader/v1/search1 credit

UK car listings (make/model + filters, paginated); postcode defaults to a UK centroid if omitted

Parameter		Allowed / range	Description
make	optional	—	Vehicle make / manufacturer (e.g. 'BMW', 'Ford').
model	optional	—	Vehicle model (e.g. '3 Series'). Use together with make.
postcode	optional	—	UK postcode to anchor the location-based search (defaults to a central England postcode if omitted).
min_price	optional	0–	Minimum price in GBP.
max_price	optional	0–	Maximum price in GBP.
min_year	optional	1900–2100	Earliest year of manufacture.
max_year	optional	1900–2100	Latest year of manufacture.
min_mileage	optional	0–	Minimum mileage (miles).
max_mileage	optional	0–	Maximum mileage (miles).
fuel	optional	Petrol · Diesel · Electric · Hybrid · Plug-in Hybrid	Fuel type. Common values shown; other AutoTrader fuel labels are also accepted (forwarded to the FilterName enum).
body_type	optional	Hatchback · Saloon · Estate · SUV · Coupe · Convertible · MPV	Body style. Common values shown; other AutoTrader body labels are also accepted.
transmission	optional	Manual · Automatic	Gearbox type.
radius	optional	0–	Search radius in miles around the postcode.
page = 1	optional	1–	Results page (paginated). Default 1.
market = uk	optional	uk · us	Marketplace region. Only 'uk' returns listings; 'us' is currently unavailable (use the cars-com engine for US).

Try in playground →

post/autotrader/v1/listing_detail1 credit

Full advert (price+priceIndicator+deviation, mileage, full spec [fuel/trans/body/doors/seats/engine], description, images[], dealer+reviews+address)

Parameter		Allowed / range	Description
id	required	—	AutoTrader advert id (the digits in a /car-details/<id> URL or a search listing's advertId). Provide id OR url.
url	optional	—	Full advert URL (alternative to id; the id is parsed from /car-details/<id>).
postcode	optional	—	UK postcode to anchor the location-based search (defaults to a central England postcode if omitted).
market = uk	optional	uk · us	Marketplace region. Only 'uk' returns listings; 'us' is currently unavailable (use the cars-com engine for US).

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/autotrader/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"make":"BMW","model":"3 Series","postcode":"SW1A 1AA","market":"uk"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}