With the Current Valuations capability on Autotrader Connect, you will have access to view Autotrader’s valuations via the Vehicles API, Stock API, and Valuations API.
Here's a full list of the functionality:
- Vehicle lookup valuations
- In-stock valuations
- Adjusted valuations
- Condition-adjusted valuation
- Feature-adjusted valuation
- Expected price indicator rating
The valuations that will be provided by this capability are:
- Retail – This represents what the vehicle is worth if listed on Autotrader by a dealer. This valuation assumes the condition is ‘retail ready’. It cannot be adjusted for any other condition rating.
- Trade – This represents what the vehicle is worth if listed for trade between dealers. Effectively the value of the vehicle excluding any margin.
- Private – This represents what the vehicle is worth if listed by a private seller on Autotrader
- Part-exchange – This represents what the vehicle is worth if it is to be used by a consumer as part-exchange for another vehicle
Retrieve valuation with a VRM
As part of this capability, you’ll be able to access our market average valuations via the Vehicles API.
To get this, you’ll need to make a GET request to the Vehicles API with:
- The Autotrader advertiser ID of the dealer the request is for
- The VRM in the registration query parameter
- The vehicle’s mileage in the query string parameter odometerReadingMiles
- The query string parameter valuations=true
If successful, you’ll get a JSON object that contains the vehicle data and our valuations. None of these valuations will be adjusted for features or condition, and are all based on the market average.
If we don’t have vehicle data for that registration, you’ll get a 404 response code.
Check out examples of Vehicle API calls
Stock list valuation
You will also be able to access our market average and feature-adjusted valuations via the Stock API.
To get this, you’ll need to make a GET request to the Stock API with:
- The Autotrader advertiser ID of the dealer the request is for
- The query string parameter valuations=true
- The page and pageSize query string parameters for pagination
If successful, you’ll get a JSON object that contains all your stock data with each of their valuations.
In the valuations object of the response, you will get a market average and feature-adjusted valuations for all stock records returned in the request.
Check out examples of Stock API calls
Adjusted valuations
You’ll also be able to access our valuations and adjust them for the vehicle’s condition and features via the Valuations API.
To do this, you will need to make a POST request to the Valuations API with:
- The Autotrader advertiser ID of the dealer the request is for
- The request body should include:
- The vehicle’s derivative ID
- The vehicle’s first registration date
- The vehicle’s mileage
If successful, you’ll get a JSON object that contains the valuations for that vehicle. If no further data is supplied, none of these valuations will be adjusted, and will all be based on the market average.
Condition-adjusted valuation
To get a condition-adjusted valuation for a vehicle, add one of the following condition ratings to the payload of your Valuations API POST request:
- Excellent
- Great
- Good
- Fair
- Poor
For details on when each of these ratings should be used, check out our API developer documentation.
Feature-adjusted valuation
To get a feature-adjusted valuation for a vehicle, add the features in an array in the payload of your Valuations API POST request.
This should be a list of all standard and optional features that are on the vehicle.
If you pass an empty array of features, then you will get the base valuation for that derivative. This is the valuation if there are no features that increase the value of the vehicle.
Expected price indicator rating
You can also use the Valuations API to get an expected price indicator rating for a vehicle.
To do this, pass in a retail price that the vehicle would be listed at on Autotrader. If successful, you’ll get a price indicator rating based on the price and vehicle details in the request.
For accuracy, it is important to include features when trying to get a price indicator rating, as the price indicator on the Autotrader website is based on the feature-adjusted valuation of a vehicle.
Check out examples of Valuations API calls
Error handling
When using the APIs above, you may get error response codes that you need to handle. This makes sure you have a smooth service for both you, as a partner, and your end user.