Overview
The Listings Search API sources vehicle listings from dealerships, auctions, and private sellers, offering detailed information from millions of listings. Including year, make, model, price, mileage, and more.| Capabilities | Description |
|---|---|
| Get Listings | Retrieve detailed information about vehicles from the Listings API. |
| Pagination | Navigate through large result sets using pagination. |
| Search Listings | Filter listings by make, model, year, price, and more. |
| Sort Listings | Sort search results by price, mileage, and year. |
| Facets | Categorize search results based on specific attributes. |
| Photos | Access high-quality images for specific vehicles. |
Get Listings
The base URL for the Listings API islistings.vin. You can access the API by making HTTP requests to this URL.
Get Listings
Get Listings
Pagination
Pagination is supported for large result sets. Use thepage parameter to navigate through the results. For example, page=2 will return the second page of results.
Limit the number of results per page using the limit parameter. For example, limit=10 will return 10 results per page.
Search Listings
Simply make a GET request tolistings.vin with your desired search parameters. You can filter by make, model, year, price, mileage, and more.
GET https://listings.vin/?vehicle.make=ford&vehicle.model=mustang
Search Listings Parameters
Learn more about search parameters
Sort Listings
You can sort the search results by mileage, price, and year to find the best deals quickly. Simply add thesort parameter to your request.
For example, to sort by price in ascending order:
GEThttps://listings.vin/?vehicle.make=ford&vehicle.model=mustang&sort=price.asc
Sort Listings
Learn more about sorting options
Facets
Facets are powerful filters that categorize search results based on specific attributes, enabling users to quickly identify and access relevant data points within a large dataset.How Facets Work
When a user performs a search, the API not only retrieves relevant listings but also provides a summary of attributes related to those listings in the form of facets. Each facet category will display the count of listings corresponding to each attribute, allowing users to gauge the prevalence of specific characteristics within the search results.Available Facets
Available Facets
| Facet Category | Description | Example Facets |
|---|---|---|
Years | Filter listings by year of manufacture | 2024 (873515) |
Makes | Group listings by vehicle make | Chevrolet (240343) |
Models | Categorize listings by vehicle model | Silverado 1500 (72285) |
Trims | Break down by specific trims | Limited (98611) |
Series | Differentiate listings by vehicle series | Limited 4dr SUV 4WD (3.6L 6cyl 8A) (15920) |
Types | Differentiate listings by vehicle type | SUV (1001980) |
Engine | Facet by engine type | 2.0L 4Cyl gasoline (337112) |
Cylinders | Filter by the number of cylinders | 4 (1107200) |
Transmissions | Distinguish listings by transmission type | Automatic (1889687) |
Drivetrain | Filter by drivetrain | AWD (674110) |
Int Color | Organize listings by Interior Color options | Black (1311956) |
Ext Color | Sort listings by Exterior Colors options | White (556523) |
Doors | Filter by the number of doors | 2-Door (237901) |
Fuel | Classify listings by type of fuel used | Regular Unleaded (1295264) |
States | View listings based on the state where the vehicle is located | FL (10348) |
Prices | Facet by price ranges | $20000-$24000 (219594) |
Mileage | Categorize by mileage | 0-7000 (1280236) |
Accidents | Indicate the number of accidents reported | 0 (49999) |
Using Facets
The facets for listings are encapsulated within a dedicated object at the root of eachlistings.vin request, and are named after
the corresponding field. Each facet is represented as an object, with the field values serving as keys and the count of matching results as values.
For example, the following JSON response includes facets for makes, models, and years:
Example Facets
Example Facets
Photos
We provide access to retail and wholesale photos for every listing in ourphotos.vin CDN.
Retail and Wholesale Photos
- Retail photos are publicly available online and typically sourced from dealerships. These photos are generally of higher quality and verified for accuracy.
- Wholesale photos are sourced from auctions and accessing these photos requires provider credentials. These photos may not always be accurate or up to date.
Learn more about our Photos API.
Next Steps
Review the API reference for the Listings Search APIReference – Listings Search
Explore the Listings Search API endpoint and parameters.