Endpoint Playground

Try the CarMax vehicle listing search API

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.

What a live request returned

14 Oct 2026: 48 vehicles; 27 fields had a value in every checked item and 4 varied between items.

Observed request: GET /carmax/search?make=Honda&model=Civic
Fields with a value in every checked item: stock_number, vin, year, make, model, trim, body, mileage

Sample value profiles: body: 4D Sedan (34), 4D Hatchback (10), 2D Coupe (4); stock_number: 26,350,524 to 70,286,615, median 29,204,425; trim: “Sport” and 8 other values.

Request: GET /carmax/search
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 99.8%, median 3.26 s
Monitored request: GET /carmax/search?make=Honda&model=Civic

CarMax vehicle listing search API documentation CarMax platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/carmax/search' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Description
make	string	No	CarMax make, e.g. honda, Toyota, BMW (case-insensitive)
model	string	No	CarMax model, e.g. civic (case-insensitive). Does not require make
zip	string	No	5-digit US ZIP code to bias results toward CarMax's nearest store
sort	string	No	Sort order: bestmatch, distance-asc, price-asc, price-desc, mileage-asc, mileage-desc, year-desc, year-asc, newarrival. Defaults to bestmatch
min_year	integer	No	Minimum model year
max_year	integer	No	Maximum model year
min_price	integer	No	Minimum price in US dollars
max_price	integer	No	Maximum price in US dollars
max_mileage	integer	No	Maximum odometer mileage
page	integer	No	1-indexed result page, defaults to 1. CarMax returns 48 results per page

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "total_count": 91136,
    "page": 1,
    "page_size": 48,
    "vehicles": [
      {
        "stock_number": 28187774,
        "vin": "1FMJK1K89REA27006",
        "year": 2024,
        "make": "Ford",
        "model": "Expedition Max",
        "trim": "Limited",
        "body": "4D Sport Utility",
        "mileage": 41406,
        "exterior_color": "Black",
        "interior_color": "Tan",
        "engine": "3.5L",
        "transmission": {
          "type": "Automatic",
          "display": "Automatic"
        },
        "drive_train_type": "Rear Wheel Drive",
        "fuel": {
          "type": "Gas"
        },
        "efficiency": {
          "mpg_city": 17,
          "mpg_highway": 23
        },
        "price_info": {
          "price": 45998,
          "is_price_reduced": true,
          "previous_price": 46998
        },
        "store": {
          "id": 7124,
          "name": "Canoga Park"
        },
        "hero_image_url": "https://img2.carmax.com/assets/28187774/hero.jpg?width=400",
        "highlighted_features": [
          "Turbo Charged Engine",
          "Leather Seats",
          "Panoramic Sunroof"
        ],
        "engine_torque_lb_ft": 480,
        "engine_torque_rpm": 2250,
        "horsepower": 400,
        "horsepower_rpm": 5000,
        "cylinders": 6,
        "towing_capacity_lbs": 6300,
        "passenger_count": 7,
        "prior_uses": [
          "Leased Vehicle",
          "Rental"
        ],
        "image_count": 31,
        "description": "2024 Ford Expedition Max Limited",
        "url": "https://www.carmax.com/car/28187774"
      }
    ],
    "filters": [
      {
        "name": "Make",
        "display_name": "Make",
        "type": "Value",
        "values": [
          {
            "value": "Toyota",
            "count": 12453
          },
          {
            "value": "Ford",
            "count": 9821
          }
        ]
      },
      {
        "name": "BasePrice",
        "display_name": "Price range",
        "type": "Range",
        "range": {
          "minimum": 8000,
          "maximum": 138999,
          "increment": 1000,
          "histogram": [
            {
              "minimum": 8000,
              "maximum": 8999,
              "count": 4
            },
            {
              "minimum": 9000,
              "maximum": 9999,
              "count": 36
            }
          ]
        }
      }
    ],
    "source_url": "https://mobileapps-afd-prod-endpoint-drgsgffchcfkbmg4.z01.azurefd.net/api/search"
  }
}

More CarMax endpoints

Get CarMax search autocomplete suggestions Get CarMax's "shop by brand" make taxonomy Get CarMax store (physical location) detail Search CarMax store (physical location) locations Get CarMax vehicle listing detail Get CarMax "similar vehicles" recommendations for a listing

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestcarmax.searchResponseDocCarMax

GET /carmax/search

Search CarMax vehicle listings

Response behavior

- `total_count` reflects CarMax's full matching-result count for the applied filters, not just `len(vehicles)`. - `price_info.is_price_reduced` and `price_info.previous_price` are set when CarMax shows a recent price drop on the listing. - Vehicle summaries carry exact numeric engine/performance fields (`engine_torque_lb_ft`, `engine_torque_rpm`, `horsepower`, `horsepower_rpm`, `cylinders`, `towing_capacity_lbs`, `passenger_count`) and listing metadata (`image_count`, `description`, `prior_uses`), with full per-vehicle detail inline rather than just a summary. - `filters` lists CarMax's own search facets for the applied filters, with live counts/bounds — the same data CarMax's own filter UI is built from. Each entry's `type` is either `Value` (a discrete list of options with per-value counts, e.g. make, model, body type, exterior color, feature — populates `values`) or `Range` (numeric bounds plus a count histogram, e.g. price, year, mileage — populates `range`).

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "total_count": 91136,
    "page": 1,
    "page_size": 48,
    "vehicles": [
      {
        "stock_number": 28187774,
        "vin": "1FMJK1K89REA27006",
        "year": 2024,
        "make": "Ford",
        "model": "Expedition Max",
        "trim": "Limited",
        "body": "4D Sport Utility",
        "mileage": 41406,
        "exterior_color": "Black",
        "interior_color": "Tan",
        "engine": "3.5L",
        "transmission": {
          "type": "Automatic",
          "display": "Automatic"
        },
        "drive_train_type": "Rear Wheel Drive",
        "fuel": {
          "type": "Gas"
        },
        "efficiency": {
          "mpg_city": 17,
          "mpg_highway": 23
        },
        "price_info": {
          "price": 45998,
          "is_price_reduced": true,
          "previous_price": 46998
        },
        "store": {
          "id": 7124,
          "name": "Canoga Park"
        },
        "hero_image_url": "https://img2.carmax.com/assets/28187774/hero.jpg?width=400",
        "highlighted_features": [
          "Turbo Charged Engine",
          "Leather Seats",
          "Panoramic Sunroof"
        ],
        "engine_torque_lb_ft": 480,
        "engine_torque_rpm": 2250,
        "horsepower": 400,
        "horsepower_rpm": 5000,
        "cylinders": 6,
        "towing_capacity_lbs": 6300,
        "passenger_count": 7,
        "prior_uses": [
          "Leased Vehicle",
          "Rental"
        ],
        "image_count": 31,
        "description": "2024 Ford Expedition Max Limited",
        "url": "https://www.carmax.com/car/28187774"
      }
    ],
    "filters": [
      {
        "name": "Make",
        "display_name": "Make",
        "type": "Value",
        "values": [
          {
            "value": "Toyota",
            "count": 12453
          },
          {
            "value": "Ford",
            "count": 9821
          }
        ]
      },
      {
        "name": "BasePrice",
        "display_name": "Price range",
        "type": "Range",
        "range": {
          "minimum": 8000,
          "maximum": 138999,
          "increment": 1000,
          "histogram": [
            {
              "minimum": 8000,
              "maximum": 8999,
              "count": 4
            },
            {
              "minimum": 9000,
              "maximum": 9999,
              "count": 36
            }
          ]
        }
      }
    ],
    "source_url": "https://mobileapps-afd-prod-endpoint-drgsgffchcfkbmg4.z01.azurefd.net/api/search"
  }
}

Try the CarMax vehicle listing search API

What a live request returned

14 Oct 2026: 48 vehicles; 27 fields had a value in every checked item and 4 varied between items.

Observed request: GET /carmax/search?make=Honda&model=Civic
Fields with a value in every checked item: stock_number, vin, year, make, model, trim, body, mileage

Sample value profiles: body: 4D Sedan (34), 4D Hatchback (10), 2D Coupe (4); stock_number: 26,350,524 to 70,286,615, median 29,204,425; trim: “Sport” and 8 other values.

Request: GET /carmax/search
Cost: 3 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 99.8%, median 3.26 s
Monitored request: GET /carmax/search?make=Honda&model=Civic

CarMax vehicle listing search API documentation CarMax platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/carmax/search' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Description
make	string	No	CarMax make, e.g. honda, Toyota, BMW (case-insensitive)
model	string	No	CarMax model, e.g. civic (case-insensitive). Does not require make
zip	string	No	5-digit US ZIP code to bias results toward CarMax's nearest store
sort	string	No	Sort order: bestmatch, distance-asc, price-asc, price-desc, mileage-asc, mileage-desc, year-desc, year-asc, newarrival. Defaults to bestmatch
min_year	integer	No	Minimum model year
max_year	integer	No	Maximum model year
min_price	integer	No	Minimum price in US dollars
max_price	integer	No	Maximum price in US dollars
max_mileage	integer	No	Maximum odometer mileage
page	integer	No	1-indexed result page, defaults to 1. CarMax returns 48 results per page

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "total_count": 91136,
    "page": 1,
    "page_size": 48,
    "vehicles": [
      {
        "stock_number": 28187774,
        "vin": "1FMJK1K89REA27006",
        "year": 2024,
        "make": "Ford",
        "model": "Expedition Max",
        "trim": "Limited",
        "body": "4D Sport Utility",
        "mileage": 41406,
        "exterior_color": "Black",
        "interior_color": "Tan",
        "engine": "3.5L",
        "transmission": {
          "type": "Automatic",
          "display": "Automatic"
        },
        "drive_train_type": "Rear Wheel Drive",
        "fuel": {
          "type": "Gas"
        },
        "efficiency": {
          "mpg_city": 17,
          "mpg_highway": 23
        },
        "price_info": {
          "price": 45998,
          "is_price_reduced": true,
          "previous_price": 46998
        },
        "store": {
          "id": 7124,
          "name": "Canoga Park"
        },
        "hero_image_url": "https://img2.carmax.com/assets/28187774/hero.jpg?width=400",
        "highlighted_features": [
          "Turbo Charged Engine",
          "Leather Seats",
          "Panoramic Sunroof"
        ],
        "engine_torque_lb_ft": 480,
        "engine_torque_rpm": 2250,
        "horsepower": 400,
        "horsepower_rpm": 5000,
        "cylinders": 6,
        "towing_capacity_lbs": 6300,
        "passenger_count": 7,
        "prior_uses": [
          "Leased Vehicle",
          "Rental"
        ],
        "image_count": 31,
        "description": "2024 Ford Expedition Max Limited",
        "url": "https://www.carmax.com/car/28187774"
      }
    ],
    "filters": [
      {
        "name": "Make",
        "display_name": "Make",
        "type": "Value",
        "values": [
          {
            "value": "Toyota",
            "count": 12453
          },
          {
            "value": "Ford",
            "count": 9821
          }
        ]
      },
      {
        "name": "BasePrice",
        "display_name": "Price range",
        "type": "Range",
        "range": {
          "minimum": 8000,
          "maximum": 138999,
          "increment": 1000,
          "histogram": [
            {
              "minimum": 8000,
              "maximum": 8999,
              "count": 4
            },
            {
              "minimum": 9000,
              "maximum": 9999,
              "count": 36
            }
          ]
        }
      }
    ],
    "source_url": "https://mobileapps-afd-prod-endpoint-drgsgffchcfkbmg4.z01.azurefd.net/api/search"
  }
}

Search CarMax vehicle listings

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "total_count": 91136, "page": 1, "page_size": 48, "vehicles": [ { "stock_number": 28187774, "vin": "1FMJK1K89REA27006", "year": 2024, "make": "Ford", "model": "Expedition Max", "trim": "Limited", "body": "4D Sport Utility", "mileage": 41406, "exterior_color": "Black", "interior_color": "Tan", "engine": "3.5L", "transmission": { "type": "Automatic", "display": "Automatic" }, "drive_train_type": "Rear Wheel Drive", "fuel": { "type": "Gas" }, "efficiency": { "mpg_city": 17, "mpg_highway": 23 }, "price_info": { "price": 45998, "is_price_reduced": true, "previous_price": 46998 }, "store": { "id": 7124, "name": "Canoga Park" }, "hero_image_url": "https://img2.carmax.com/assets/28187774/hero.jpg?width=400", "highlighted_features": [ "Turbo Charged Engine", "Leather Seats", "Panoramic Sunroof" ], "engine_torque_lb_ft": 480, "engine_torque_rpm": 2250, "horsepower": 400, "horsepower_rpm": 5000, "cylinders": 6, "towing_capacity_lbs": 6300, "passenger_count": 7, "prior_uses": [ "Leased Vehicle", "Rental" ], "image_count": 31, "description": "2024 Ford Expedition Max Limited", "url": "https://www.carmax.com/car/28187774" } ], "filters": [ { "name": "Make", "display_name": "Make", "type": "Value", "values": [ { "value": "Toyota", "count": 12453 }, { "value": "Ford", "count": 9821 } ] }, { "name": "BasePrice", "display_name": "Price range", "type": "Range", "range": { "minimum": 8000, "maximum": 138999, "increment": 1000, "histogram": [ { "minimum": 8000, "maximum": 8999, "count": 4 }, { "minimum": 9000, "maximum": 9999, "count": 36 } ] } } ], "source_url": "https://mobileapps-afd-prod-endpoint-drgsgffchcfkbmg4.z01.azurefd.net/api/search" } }