Car Listing Details

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

interface Response {
  id: string; // Unique listing identifier
  vehicle_registration_mark: string; // Vehicle Registration Mark
  uvc_id: string; // Unique Vehicle Code
  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
  ref_miles: number; // Reference mileage (previously listed mileage at same source)
  ref_miles_dt: number; // Reference mileage date timestamp (Unix Seconds)
  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
  vehicle_registration_date: string; // Vehicle registration date (ISO format)
  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
  county: string; // County name
  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
  description_boilerplate: string; // Standardized description text
}

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
  county: string; // County name
  country: string; // Country code
  zip: string; // Postal/ZIP code
  latitude: string; // Geographic latitude
  longitude: string; // Geographic longitude
  phone: string; // Contact phone number
  seller_email: string; // Contact email address
  postal_code: string; // Postal code
}

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
  county: string; // County name
  country: string; // Country code
  latitude: string; // Geographic latitude
  longitude: string; // Geographic longitude
  zip: string; // Postal/ZIP code
  phone: string; // Contact phone number
  seller_email: string; // Contact email address
  postal_code: string; // Postal code
}

interface Build {
  year: number; // Model year
  make: string; // Vehicle manufacturer
  model: string; // Vehicle model
  trim: string; // Trim level
  variant: string; // Specific variant
  model_variant: string; // Vehicle model variant
  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
  combined_mpg: number; // Combined fuel economy
  powertrain_type: string; // Powertrain classification
  performance_torque_ftlb: number; // Engine torque in foot-pounds
  performance_maxspeed_mph: number; // Maximum speed in miles per hour
  performance_torque_rpm: number; // RPM at peak torque
  performance_power_bhp: number; // Engine power in brake horsepower
  performance_power_rpm: number; // RPM at peak power
  performance_torque_nm: number; // Engine torque in Newton-meters
  performance_power_kw: number; // Engine power in kilowatts
  performance_acceleration_zero_to_60_mph: number; // 0-60 mph acceleration time in seconds
  performance_acceleration_mph: number; // Acceleration time in seconds
  performance_co2: number; // CO2 emissions in g/km
  euro_status: number; // Euro emissions standard (e.g., 6)
}