---
title: "Search CarMax store (physical location) locations"
method: GET
path: "/carmax/stores"
tags: ["CarMax"]
---

# Search CarMax store (physical location) locations

`GET /carmax/stores`

## Request

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

Searches CarMax's physical store locations by ZIP code or free-text keyword, returning stores with full address, every published phone number, opening hours, and (for a ZIP-based search) live driving distance in miles.

## Query parameters

- `zip` string
- `keyword` string
- `take` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- CarmaxStoreSearchResponseDoc
  - `code` integer
  - `data` CarmaxStoreSearchResponse
    - `source_url` string
    - `stores` CarmaxStoreLocation[]
      - `active_status` string
      - `address` string
      - `address_line1` string
      - `address_line2` string
      - `city` string
      - `distance_miles` number
      - `hours` CarmaxStoreHours[]
        - `close_time` string
        - `days_of_week_display` string
        - `end_day_of_week` integer
        - `hours_display` string
        - `open_time` string
        - `start_day_of_week` integer
      - `iana_time_zone` string
      - `id` integer
      - `is_perfect_transfer_store` boolean
      - `latitude` number
      - `longitude` number
      - `name` string
      - `phone_numbers` CarmaxStorePhoneNumber[]
        - `number` string
        - `type` string
      - `primary_phone_number` string
      - `state` string
      - `state_abbreviation` string
      - `store_availability` string
      - `time_zone` string
      - `url` string
      - `zip_code` string
  - `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)