v1

latestOpenAPI 3.0.02026-07-147195292.0 KB

Car Search

Listing by id

Get a particular auction listing by its id

get/listing/car/auction/{id}

Path parameters

idstring string required

Listing id to get all the listing attributes

Query parameters

api_keystring

The API Authentication Key. Mandatory with all API calls.

append_api_keyboolean

Flag on whether to include api_key in response API urls (if any)

include_relevant_linksboolean

To include_relevant_links. Default is true

Response

Listing for the given id

base_ext_colorstring

Base exterior color of the car

base_int_colorstring

Base interior color of the car

carfax_1_ownerboolean

Flag to indicate whether listing is carfax_1_owner

carfax_clean_titleboolean

Flag to indicate whether listing is carfax_clean_title

data_sourcestring

Data source of the listing

dominteger

Days on Market value for the car based on current and historical listings found in the Marketcheck database for this car

dom_180integer

Days on Market value for the car based on current and last 6 month listings found in the Marketcheck database for this car

dom_activeinteger

Days on Market value for the car based on current and last 30 days listings found in the Marketcheck database for this car

exterior_colorstring

Exterior color of the car

first_seen_atinteger

Listing first seen at first scraped timestamp

first_seen_at_datestring

Listing first seen at first scraped date

first_seen_at_mcinteger

Listing first seen at first scraped at MC timestamp

first_seen_at_mc_datestring

Listing first seen at first scraped at MC date

first_seen_at_sourceinteger

Listing first seen at source relisted timestamp

first_seen_at_source_datestring

Listing first seen at source relisted date

headingstring

Listing title as displayed on the source website

idstring

Unique identifier representing a specific listing from the Marketcheck database

interior_colorstring

Interior color of the car

inventory_typestring

Inventory type of car

is_certifiedinteger

Certified car

last_seen_atinteger

Listing last seen at (most recent) timestamp

last_seen_at_datestring

Listing last seen at (most recent) date

milesinteger

Odometer reading / reported miles usage for the car

msrpinteger

MSRP for the car

priceinteger

Asking price for the car

price_change_percentnumber double

Percentage difference between the cars's current price and ref_price i.e. last reported price

rankinteger

Relative rank of the listing determined by ranking service

ref_milesstring

Last Odometer reading / reported miles usage for the car. If the asking miles value is not or is available then the last_miles could perhaps be used. last_miles is the miles for the car listed on the source website as of last_miles_dt date

ref_miles_dtinteger

The date at which the last miles was reported online. This is earlier to last_seen_date

ref_pricestring

Last reported price for the car. If the asking price value is not or is available then the last_price could perhaps be used. last_price is the price for the car listed on the source website as of last_price_dt date

ref_price_dtinteger

The date at which the last price was reported online. This is earlier to last_seen_date

scorenumber double

Score of the ranked listing as per the ranking criteria determined by ranking service

scraped_atinteger

Listing last seen at date timestamp

scraped_at_datestring

Listing last seen at date

seller_typestring

Seller type for the car

sourcestring

Source domain of the listing

stock_nostring

Stock number of car in dealers inventory

vdp_urlstring

Vehicle Details Page url of the specific car

vehicle_registration_markstring

Vehicle Registration Mark of the car

vinstring

VIN for the car