Api documentation

Api documentation

Inventory API

Inventory API
 
 

Page Content


Overview

The Inventory API provides access to the vehicle inventories (or cars for sale) available at dealerships with a relationship with Edmunds.com. Due to the nature of this data, it’s only available to API Partners and Edmunds Developers. If you’re interested in becoming an API Partner, please contact us.

If you haven’t yet, this might be a good time to read the API Overview page to familiarize yourself with some of the core concepts required to using the API.

Back to top

Quick Start

Let’s get right to it, shall we? Here’s a few REST calls that should get you started using the API with ease.

Example 2: Get available NEW cars for sale at a specific dealership

https://api.edmunds.com/api/inventory/v1/getall?types=NEW&dealerId=26711

Back to top

The inventory detail page on Edmunds.com has the following URL structure:

http://www.edmunds.com/inventory/vin.html?make={vehicle make}&inventoryId={vehicle inventory ID}&zip={vehicle zip code}&radius={the radius to search}

The information you need to compile this URL is available in the API response of all endpoints in this resource. This piece of information is important when you want to send traffic back to Edmunds.com so your users can transact on that inventory.

Back to top

API Uses

  • Get all inventories within a certain zip code and radius
  • Get inventories by franchise id
  • Get inventories by style id

Back to top

Available Resources

The Inventory API has two resources:

Resource Name Description
Inventory by VIN If the VIN you supply matches a vehicle that’s for sale at one of the dealerships Edmunds.com, Inc. works with, you will get a response back. Otherwise, you will get an error.
Inventory by Dealer ID or ZIP Code Get a list of inventories.

Back to top