CarMax Scraper

Extract public used-vehicle inventory from CarMax search-result pages or individual vehicle URLs. The actor is designed for dealerships, automotive marketplaces, inventory analysts, lead researchers, and AI agents that need bounded vehicle records in a stable dataset shape.

What it extracts

Each vehicle record can include the canonical URL, stock number, VIN, year, make, model, price, mileage, location, body type, fuel type, transmission, color, public description, image URLs, and publicly displayed features. CarMax may omit fields on some pages; missing values are returned as null and non-fatal limitations are listed in warnings.

Input

Provide one or more absolute https://www.carmax.com URLs in startUrls. Search URLs such as https://www.carmax.com/cars are expanded across up to maxPages pages. Individual vehicle URLs such as https://www.carmax.com/car/12345678 can be supplied directly. maxResults caps the number of vehicle records. includeDetails defaults to true; turn it off when you only need discovered vehicle URLs. Use proxyConfiguration when a cloud IP is challenged.

Example:

{
  "startUrls": [{ "url": "https://www.carmax.com/cars" }],
  "maxResults": 25,
  "maxPages": 3,
  "includeDetails": true
}

Output

{
  "recordType": "vehicle",
  "url": "https://www.carmax.com/car/12345678",
  "stockNumber": "26123456",
  "vin": null,
  "year": 2022,
  "make": "Toyota",
  "model": "Camry SE",
  "price": 24998,
  "mileage": 32145,
  "location": "CarMax Austin North",
  "imageUrls": [],
  "features": [],
  "warnings": []
}

Pricing

The intended PPE configuration charges $0.01 per run plus $0.005 per vehicle record. A run with no discovered vehicles returns a diagnostic summary instead of silently pretending that inventory was extracted.

Reliability and limits

The crawler uses a real browser, bounded pagination, low concurrency, deduplication, selector fallbacks, and JSON-LD/visible-page parsing. It does not log in, bypass a CAPTCHA, or collect private customer information. CarMax inventory, pricing, and vehicle availability change frequently; use the source URL and scrapedAt timestamp for freshness.

Use the data in accordance with CarMax's terms, applicable law, and the rights of the website and vehicle owners. This actor is for publicly displayed inventory only.