Car Listing Details

GET https://api.marketcheck.com/v2/listing/car/{listing_id}

interface Response {
  id: string; // Unique listing identifier
  vin: string; // Vehicle Identification Number
  heading: string; // Formatted listing title
  price: number; // Current listing price
  price_change_percent: number; // Price change percentage from reference price
  msrp: number; // Manufacturer's Suggested Retail Price (as per dealer website)
  ref_price: number; // Previously listed price at same source for reference
  ref_price_dt: number; // Reference price date timestamp (Unix Seconds)
  miles: number; // Vehicle mileage
  carfax_1_owner: boolean; // Single owner history flag (If mentioned on dealer website)
  carfax_clean_title: boolean; // Clean title status (If mentioned on dealer website)
  exterior_color: string; // Exterior color description
  interior_color: string; // Interior color description
  base_int_color: string; // Standardized interior color
  base_ext_color: string; // Standardized exterior color
  dom: number; // Days on market (lifetime)
  dom_180: number; // Days on market in last 180 days
  dom_active: number; // Days on market while active
  dos_active: number; // Days on site while active
  data_source: string; // Original data source identifier. Mostly `mc` for MarketCheck
  source: string; // Data source website domain
  vdp_url: string; // Vehicle detail page URL
  seller_type: string; // Type of seller (dealer, fsbo, auction)
  inventory_type: string; // Inventory classification (new, used)
  stock_no: string; // Dealer stock number
  in_transit: boolean; // Vehicle in transit status
  last_seen_at: number; // Last seen timestamp (Unix Seconds), when the listing was last updated
  last_seen_at_date: string; // Last seen date (ISO format)
  scraped_at: number; // First seen timestamp (Unix Seconds), when the listing was first scraped
  scraped_at_date: string; // First seen date (ISO format)
  first_seen_at: number; // First seen timestamp (Unix Seconds), when the listing was first seen. Copy of `scraped_at` field
  first_seen_at_date: string; // First seen date (ISO format)
  first_seen_at_mc: number; // First seen at MarketCheck timestamp (Unix Seconds)
  first_seen_at_mc_date: string; // First seen at MarketCheck date (ISO format)
  first_seen_at_source: number; // First seen at source website timestamp (Unix Seconds)
  first_seen_at_source_date: string; // First seen at source website date (ISO format)
  car_location: CarLocation; // Vehicle/dealer location details
  media: Media; // Photos and media content links
  extra: Extra; // Additional features and options
  dealer: Dealer; // Dealer information
  mc_dealership: McDealership; // Enhanced dealer information from MarketCheck's new dealership system
  build: Build; // Vehicle specifications
}

interface CarLocation {
  seller_name: string; // Dealer or seller name
  street: string; // Street address
  city: string; // City name
  zip: string; // Postal/ZIP code
  state: string; // State or province
  latitude: string; // Geographic latitude
  longitude: string; // Geographic longitude
}

interface Media {
  photo_links: string[]; // Array of photo URLs from dealer website
  photo_links_cached: string[]; // Array of cached photo URLs from MarketCheck
}

interface Extra {
  options: string[]; // Vehicle options list
  features: string[]; // Vehicle features list
  seller_comments: string; // Dealer/seller description text
  high_value_features: string[]; // Premium/luxury features
  options_packages: string[]; // Factory option packages
}

interface Dealer {
  id: number; // Unique dealer identifier
  website: string; // Dealer website URL
  name: string; // Dealer business name
  dealer_type: string; // Dealer classification (franchise, independent)
  dealership_group_name: string; // Parent dealership group
  street: string; // Street address
  city: string; // City name
  state: string; // State or province
  country: string; // Country code
  zip: string; // Postal/ZIP code
  latitude: string; // Geographic latitude
  longitude: string; // Geographic longitude
  msa_code: string; // Metropolitan Statistical Area code
  phone: string; // Contact phone number
  seller_email: string; // Contact email address
}

interface McDealership {
  mc_website_id: number; // MarketCheck website identifier
  mc_dealer_id: number; // MarketCheck dealer identifier
  mc_location_id: number; // MarketCheck location identifier
  mc_rooftop_id: number; // MarketCheck rooftop identifier
  mc_dealership_group_id: number; // MarketCheck dealership group identifier
  mc_dealership_group_name: string; // MarketCheck dealership group name
  mc_sub_dealership_group_id: number; // MarketCheck sub-dealership group identifier
  mc_sub_dealership_group_name: string; // MarketCheck sub-dealership group name
  mc_category: string; // MarketCheck seller category (Dealer, FSBO, Auction, etc.)
  website: string; // Dealer website URL
  name: string; // Dealer business name
  dealer_type: string; // Dealer classification (franchise, independent)
  street: string; // Street address
  city: string; // City name
  state: string; // State or province
  country: string; // Country code
  latitude: string; // Geographic latitude
  longitude: string; // Geographic longitude
  zip: string; // Postal/ZIP code
  msa_code: string; // Metropolitan Statistical Area code
  phone: string; // Contact phone number
  seller_email: string; // Contact email address
}

interface Build {
  year: number; // Model year
  make: string; // Vehicle manufacturer
  model: string; // Vehicle model
  trim: string; // Trim level
  version: string; // Specific version/variant
  body_type: string; // Body style (sedan, SUV, truck, etc.)
  vehicle_type: string; // Vehicle category
  transmission: string; // Transmission type
  drivetrain: string; // Drivetrain configuration
  fuel_type: string; // Fuel type (gasoline, electric, hybrid, etc.)
  doors: number; // Number of doors
  made_in: string; // Manufacturing country
  overall_height: string; // Vehicle height
  overall_length: string; // Vehicle length
  overall_width: string; // Vehicle width
  std_seating: string; // Standard seating capacity
  highway_mpg: number; // Highway fuel economy
  city_mpg: number; // City fuel economy
  powertrain_type: string; // Powertrain classification
}