Market Overlay

Get a view of the market as it relates to a specific vehicle.

The Sourcing API allows you to access lead and listing data from a variety of used car marketplaces.

This API requires authentication and an appropriate license attached to it.

Market Overlay API

When viewing a lead on the web app, a view of similar leads that are currently listed for sale or recently sold is available on the side of the page (the 'Market Overlay'). The Market Overlay API gives you programmatic access to this data, enabling you to show price justifications or re-create our market comparison view for your own purposes.

To access a Market Overlay, you will need to specify a Vehicle ID to search for relevant listings. To retrieve a Vehicle ID, use any of the Vehicle Search APIs.

When retrieving market data for a Vehicle ID, a best-effort attempt is made to find at least four listings. This search begins by looking at the latest 60 days, and if there is not enough data in this time period, another 10 days of data is added until the minimum quota of four is reached.

If you would like a larger sample of market data, you can specify a minimum_days value, and this will override the default minimum of 60 days.

Example

To perform an example request:

curl 'https://api.autograb.com.au/v2/sourcing/market_overlay/{VEHICLE_ID}?region=nz' \
      -H 'ApiKey: {API_KEY}'

An example payload is included below, although only the first lead is shown to save space:

{
  "success": true,
  "sample_size": 56,
  "days_checked": 60,
  "leads": [
    {
      "id": "nz_autotraderconz_442876",
      "vehicle_id": "4926722097020928",
      "year": 2012,
      "release_year": 2011,
      "release_month": 8,
      "listed_at": "2022-08-11T10:22:07.072Z",
      "removed_at": "2022-09-20T10:22:07.072Z",
      "seller_type": "dealer",
      "color": "Red",
      "state": "VIC",
      "tag_ids": [
        "writeoff",
        "damaged"
      ],
      "price": 15000,
      "kms": 30000,
      "listing_sources": [
        "carsales.com.au",
        "autotrader.com.au"
      ]
    }
  ]
}

Request Parameters

NameDescription

vehicle_id

The ID of the vehicle you are requesting a market overlay on.

minimum_days

The minimum number of days to show listings for

Default value : 60

include_adjacent_years

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.

Default value : false

--true / false

exclude_outliers

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

Default value : false

--true / false

exclude_all_delisted

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

Default value : false

--true / false

include_all_active

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.

Default value : false

--true / false

include_trash

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.

Default value : false

--true / false

features

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

See available features here.

odometer_range_min

The minimum range observed against similar vehicles

Example : 50000

odometer_range_max

The maximum range observed against similar vehicles

Example : 100000

region

uk

Last updated