Overview

The Listings API allows you to retrieve a collection of vehicles currently available for sale. Listings provide insights into the automotive market, including pricing trends and vehicle availability.

Use listings to analyze market trends, compare prices, and make informed purchasing decisions.

CapabilitiesDescription
Current ListingsRetrieve a collection of vehicles currently available for sale.
Listing DetailsView detailed information about a specific vehicle listing.
Historical ListingsRetrieve a collection of vehicles that were previously available for sale.

Current Listings

View a collection of vehicles currently available for sale. Use listings to analyze market trends, compare vehicle prices, and make informed purchasing decisions.

{
  "data": [
    {
      "vin": "1GYKPFRS4RZ701252",
      "url": "http://listings.vin/1GYKPFRS4RZ701252",
      "vehicle": {
        "vin": "1GYKPFRS4RZ701252",
        "squishVin": "1GYKPFRSRZ",
        "year": 2024,
        "make": "Cadillac",
        "model": "XT6",
        "trim": "Premium Luxury",
        "series": "Premium Luxury 4dr SUV AWD (3.6L 6cyl 9A)",
        "bodyStyle": "SUV",
        "type": ["Crossover", "Luxury", "Performance/Sports", "SUV"],
        "style": "4dr SUV",
        "drivetrain": "4WD",
        "engine": "3.6L 6Cyl gasoline",
        "cylinders": 6,
        "fuel": "Regular Unleaded",
        "transmission": "Automatic",
        "confidence": 0.995,
        "interiorColor": "Black",
        "exteriorColor": "White",
        "baseMsrp": 56995,
        "baseInvoice": 54145,
        "doors": 4,
        "seats": 7
      },
      "retailListing": {
        "vdp": "/cadillac-xt6#vin=1GYKPFRS4RZ701252",
        "price": 58911,
        "miles": 7494,
        "used": true,
        "cpo": false,
        "carfaxUrl": "https://www.carfax.com/VehicleHistory/p/Report.cfx?vin=1GYKPFRS4RZ701252&partner=FRD_2",
        "dealer": "Ken Batchelor Cadillac",
        "city": "San Antonio",
        "state": "TX",
        "primaryImage": "https://retail.photos.vin/1GYKPFRS4RZ701252-1.jpg",
        "photoCount": 30,
        "margin": null
      },
      "score": 3
    },
    {
      "vin": "2C4RC1DG4MR502789",
      "url": "http://listings.vin/2C4RC1DG4MR502789",
      "vehicle": {
        "vin": "2C4RC1DG4MR502789",
        "squishVin": "2C4RC1DGMR",
        "year": 2021,
        "make": "Chrysler",
        "model": "Voyager",
        "trim": "LXi Fleet",
        "series": "LXi Fleet 4dr Minivan (3.6L 6cyl 9A)",
        "bodyStyle": "Minivan",
        "type": ["Minivan"],
        "style": "Passenger Minivan",
        "drivetrain": "FWD",
        "engine": "3.6L 6Cyl Gasoline",
        "cylinders": 6,
        "fuel": "Regular Unleaded",
        "transmission": "Automatic",
        "confidence": 0.995,
        "interiorColor": "Black",
        "exteriorColor": "Silver",
        "baseMsrp": 33245,
        "baseInvoice": 32114,
        "doors": 4,
        "seats": 7
      },
      "retailListing": {
        "vdp": "/chrysler-voyager#vin=2C4RC1DG4MR502789",
        "price": 21017,
        "miles": 80559,
        "used": true,
        "cpo": false,
        "carfaxUrl": "https://www.carfax.com/VehicleHistory/p/Report.cfx?vin=2C4RC1DG4MR502789&partner=FRD_2",
        "dealer": "Campbell Chevrolet",
        "city": "Bowling Green",
        "state": "KY",
        "primaryImage": "https://retail.photos.vin/2C4RC1DG4MR502789-1.jpg",
        "photoCount": 27
      },
      "wholesaleListing": {
        "vdp": "https://members.manheim.com/members/results#/details/2C4RC1DG4MR502789",
        "conditionReport": "http://content.liquidmotors.com/IR/9785/30433238.html",
        "buyNowPrice": 20800,
        "miles": 80559,
        "mmr": 16750,
        "seller": "Campbell Chev Of Bowl Green Ky Inc",
        "auction": "America's Auto Auction Bowling Green",
        "pickupLocation": "Campbell Chev Of Bowl Green Ky Inc",
        "pickupZip": "42104",
        "city": "Bowling Green",
        "state": "KY",
        "latitude": 36.8735,
        "longitude": -86.4544,
        "announcements": [
          "* Green Light *",
          "Please call Mike Mammoser at 812-453-5821 for questions on this unit."
        ],
        "primaryImage": "https://wholesale.photos.vin/2C4RC1DG4MR502789-1.jpg"
      },
      "autocheck": {
        "odometerCheckOk": true,
        "vehicleUseAndEventCheckOk": false,
        "titleAndProblemCheckOk": true,
        "numberOfAccidents": 0,
        "ownerCount": 2,
        "score": 87,
        "compareScoreRangeLow": 90,
        "compareScoreRangeHigh": 95
      },
      "score": 3
    }
    ...
  ]
}

Listing Details

View detailed information about a specific vehicle listing. Listing details provide valuable insights into the vehicle’s specifications, pricing, and more.

{
  "vehicle": {
    "vin": "1FTEW1EP6KKD71896",
    "year": 2019,
    "make": "Ford",
    "model": "F-150",
    "trim": "XLT 4WD SuperCrew 5.5' Box",
    "series": "XLT",
    "style": "4D Truck",
    "drivetrain": "4x4",
    "engine": "5L V-8 port/direct injection, DOHC, variable valve control, regular unleaded, engine with 395HP",
    "transmission": "10-speed automatic",
    "confidence": 0.995,
    "interiorColor": {
      "Medium Earth Gray": "#808080"
    },
    "exteriorColor": {
      "Oxford White": "#E7E7E5"
    },
    "options": {
      "102300-BCA1802302A": "Equipment Group 302A Luxury",
      "61CLCD": "4.2\" Productivity Screen in Instrument Cluster",
      "PWRDRV": "8-Way Power Driver Seat",
      "STDRD": "AM/FM Stereo with 6 Speakers",
      "SYNC3": "SYNC 3",
      "M": "Cloth 40/20/40 Front Seat",
      "BAKLGT": "Fixed Backlight with Privacy Glass",
      "HFRONT": "Heated Front Seats",
      "LTHWHL": "Leather-Wrapped Steering Wheel",
      "54R": "Power Glass Heated Sideview Mirrors",
      "MIRROR": "Auto-Dimming Rearview Mirror",
      "PWRPDL": "Power-Adjustable Pedals",
      "RSEAT": "Rear Under-Seat Storage",
      "57Q": "Rear Window Defroster",
      "99P": "2.7L V6 EcoBoost Engine",
      "X19": "3.55 Axle Ratio",
      "NONGV1": "6,600 lbs Payload Package GVWR",
      "50N": "Voice-Activated Touchscreen Navigation"
    },
    "baseInvoice": 36486,
    "optionsMsrp": 1290,
    "fuel": "Regular Unleaded",
    "doors": 4,
    "seats": 6
  },
  "retailListing": {
    "used": true,
    "cpo": false,
    "price": 27995,
    "miles": 104618,
    "carfax": "https://www.carfax.com/VehicleHistory/p/Report.cfx?vin=1FTEW1EP6KKD71896&partner=FRD_2",
    "photos": []
  },
  "specs": {
    "Power Feature": {
      "hands-free entry": true,
      "2 one-touch power windows": true,
      "Heated mirrors": true
    },
    "Mechanical Options": {
      "E-Locking 3.31 Axle": true,
      "E-Locking 3.73 Axle": true,
      "Extended Range 36 Gallon Fuel Tank": true,
      "E-Locking 3.55 Axle": true,
      "3.5L Ecoboost V6": true,
      "5.0L V8 w/Flex-Fuel Capability & Start-Stop System": true,
      "Engine Block Heater": true,
      "3.0L Power Stroke Turbo Diesel V6": true
    },
    "Rearseats": {
      "Rear hip room": "64.7 in.",
      "Rear head room": "40.3 in.",
      "Rear leg room": "43.6 in.",
      "Rear shoulder room": "65.9 in.",
      "Split-folding rear seatback": true,
      "folding center armrest": true
    },
    "Warranty": {
      "Basic": "3 yr./ 36000 mi.",
      "Drivetrain": "5 yr./ 60000 mi.",
      "Rust": "5 yr./ unlimited mi.",
      "Roadside": "5 yr./ 60000 mi."
    },
    "Measurements": {
      "Wheelbase": "145.0 in.",
      "Curb weight": "4858 lbs.",
      "Gross weight": "6600 lbs.",
      "Angle of approach": "25.5 degrees",
      "Maximum payload": "1690 lbs.",
      "Overall width with mirrors": "96.8 in.",
      "Length": "231.9 in.",
      "Angle of departure": "26.0 degrees",
      "Maximum towing capacity": "12700 lbs.",
      "Ground clearance": "9.4 in.",
      "Height": "77.2 in.",
      "Overall width without mirrors": "79.9 in.",
      "Bed length": "67.1 in."
    },
    "Comfort & Convenience": {
      "Audio and cruise controls on steering wheel": true,
      "front seatback storage": true,
      "cruise control": true,
      "leather steering wheel": true,
      "keyless ignition": true,
      "turn signal in mirrors": true,
      "Dual illuminating vanity mirrors": true,
      "front and rear cupholders": true,
      "electrochromatic inside rearview mirror": true,
      "front and rear door pockets": true,
      "tilt and telescopic steering wheel": true,
      "electric power steering": true,
      "rear view camera": true,
      "Dual zone front climate control": true,
      "adjustable pedals": true
    },
    "Exterior Options": {
      "Hard Tonneau Pickup Box Cover": true,
      "Twin Panel Moonroof": true,
      "Foldable Pickup Box Bed Extender": true,
      "Front License Plate Bracket": true,
      "Aluminum Crossbed Toolbox by Weather Guard": true,
      "Two-Tone Paint": true,
      "Chrome Angular Running Boards": true,
      "Plastic Drop-In Bedliner": true,
      "20\" Six-Spoke Premium Painted Aluminum Wheels": true,
      "LED Side-Mirror Spotlights": true,
      "Tailgate Step w/Tailgate Lift Assist": true,
      "Power Deployable Running Boards": true,
      "Bed Divider": true,
      "Soft Folding Tonneau Pickup Box Cover": true,
      "Spray-In Bedliner": true,
      "Wheel Well Liner": true,
      "Bed Ramps": true,
      "LT275/65R18C Outline White Lettering All-Terrain Tires": true,
      "20\" Chrome-Like PVD Wheels": true,
      "Box Side Steps": true,
      "PowerScope Telescoping, Power-Folding Trailer Tow Mirrors": true
    },
    "Drive Train": {
      "Drive type": "four wheel drive",
      "automatic locking hubs": true,
      "Transmission": "10-speed shiftable automatic",
      "part time 4WD": true,
      "electronic hi-lo gear selection": true
    },
    "Suspension": {
      "Stabilizer bar stabilizer bar": true,
      "front independent suspension": true
    },
    "Instrumentation": {
      "clock": true,
      "compass": true,
      "external temperature display": true,
      "trip computer": true,
      "tachometer": true
    },
    "In Car Entertainment": {
      "AM/FM  stereo": true,
      "memory card slot": true,
      "satellite radio satellite radio": true,
      "USB with external media control": true,
      "6 months of provided satellite radio service": true,
      "USB connection": true,
      "7 total speakers": true
    },
    "Frontseats": {
      "8-way power passenger seat": true,
      "height adjustable passenger seat": true,
      "multi-level heating driver seat": true,
      "Front leg room": "43.9 in.",
      "ventilated driver seat": true,
      "ventilated passenger seat": true,
      "leather": true,
      "Front head room": "40.8 in.",
      "height adjustable driver seat": true,
      "multi-level heating passenger seat": true,
      "Front shoulder room": "66.7 in.",
      "Driver seat with power adjustable lumbar support": true,
      "40-20-40 split bench front seats": true,
      "8-way power driver seat": true,
      "Passenger seat with power adjustable lumbar support": true,
      "Front hip room": "62.5 in."
    },
    "Safety & Security Options": {
      "Reverse Sensing System": true,
      "Inflatable Rear Safety Belts": true,
      "Adaptive Cruise Control w/Stop-and-Go, Pre-Collision Assist and Pedestrian Detection": true
    },
    "Packages": {
      "CNG/Propane Gaseous Engine Prep Pack": true,
      "Equipment Group 501A": true,
      "Snow Plow Prep": true,
      "Equipment Group 500A": true,
      "Smokers Pack": true,
      "Lariat Sport Package": true,
      "Equipment Group 502A": true,
      "Lariat Chrome Appearance Package": true,
      "FX4 Off-Road Package": true,
      "Lariat Special Edition Package": true,
      "Max Trailer Tow Package": true,
      "Lariat Special Edition Package - Graphic Delete": true,
      "Trailer Tow Package": true,
      "Technology Package": true
    },
    "Fuel": {
      "EPA combined MPG": "21 MPG",
      "EPA city/highway MPG": "19/24 MPG",
      "Range in miles (city/hwy)": "494.0/624.0 mi.",
      "Fuel tank capacity": "26.0 gal.",
      "Fuel type": "regular unleaded"
    },
    "Telematics": {
      "Destination Download": true,
      "Airbag Deployment Notification": true,
      "Destination guidance (also Turn-by-Turn Navigation)": true,
      "Mobile Internet (Browser)": true
    },
    "Safety": {
      "Rear door child safety locks": true,
      "Turn signal mirrors": true,
      "daytime running lights": true,
      "engine immobilizer": true,
      "dual front side-mounted airbags": true,
      "Passenger airbag occupant sensing deactivation": true,
      "stability control": true,
      "Rear height adjustable headrests": true,
      "remote anti-theft alarm system": true,
      "3 rear headrests": true,
      "auto delay off headlamps": true,
      "tire pressure monitoring": true,
      "traction control": true,
      "pre-collision safety system": true,
      "4-wheel ABS": true,
      "emergency braking preparation": true,
      "front fog/driving lights": true,
      "Rear center 3-point belt": true,
      "post-collision safety system": true,
      "child seat anchors": true,
      "3 front headrests": true,
      "front and rear head airbags": true,
      "Emergency braking assist": true,
      "Front and rear ventilated disc brakes": true,
      "dusk sensing headlamps": true,
      "Front center 3-point belt": true
    },
    "Tires and Wheels": {
      "275/65R18 tires": true,
      "All season tires": true,
      "fullsize non-matching spare tire": true,
      "18 in. wheels": true,
      "underbody mounted spare tire": true,
      "painted alloy wheels": true
    },
    "Engine": {
      "Torque": "400 lb-ft @ 2750 rpm",
      "Base engine size": "2.7 L",
      "Horsepower": "325 hp @ 5000 rpm",
      "Valves": "24",
      "Base engine type": "gas",
      "direct injection": true,
      "Valve timing": "Variable",
      "Cylinders": "V6",
      "Cam type": "Double overhead cam (DOHC)"
    },
    "Interior Options": {
      "Trailer Brake Controller": true,
      "Voice-Activated Navigation System": true,
      "Leather Trimmed Bucket Seats w/Flow-Through Console and Floor Shifter": true,
      "110V/400W Outlet": true,
      "Full Coverage Rubber Floor Mats": true
    }
  }
}

Historical Listings

Retrieves a collection of vehicles that were previously available for sale. Historical listings provide valuable insights into the automotive market, including pricing trends, vehicle availability, and more. Use historical listings to analyze market trends, compare vehicle prices, and make informed purchasing decisions.

More coming soon

Next Steps

Review the API reference for the Listings APIs