Carvana APIcarvana.com ↗
Access Carvana's used car inventory via API. Search by make, model, price, fuel type, and ZIP. Get full vehicle specs, images, features, and financing details.
What is the Carvana API?
The Carvana API provides 4 endpoints for querying Carvana's used car inventory, returning vehicle listings with pricing, financing, delivery, and full specifications. The search_vehicles endpoint supports filtering by make, model, fuel type, price range, and ZIP code, while get_vehicle_detail returns over a dozen fields per vehicle including trim, mileage, drivetrain, warranty, interior/exterior color, and categorized feature lists.
curl -X GET 'https://api.parse.bot/scraper/97f12767-f701-40a6-a3fe-02be60896863/search_vehicles?make=Ford&page=1&zip5=90210&model=Model+3&query=sedan&sort_by=MostPopular&fuel_type=Electric&max_price=50000&min_price=10000&page_size=24' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace carvana-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.carvana_vehicle_inventory_api import Carvana, Sort, VehicleDetail
carvana = Carvana()
# Search for Tesla vehicles under $40,000 sorted by lowest price
for vehicle in carvana.vehicles.search(make="Tesla", max_price=40000, sort_by=Sort.LOWEST_PRICE, limit=5):
print(vehicle.year, vehicle.make, vehicle.model, vehicle.trim)
print(vehicle.price.total, vehicle.mileage, vehicle.fuel_type)
# Get cheapest electric vehicles in Beverly Hills area
for ev in carvana.vehicles.cheapest_electric(zip5="90210", limit=3):
print(ev.year, ev.make, ev.model, ev.price.total, ev.mileage)
# Search specifically for electric vehicles by make
for ev in carvana.vehicles.search_electric(make="Nissan", sort_by=Sort.LOWEST_MILEAGE, limit=3):
print(ev.vehicle_id, ev.year, ev.make, ev.model, ev.price.total)
# Get detailed vehicle information
detail = carvana.vehicles.get(vehicle_id="4387009")
print(detail.vin, detail.year, detail.make, detail.model, detail.mileage)
print(detail.exterior_color, detail.drivetrain_description, detail.ev_range)
Search for vehicles on Carvana with various filters and sorting options. Returns paginated results including vehicle details, pricing, financing info, and delivery information. Filters can be combined: make, model, fuel type, price range. Pagination via page number; default page size is 24.
| 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 for results. |
| 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": {
"pageSize": "integer results per page",
"vehicles": "array of vehicle objects with vehicleId, make, model, trim, year, mileage, price, vin, fuelType, color",
"currentPage": "integer current page number",
"financeInfo": "object with financing details including financingType and maxMonthlyPayment",
"searchRequestId": "string UUID for the search request",
"userDeliveryInfo": "object with delivery/pickup location details including city, state, zip5",
"totalMatchedPages": "integer total number of pages",
"totalMatchedInventory": "integer total matching vehicles"
},
"sample": {
"data": {
"pageSize": 24,
"vehicles": [
{
"vin": "5YJXCDE24LF308138",
"make": "Tesla",
"trim": "Long Range Plus",
"year": 2020,
"color": "White",
"model": "Model X",
"price": {
"total": 37590,
"monthlyPayment": 648
},
"mileage": 62177,
"vdpSlug": "2020-tesla-model-x-long-range-plus",
"fuelType": "Electric",
"vehicleId": 4387009,
"stockNumber": 2004810388,
"interiorColor": "Black"
}
],
"currentPage": 1,
"financeInfo": {
"financingType": "estimatedFinancing",
"maxMonthlyPayment": 2000
},
"searchRequestId": "c063cd0e-d066-41b6-938e-97a7908cfccd",
"userDeliveryInfo": {
"city": "Ashburn",
"zip5": "20149",
"state": "VA",
"isPickupAllowed": true
},
"totalMatchedPages": 77,
"totalMatchedInventory": 1767
},
"status": "success"
}
}About the Carvana API
Search and Filter Inventory
The search_vehicles endpoint accepts up to eight parameters — make, model, fuel_type, max_price, zip5, query, sort_by, and page — and returns paginated results. Each page includes a vehicles array where each object carries vehicleId, make, model, trim, year, mileage, price, vin, fuelType, and color. The response also includes totalMatchedInventory, totalMatchedPages, and currentPage for pagination control, plus a userDeliveryInfo object with the resolved city, state, and ZIP used for shipping calculations.
Electric Vehicle Endpoints
Two endpoints focus specifically on electric vehicles. search_electric_vehicles pre-applies the Electric fuel type filter and additionally accepts a min_price parameter not available on the general search endpoint. get_cheapest_electric_vehicles accepts a zip5 and returns results sorted by lowest price, making it useful for budget-oriented EV queries without building a sort parameter yourself. Both return the same response shape as search_vehicles, including financeInfo with financingType and maxMonthlyPayment.
Vehicle Detail
The get_vehicle_detail endpoint takes a vehicle_id (the vehicleId string from any search result) and returns three top-level objects. The summary object covers core identification fields: id, vin, year, make, model, trim, mileage, price, fuelType, exteriorColor, and interiorColor. The vehicle object adds full specifications including dimensions, drivetrain, and warranty data. The images object includes spin data, hero shots, cutout images, feature photos, and imperfection photos. The features array groups equipment and options into named categories, each containing a cvnaFeatures array. The availability object exposes purchaseType and saleStatus, indicating whether the vehicle is currently available for purchase.
The Carvana API is a managed, monitored endpoint for carvana.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when carvana.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official carvana.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a used EV price tracker that monitors
totalMatchedInventoryandpricefields across makes like Tesla and Nissan - Create a ZIP-aware car search tool that uses
zip5anduserDeliveryInfoto show localized delivery estimates - Aggregate detailed vehicle specs from
get_vehicle_detailto populate a comparison tool with drivetrain, dimensions, and warranty data - Filter Carvana inventory by
fuel_typeandmax_priceto surface affordable hybrid and electric options for fleet procurement - Extract
imperfectionsimages from vehicle detail responses to build a condition-grading dataset - Paginate through
search_vehiclesresults usingtotalMatchedPagesto build a full inventory snapshot for offline analysis - Pull
financeInfofields across search results to model estimated monthly payments across different vehicle segments
| 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 | 100 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 developer API?+
What does `get_vehicle_detail` return beyond what search results include?+
vehicleId, price, mileage, and fuelType. The detail endpoint adds full specifications (dimensions, drivetrain, warranty), categorized feature lists, a complete image set including spin data and imperfection photos, interior and exterior color, and an availability object with purchaseType and saleStatus.Can I filter search results by mileage, year, transmission, or body style?+
search_vehicles and search_electric_vehicles endpoints filter by make, model, fuel_type, max_price, min_price (EVs only), zip5, and query. Mileage range, model year, transmission, and body style filters are not exposed. You can fork this API on Parse and revise it to add those filter parameters.How does pagination work across the search endpoints?+
currentPage, totalMatchedPages, and totalMatchedInventory alongside a pageSize field. Pass the page integer parameter to navigate through results. The search_vehicles endpoint exposes page directly; the EV-focused endpoints do not currently accept a page parameter, so only the first page of results is returned for those.Does the API expose seller contact details, auction history, or price drop history for a vehicle?+
get_vehicle_detail responses.