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	Required
make	optional
model	optional
postcode	optional
min_price	optional
max_price	optional
min_year	optional
max_year	optional
min_mileage	optional
max_mileage	optional
fuel	optional
body_type	optional
transmission	optional
radius	optional
page	optional
market	optional

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	Required
id	required
postcode	optional
market	optional

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
}