---
title: "Search CarMax vehicle listings"
method: GET
path: "/carmax/search"
tags: ["CarMax"]
---

# Search CarMax vehicle listings

`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`

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.

## Query parameters

- `make` string
- `model` string
- `zip` string
- `sort` string
- `min_year` integer
- `max_year` integer
- `min_price` integer
- `max_price` integer
- `max_mileage` integer
- `page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- CarmaxSearchResponseDoc
  - `code` integer
  - `data` CarmaxSearchResponse
    - `filters` CarmaxFilterCategory[]
      - `display_name` string
      - `name` string
      - `range` CarmaxFilterRange
        - `histogram` CarmaxFilterRangeBucket[]
          - `count` integer
          - `maximum` number
          - `minimum` number
        - `increment` number
        - `maximum` number
        - `minimum` number
      - `type` string
      - `values` CarmaxFilterValue[]
        - `count` integer
        - `selected` boolean
        - `url_segment` string
        - `value` string
    - `page` integer
    - `page_size` integer
    - `source_url` string
    - `total_count` integer
    - `vehicles` CarmaxVehicle[]
      - `body` string
      - `cylinders` integer
      - `description` string
      - `drive_train_type` string
      - `efficiency` CarmaxEfficiency
        - `battery_range_miles` number
        - `is_mpg_equivalent` boolean
        - `mpg_city` integer
        - `mpg_combined` integer
        - `mpg_highway` integer
      - `engine` string
      - `engine_torque_lb_ft` integer: The fields below are only populated on the mobile-API-backed search path -- exact engine/performance numbers and listing metadata the website scrape never carried. All omitempty and additive; existing consumers reading only the fields above see no change.
      - `engine_torque_rpm` integer
      - `exterior_color` string
      - `features` string[]
      - `fuel` CarmaxFuel
        - `capacity_gallons` number
        - `type` string
      - `hero_image_url` string
      - `highlighted_features` string[]
      - `horsepower` integer
      - `horsepower_rpm` integer
      - `image_count` integer
      - `interior_color` string
      - `is_new_arrival` boolean
      - `is_transferable` boolean
      - `make` string
      - `mileage` integer
      - `model` string
      - `passenger_count` integer
      - `price_info` CarmaxPriceInfo
        - `fees` number
        - `fees_included_in_price` boolean
        - `is_price_reduced` boolean
        - `previous_price` number
        - `price` number
      - `prior_uses` string[]
      - `stock_number` integer
      - `store` CarmaxStore
        - `city` string
        - `distance_miles` number
        - `id` integer
        - `latitude` number
        - `longitude` number
        - `name` string
        - `state` string
      - `towing_capacity_lbs` integer
      - `transmission` CarmaxTransmission
        - `display` string
        - `type` string
      - `trim` string
      - `url` string
      - `vin` string
      - `year` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)