carvana.com APIcarvana.com ↗
Search Carvana's used car inventory by make, model, price, and fuel type. Get full vehicle specs, images, features, and availability via 4 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/97f12767-f701-40a6-a3fe-02be60896863/search_vehicles?make=Ford&page=1&zip5=90210&query=Tesla&page_size=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for vehicles on Carvana with various filters and sorting options. Returns paginated results including vehicle details, pricing, and delivery information.
| Param | Type | Description |
|---|---|---|
| make | string | Vehicle make (e.g., Tesla, Ford, Toyota). |
| page | integer | Page number for pagination. |
| zip5 | string | 5-digit US ZIP code for local results and shipping calculation. |
| model | string | Vehicle model (requires make to be set). |
| query | string | General search query keyword. |
| sort_by | string | Sort order. Accepted values: MostPopular, LowestPrice, HighestPrice, LowestMileage, NewestInventory. |
| fuel_type | string | Fuel type filter (e.g., Electric, Hybrid, Gas). |
| max_price | integer | Maximum price in USD. |
| min_price | integer | Minimum price in USD. |
| page_size | integer | Number of results per page. |
{
"type": "object",
"fields": {
"inventory": "object containing pagination info and vehicles array",
"financeInfo": "object with financing details",
"searchRequestId": "string UUID for the search request",
"userDeliveryInfo": "object with delivery/pickup location details"
},
"sample": {
"data": {
"inventory": {
"vehicles": [
{
"vin": "1FADP3F26JL295716",
"make": "Ford",
"trim": "SE",
"year": 2018,
"model": "Focus",
"price": {
"total": 14990
},
"mileage": 35016,
"fuelType": "Gas",
"vehicleId": 4213627,
"stockNumber": 2004546594
}
],
"pagination": {
"pageSize": 5,
"currentPage": 1,
"totalMatchedPages": 1450,
"totalMatchedInventory": 5795
}
},
"financeInfo": {
"financingType": "estimatedFinancing"
},
"searchRequestId": "57f751cf-fd05-4902-be46-6789b5d86762",
"userDeliveryInfo": {
"city": "Ashburn",
"zip5": "20149",
"state": "VA"
}
},
"status": "success"
}
}About the carvana.com API
The Carvana API provides 4 endpoints for querying Carvana's used car inventory, including the search_vehicles endpoint for broad filtered searches and get_vehicle_detail for comprehensive per-vehicle data. Responses include pricing, mileage, fuel type, trim, exterior and interior color, warranty details, feature categories, and purchase availability — all returned as structured JSON ready to integrate into car-shopping tools, price trackers, or EV research applications.
Search and Filter Inventory
The search_vehicles endpoint accepts filters for make, model, fuel_type, max_price, and zip5, plus a sort_by parameter with options including LowestPrice, HighestMileage, and NewestInventory. Results come back paginated inside an inventory object that contains a vehicles array alongside pagination metadata. A userDeliveryInfo object reflects shipping or pickup options based on the provided ZIP code. The searchRequestId UUID can be used to correlate results across calls.
Electric Vehicle Endpoints
Two endpoints target EV inventory specifically. search_electric_vehicles pre-applies the Electric fuel type filter and adds a min_price parameter not available on the general search, making it straightforward to define a price band when browsing EVs from a specific make like Tesla or Nissan. get_cheapest_electric_vehicles returns the same response shape sorted by lowest price and accepts only a zip5 for localization — useful when you need a quick snapshot of the most affordable electric options in a given area without building a full filter query.
Vehicle Detail Data
The get_vehicle_detail endpoint takes a vehicle_id (the numeric string returned in search results) and returns an expanded payload. The summary object contains the vin, year, make, model, trim, mileage, price, fuelType, exteriorColor, and interiorColor. The vehicle object adds dimensions, warranty info, and embedded image data. Feature categories are available either in the features array or within vehicle.cvnaCategories, and the availability object indicates current purchase status for that listing.
Coverage Notes
All endpoints operate against Carvana's U.S. used-car inventory. The zip5 parameter on search_vehicles and get_cheapest_electric_vehicles influences delivery cost estimates and local availability, but it does not filter to a geographic radius — Carvana's nationwide inventory is always searched. financeInfo objects are present in all search responses but reflect general financing context rather than personalized loan quotes.
- Build a price-drop alert tool that polls search_vehicles with a max_price threshold for a specific make and model.
- Aggregate EV inventory across price bands using search_electric_vehicles with min_price and max_price to populate a comparison table.
- Populate a vehicle detail page with full specs, color options, and availability status using get_vehicle_detail.
- Generate a 'cheapest EVs near me' feature by passing a user's ZIP code to get_cheapest_electric_vehicles.
- Track mileage and price trends across Carvana listings by periodically querying search_vehicles sorted by LowestMileage.
- Cross-reference VINs from get_vehicle_detail against third-party history reports in an automated car-buying workflow.
- Filter Carvana's hybrid and electric inventory by make to feed a fleet-procurement research dashboard.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Carvana have an official public developer API?+
What does get_vehicle_detail return beyond what search results include?+
vehicle object with dimensions, warranty information, and embedded image data, a features array or vehicle.cvnaCategories for feature categories, a summary object with VIN and color fields, and an availability object indicating whether the vehicle can currently be purchased. Search result entries do not include most of these fields.Does pagination work the same across all search endpoints?+
search_vehicles endpoint accepts an explicit page integer parameter for pagination. The search_electric_vehicles and get_cheapest_electric_vehicles endpoints do not expose a page parameter in their current inputs, so they return the first page of results only. You can fork this API on Parse and revise those endpoints to add pagination support.Can I filter by body style, transmission type, or number of cylinders?+
make, model, fuel_type, max_price, min_price, and zip5. Body style, transmission, drivetrain, and engine specifications are not available as filter parameters. You can fork this API on Parse and revise it to add those filter inputs.