docs / autotrader
AutoTrader
New and used car listings with prices and specs.
base /autotrader/v12 endpoints
post
/autotrader/v1/search1 creditUK 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 |
post
/autotrader/v1/listing_detail1 creditFull 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 |
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
}