Market Statistics

Get key statistics on any vehicle ID

Overview

The Market Overlay Statistics API delivers statistics we generate on your behalf from the Market Overlay endpoint.

Get the lead statistics used to justify pricing for a given AutoGrab Vehicle ID.

Get the lead statistics used to justify pricing for a given AutoGrab Vehicle ID.

get

/v2/sourcing/market_overlay/statistics/{vehicle_id}

Authorizations

Path parameters

vehicle_idanyrequired

Query parameters

minimum_daysany

The minimum number of days to show listings for

include_adjacent_yearsany

If enabled, vehicles that were manufactured up to one year before and one year after your chosen vehicle will also be included in the results.

exclude_outliersany

If enabled, leads that are considered outliers will be excluded from the results.

exclude_all_delistedany

If enabled, leads that are not currently on the market will be excluded from the results.

include_all_activeany

If enabled, all listings that are currently on the market will be returned, instead of only listings which were uploaded within the specified timeframe (minimum_days). Additionally, if this is enabled, delisted leads will be returned based on the number of days since they were sold, rather than the number of days since they were listed.

include_trashany

If enabled, leads that are considered trash, written off, damaged, or missing details will be included in the results. The tag_ids array can then be used to determine if a lead is trash, damaged, etc.

featuresany

Comma separated array of additional overlay feature codes as specified in your contract

odometer_range_minany

The minimum range observed against similar vehicles

odometer_range_maxany

The maximum range observed against similar vehicles

regionany

The region to perform this request in

reference_idany

An optional reference id which will be stored against usage records if supplied

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.autograb.com.au/v2/sourcing/market_overlay/statistics/{vehicle_id}' \
  --header 'ApiKey: YOUR_API_KEY'

200

400

401

200

{
  "success": true,
  "sample_size": 1,
  "days_checked": 1,
  "avg_days_to_sell": 1,
  "outlier_count": 1,
  "days_supply": 1,
  "avg_price": 1,
  "min_price": 1,
  "max_price": 1,
  "avg_odometer": 1,
  "min_odometer": 1,
  "max_odometer": 1
}

Success

As this endpoint is part of the market overlay route you can enhance your payload with additional features. Refer to the features on the market overlay to see what's available.