CarMax Scraper

Scrape used car listings from CarMax — America's largest used-car retailer. Search inventory by keyword or browse by manufacturer, and get price, mileage, model year, trim, color, transmission, fuel type, drivetrain, and photos for every vehicle. No login and no browser required — results come back in seconds.

What this actor does

• Search by keyword — free-text search across CarMax's nationwide inventory (e.g. toyota camry, suv, pickup truck)
• Browse by manufacturer — pick any of CarMax's 35 supported brands, optionally narrowed to a specific model
• Location-aware — supply a US ZIP code to center results on a specific CarMax store's local inventory
• Built-in filters — price range, model-year range, and maximum mileage
• Rich vehicle data — VIN, trim, drivetrain, horsepower, city/highway MPG, exterior/interior color, and top vehicle features
• Clean output — every field is real data pulled straight from CarMax; empty fields are simply omitted, never left blank or null

Output per vehicle

• vehicleId, vin
• make, model, year, trim
• price (USD), mileage
• exteriorColor, interiorColor
• transmission, fuelType, driveTrain, bodyType
• horsepower, mpgCity, mpgHighway
• location (store city + state), storeName
• features[] — top equipment highlights
• imageUrl — vehicle photo
• vehicleUrl — direct link to the CarMax listing
• isNewArrival — whether CarMax flags the vehicle as a new arrival (boolean)
• sourceUrl, scrapedAt, recordType

Input

Field	Type	Default	Description
mode	string	search	search (keyword) or byMake (browse by manufacturer)
searchQuery	string	toyota	Free-text search (mode=search)
make	string	Toyota	Manufacturer to browse (mode=byMake)
model	string	–	Narrow byMake browsing, or filter search results, to a specific model
zipCode	string	–	US ZIP code to center results on a local store
minPrice / maxPrice	int	–	Price range in USD
minYear / maxYear	int	–	Model-year range
maxMileage	int	–	Drop vehicles with more miles than this
maxItems	int	24	Hard cap on emitted records

Example: keyword search with filters

{
  "mode": "search",
  "searchQuery": "toyota",
  "maxPrice": 30000,
  "minYear": 2020,
  "maxMileage": 40000
}

Example: browse by manufacturer

{
  "mode": "byMake",
  "make": "Honda",
  "model": "Civic"
}

FAQ

Do I need a CarMax account or cookies? No. This actor reads CarMax's public inventory pages directly — no login, no API key, no cookies.

How many vehicles does one run return? CarMax renders a single results page per unique search/manufacturer/ZIP combination, typically up to ~24 vehicles. Run different searches (by model, price range, or ZIP code) to explore more of the nationwide inventory.

Why are some vehicle fields missing? Only fields CarMax actually publishes for a given vehicle are included — for example, not every listing has a documented trim level or interior color. Fields are never filled with placeholder or guessed values.

Can I filter by price or mileage? Yes — minPrice, maxPrice, minYear, maxYear, and maxMileage are all supported and applied to every result.

Is this actor region-specific? CarMax operates across the United States. Use the zipCode input to see inventory near a specific location.