CarMax

Search CarMax vehicle listings

Searches CarMax for used car listings, returning vehicle summaries (make, model, trim, year, mileage, colors, engine, fuel economy, pricing, store, images), available search facets with live counts, and the total matching count.

get/carmax/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/carmax/search
  • Auth: API key in header x-api-key

Query parameters

makestring

CarMax make, e.g. honda, Toyota, BMW (case-insensitive)

modelstring

CarMax model, e.g. civic (case-insensitive). Does not require make

zipstring

5-digit US ZIP code to bias results toward CarMax's nearest store

sortstring

Sort order: bestmatch, distance-asc, price-asc, price-desc, mileage-asc, mileage-desc, year-desc, year-asc, newarrival. Defaults to bestmatch

min_yearinteger

Minimum model year

max_yearinteger

Maximum model year

min_priceinteger

Minimum price in US dollars

max_priceinteger

Maximum price in US dollars

max_mileageinteger

Maximum odometer mileage

pageinteger

1-indexed result page, defaults to 1. CarMax returns 48 results per page

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "filters": [
      {
        "display_name": "Make",
        "name": "Make",
        "range": {
          "histogram": [
            {
              "count": 193,
              "maximum": 20999,
              "minimum": 20000
            }
          ],
          "increment": 1000,
          "maximum": 138999,
          "minimum": 8000
        },
        "type": "Value",
        "values": [
          {
            "count": 12453,
            "url_segment": "toyota",
            "value": "Toyota"
          }
        ]
      }
    ],
    "page": 1,
    "page_size": 48,
    "total_count": 91136,
    "vehicles": [
      {
        "body": "4D Sport Utility",
        "cylinders": 6,
        "description": "2024 Ford Expedition Max Limited",
        "drive_train_type": "Rear Wheel Drive",
        "efficiency": {
          "mpg_city": 17,
          "mpg_highway": 23
        },
        "engine": "6-cyl, Turbo Gas, 3.5L",
        "engine_torque_lb_ft": 480,
        "engine_torque_rpm": 2250,
        "exterior_color": "Black",
        "fuel": {
          "capacity_gallons": 28.3,
          "type": "Gas"
        },
        "horsepower": 400,
        "horsepower_rpm": 5000,
        "image_count": 31,
        "interior_color": "Tan",
        "make": "Ford",
        "mileage": 41406,
        "model": "Expedition Max",
        "passenger_count": 7,
        "price_info": {
          "previous_price": 46998,
          "price": 45998
        },
        "prior_uses": [
          "Leased Vehicle",
          "Rental"
        ],
        "stock_number": 28187774,
        "store": {
          "distance_miles": 22.2,
          "id": 7124,
          "name": "Canoga Park",
          "state": "CA"
        },
        "towing_capacity_lbs": 6300,
        "transmission": {
          "display": "Automatic",
          "type": "Automatic"
        },
        "trim": "Limited",
        "url": "https://www.carmax.com/car/28187774",
        "vin": "1FMJK1K89REA27006",
        "year": 2024
      }
    ]
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.