Marketcheck APIs
  1. Car Search
Marketcheck APIs
  • Car Search
    • Get dealers active inventory
      GET
    • Listing by id
      GET
    • Long text Listings attributes for Listing with the given id
      GET
    • Listing media by id
      GET
    • Listing by id
      GET
    • Long text Listings attributes for Listing with the given id
      GET
    • Listing media by id
      GET
    • Listing by id
      GET
    • Long text Listings attributes for Listing with the given id
      GET
    • Listing media by id
      GET
    • Listing by id
      GET
    • Long text Listings attributes for Listing with the given id
      GET
    • Listing media by id
      GET
    • Gets active car listings for the given search criteria
      GET
    • Gets active auction car listings for the given search criteria
      GET
    • API for auto-completion of inputs
      GET
    • Gets active private party car listings for the given search criteria
      GET
    • Gets Recent car listings for the given search criteria
      GET
    • Gets active car listings in UK for the given search criteria
      GET
    • Gets Recent UK car listings for the given search criteria
      GET
  • Recall Search
    • Recall info by vin
      GET
  • CRM Cleanse API
    • CRM check of a particular vin
      GET
  • Dealer API
    • Dealer by id
      GET
    • Dealer by id
      GET
    • Dealer by id
      GET
    • Dealer by id
      GET
    • Dealer by id
      GET
    • Find car dealers around
      GET
    • Find car dealers around
      GET
    • Find car dealers around
      GET
    • Find car dealers around
      GET
    • Find car dealers around
      GET
  • VIN Decoder API
    • EPI VIN Decoder
    • NeoVIN Decoder
    • VIN Decoder
    • API for auto-completion of inputs based on taxonomy
    • API for getting terms from taxonomy
  • Cars History API
    • Get a cars online listing history
    • Get a cars online listing history
  • Car Cached Image
    • Fetch cached image
  • Heavy Equipment Search
    • Heavy equipment listing by id
    • Long text Heavy equipment Listings attributes for Listing with the given id
    • Listing media by id
    • Gets active heavy equipment listings for the given search criteria
    • API for auto-completion of inputs
  • Motorcycle Search
    • Motorcycle listing by id
    • Long text Motorcycle Listings attributes for Listing with the given id
    • Motorcycle listing media by id
    • Gets active motorcycle listings for the given search criteria
    • API for auto-completion of inputs
  • RV Search
    • RV listing by id
    • Long text RV Listings attributes for Listing with the given id
    • Listing media by id
    • RV listing by id
    • Long text RV Listings attributes for Listing with the given id
    • Listing media by id
    • Gets active RV listings for the given search criteria
    • API for auto-completion of inputs
    • Gets active RV listings for the given search criteria
  • Cars Market API
    • Market Days Supply
    • Get make model wise top 50 popular cars on national, state, city level
    • Predict car price based on it's specifications
    • Predict fare value of car for UK based on YMMT & miles
    • Predict car price for UK based on it's specifications
    • Get sales count by make, model, year, trim or taxonomy vin
    • Price, Miles and Days on Market stats
  • Rank Car Listings
    • Compute relative rank for car listings.
    • Compute relative rank for car listings.
  • OEM Incentive Search
    • Gets oem incentive listings for the given search criteria
  • client filters
    • get client filters
    • set client filters
  1. Car Search

Listing by id

GET
/listing/car/{id}
Car Search
Get a particular dealer listing by its id
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://marketcheck-prod.apigee.net/v2/listing/car/'
Response Response Example
200 - Example 1
{
    "base_ext_color": "string",
    "base_int_color": "string",
    "build": {
        "antibrake_sys": "string",
        "body_subtype": "string",
        "body_type": "string",
        "city_miles": "string",
        "city_mpg": 0,
        "cylinders": 0,
        "doors": 0,
        "drivetrain": "string",
        "engine": "string",
        "engine_aspiration": "string",
        "engine_block": "string",
        "engine_measure": "string",
        "engine_size": 0,
        "fuel_type": "string",
        "highway_miles": "string",
        "highway_mpg": 0,
        "made_in": "string",
        "make": "string",
        "model": "string",
        "opt_seating": "string",
        "overall_height": "string",
        "overall_length": "string",
        "overall_width": "string",
        "powertrain_type": "string",
        "short_trim": "string",
        "std_seating": "string",
        "steering_type": "string",
        "tank_size": "string",
        "transmission": "string",
        "trim": "string",
        "trim_r": "string",
        "vehicle_type": "string",
        "year": 0
    },
    "carfax_1_owner": true,
    "carfax_clean_title": true,
    "data_source": "string",
    "dealer": {
        "city": "string",
        "country": "string",
        "county": "string",
        "dealer_type": "string",
        "dealership_group_name": "string",
        "id": 0,
        "latitude": "string",
        "longitude": "string",
        "msa_code": "string",
        "name": "string",
        "phone": "string",
        "seller_email": "string",
        "state": "string",
        "street": "string",
        "website": "string",
        "zip": "string"
    },
    "dom": 0,
    "dom_180": 0,
    "dom_active": 0,
    "exterior_color": "string",
    "extra": {
        "dealer_added_f": [
            "string"
        ],
        "electronics_f": [
            "string"
        ],
        "exterior_f": [
            "string"
        ],
        "features": [
            "string"
        ],
        "interior_f": [
            "string"
        ],
        "options": [
            "string"
        ],
        "safety_f": [
            "string"
        ],
        "seller_comments": "string",
        "standard_f": [
            "string"
        ],
        "technical_f": [
            "string"
        ]
    },
    "financing_options": [
        {
            "down_payment": 0,
            "down_payment_percentage": 0,
            "estimated_monthly_payment": 0,
            "loan_apr": 0,
            "loan_term": 0
        }
    ],
    "first_seen_at": 0,
    "first_seen_at_date": "string",
    "first_seen_at_mc": 0,
    "first_seen_at_mc_date": "string",
    "first_seen_at_source": 0,
    "first_seen_at_source_date": "string",
    "heading": "string",
    "id": "string",
    "interior_color": "string",
    "inventory_type": "string",
    "is_certified": 0,
    "last_seen_at": 0,
    "last_seen_at_date": "string",
    "leasing_options": [
        {
            "down_payment": 0,
            "estimated_monthly_payment": 0,
            "lease_term": 0
        }
    ],
    "media": {
        "photo_links": [
            "string"
        ],
        "photo_links_cached": [
            "string"
        ]
    },
    "miles": 0,
    "msrp": 0,
    "price": 0,
    "price_change_percent": 0,
    "rank": 0,
    "ref_miles": "string",
    "ref_miles_dt": 0,
    "ref_price": "string",
    "ref_price_dt": 0,
    "score": 0,
    "scraped_at": 0,
    "scraped_at_date": "string",
    "seller_type": "string",
    "source": "string",
    "stock_no": "string",
    "vdp_url": "string",
    "vehicle_registration_mark": "string",
    "vin": "string"
}

Request

Path Params
id
string 
required
Listing id to get all the listing attributes
Query Params
api_key
string 
optional
The API Authentication Key. Mandatory with all API calls.
append_api_key
string 
optional
Flag on whether to include api_key in response API urls (if any)
include_relevant_links
string 
optional
To include_relevant_links. Default is true

Responses

🟢200Listing for the given id
application/json
Body
Represents a full list of attributes available with Marketcheck for a car
base_ext_color
string 
optional
Base exterior color of the car
base_int_color
string 
optional
Base interior color of the car
build
object (Build) 
optional
Describes the Car specification
antibrake_sys
string 
optional
Antibrake system of the car
body_subtype
string 
optional
Body subtype of the car
body_type
string 
optional
Body type of the car
city_miles
string 
optional
City miles of the car
city_mpg
integer 
optional
City Mileage in MPG
cylinders
integer 
optional
No of cylinders of the car
doors
integer 
optional
No of doors of the car
drivetrain
string 
optional
Drivetrain of the car
engine
string 
optional
Engine of the car
engine_aspiration
string 
optional
Engine aspiration of the car
engine_block
string 
optional
Engine block of the car
engine_measure
string 
optional
Engine block of the car
engine_size
number <double>
optional
Engine size of the car
fuel_type
string 
optional
Fuel type of the car
highway_miles
string 
optional
Highway miles of the car
highway_mpg
integer 
optional
Highway Mileage in MPG
made_in
string 
optional
Made in of the car
make
string 
optional
Car Make
model
string 
optional
Car model
opt_seating
string 
optional
opt seating of the car
overall_height
string 
optional
Overall height of the car
overall_length
string 
optional
Overall length of the car
overall_width
string 
optional
Overall width of the car
powertrain_type
string 
optional
powertrain_type of the car
short_trim
string 
optional
Short trim of the car
std_seating
string 
optional
Std seating of the car
steering_type
string 
optional
Steering type of the car
tank_size
string 
optional
Tank size of the car
transmission
string 
optional
Transmission of the car
trim
string 
optional
Trim of the car
trim_r
string 
optional
Trim_r of the car
vehicle_type
string 
optional
Vehicle type of the car
year
integer 
optional
Year of the Car
carfax_1_owner
boolean 
optional
Flag to indicate whether listing is carfax_1_owner
carfax_clean_title
boolean 
optional
Flag to indicate whether listing is carfax_clean_title
data_source
string 
optional
Data source of the listing
dealer
object (NestDealer) 
optional
city
string 
optional
City of the dealer
country
string 
optional
country of the dealer
county
string 
optional
county of the dealer
dealer_type
string 
optional
Type of dealer (franchise/independent)
dealership_group_name
string 
optional
dealership_group_name of dealer
id
integer 
optional
The unique id associated with the dealer in the Marketcheck database
latitude
string 
optional
Latutide for the dealer location
longitude
string 
optional
Longitude for the dealer location
msa_code
string 
optional
msa_code of the dealer
name
string 
optional
Name of the dealer
phone
string 
optional
Contact no of the dealer
seller_email
string 
optional
Contact email of the dealer
state
string 
optional
State of the dealer
street
string 
optional
Street of the dealer
website
string 
optional
Website of the dealer
zip
string 
optional
Zip of the dealer
dom
integer 
optional
Days on Market value for the car based on current and historical listings found in the Marketcheck database for this car
dom_180
integer 
optional
Days on Market value for the car based on current and last 6 month listings found in the Marketcheck database for this car
dom_active
integer 
optional
Days on Market value for the car based on current and last 30 days listings found in the Marketcheck database for this car
exterior_color
string 
optional
Exterior color of the car
extra
object (ListingNestExtraAttributes) 
optional
dealer_added_f
array[string]
optional
List of dealer added features available with the car
electronics_f
array[string]
optional
List of electronic features available with the car
exterior_f
array[string]
optional
List of exterior features available with the car
features
array[string]
optional
List of Features available with the car
interior_f
array[string]
optional
List of interior features available with the car
options
array[string]
optional
Installed Options of the car
safety_f
array[string]
optional
List of safety features available with the car
seller_comments
string 
optional
Seller comments for the car
standard_f
array[string]
optional
List of standard features available with the car
technical_f
array[string]
optional
List of technical features available with the car
financing_options
array[object (ListingFinance) {5}] 
optional
Array of all finance offers for this listing
down_payment
number <double>
optional
Down payment for this finance offer
down_payment_percentage
number <double>
optional
down payment percentage for this finance offer
estimated_monthly_payment
number <double>
optional
estimated monthly payment for this finance offer
loan_apr
number <double>
optional
Loan APR for this finance offer
loan_term
integer 
optional
Loan term for this finance offer
first_seen_at
integer 
optional
Listing first seen at first scraped timestamp
first_seen_at_date
string 
optional
Listing first seen at first scraped date
first_seen_at_mc
integer 
optional
Listing first seen at first scraped at MC timestamp
first_seen_at_mc_date
string 
optional
Listing first seen at first scraped at MC date
first_seen_at_source
integer 
optional
Listing first seen at source relisted timestamp
first_seen_at_source_date
string 
optional
Listing first seen at source relisted date
heading
string 
optional
Listing title as displayed on the source website
id
string 
optional
Unique identifier representing a specific listing from the Marketcheck database
interior_color
string 
optional
Interior color of the car
inventory_type
string 
optional
Inventory type of car
is_certified
integer 
optional
Certified car
last_seen_at
integer 
optional
Listing last seen at (most recent) timestamp
last_seen_at_date
string 
optional
Listing last seen at (most recent) date
leasing_options
array[object (ListingLease) {3}] 
optional
Array of all finance offers for this listing
down_payment
number <double>
optional
Down payment for this lease offer
estimated_monthly_payment
number <double>
optional
estimated monthly payment for this lease offer
lease_term
integer 
optional
Lease term for this lease offer
media
object (ListingNestMedia) 
optional
photo_links
array[string]
optional
A list of photo urls for the car
photo_links_cached
array[string]
optional
A list of cached photo urls for the car
miles
integer 
optional
Odometer reading / reported miles usage for the car
msrp
integer 
optional
MSRP for the car
price
integer 
optional
Asking price for the car
price_change_percent
number <double>
optional
Percentage difference between the cars's current price and ref_price i.e. last reported price
rank
integer 
optional
Relative rank of the listing determined by ranking service
ref_miles
string 
optional
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_dt
integer 
optional
The date at which the last miles was reported online. This is earlier to last_seen_date
ref_price
string 
optional
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_dt
integer 
optional
The date at which the last price was reported online. This is earlier to last_seen_date
score
number <double>
optional
Score of the ranked listing as per the ranking criteria determined by ranking service
scraped_at
integer 
optional
Listing last seen at date timestamp
scraped_at_date
string 
optional
Listing last seen at date
seller_type
string 
optional
Seller type for the car
source
string 
optional
Source domain of the listing
stock_no
string 
optional
Stock number of car in dealers inventory
vdp_url
string 
optional
Vehicle Details Page url of the specific car
vehicle_registration_mark
string 
optional
Vehicle Registration Mark of the car
vin
string 
optional
VIN for the car
🔴500Error
Modified at 2023-08-15 07:36:55
Previous
Listing media by id
Next
Long text Listings attributes for Listing with the given id
Built with