Docs menu

CarMax API endpoint

CarMax store locator API

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.

GETapiKey1 credit/requestCarMaxcarmax.storeSearchResponseDoc/carmax/stores

Endpoint facts

Method: GET
API path: /carmax/stores
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: CarMax
Response schema: #/definitions/carmax.storeSearchResponseDoc

CarMax Scraper API Try CarMax store locator API in Playground CarMax API documentation

How this endpoint behaves

Query parameters:

zip (optional) — 5-digit US ZIP code to search near. Triggers a live geo-distance sort and populates distance_miles on every result. Provide this or keyword; zip takes precedence if both are given.
keyword (optional) — free-text match against store name or city (e.g. a city name).
take (optional) — maximum number of stores to return. Defaults to 10, capped at 300 (CarMax has fewer than 300 stores nationwide, so take=300 returns every store).

Either zip or keyword is required; omitting both returns 400 before any upstream request is made.

Notable response behavior:

distance_miles is only populated when zip was used to search — a keyword text search does not compute distance.
hours reports CarMax's own compact day-range representation (start_day_of_week/end_day_of_week, 0=Sunday through 6=Saturday) plus human-readable days_of_week_display/hours_display strings.
store_availability is a live, human-readable status string (e.g. "Open Now. Closes at 9:00 PM PDT").
phone_numbers lists every phone line CarMax publishes for the store, tagged by type (local sales line, service line, fax, toll-free, ...). primary_phone_number is CarMax's own designated primary contact number.

Live monitoring

Monitored request: GET /carmax/stores?zip=90210
Checks passed, 7 days to 14 Oct 2026: 99.6%
Median response time: 2.04 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /carmax/stores?zip=90210
Items in stores: 10
Fields filled in every checked item: 19

Field	Filled in, of 10 checked	Values in the sample
id	10
name	10	“CarMax Burbank” and 9 other values
address_line1	10
address	10
city	10	“Burbank” and 9 other values
state	10	California in all 10
state_abbreviation	10	CA in all 10
zip_code	10
phone_numbers	10	median 8 entries
primary_phone_number	10	3,105,689,272 to 9,094,660,565, median 7,144,818,460
latitude	10
longitude	10
hours	10	median 3 entries
active_status	10	Active in all 10
store_availability	10	Opening Soon. Opens at 10:00 AM… in all 10
distance_miles	10	8.3 to 48.4, median 24.6
time_zone	10	PDT in all 10
iana_time_zone	10	America/Los_Angeles in all 10
url	10	carmax.com

Request parameters

Parameter	Type	Required	Default	Description	Example
zip	string	No		5-digit US ZIP code to search near. Triggers a live geo-distance sort. Provide this or keyword; zip takes precedence if both are given	90210
keyword	string	No		Free-text match against store name or city	Richmond
take	integer	No	10	Maximum number of stores to return, defaults to 10, capped at 300	10
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/carmax/stores?keyword=coffee" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "stores": [
      {
        "id": 7126,
        "name": "CarMax Burbank",
        "address_line1": "301 N Victory Blvd",
        "city": "Burbank",
        "state": "California",
        "state_abbreviation": "CA",
        "zip_code": "91502",
        "phone_numbers": [
          {
            "type": "PhoneLocal",
            "number": "8184316000"
          }
        ],
        "primary_phone_number": "8184316000",
        "latitude": 34.17144,
        "longitude": -118.30294,
        "hours": [
          {
            "start_day_of_week": 1,
            "end_day_of_week": 5,
            "open_time": "10:00:00",
            "close_time": "21:00:00",
            "days_of_week_display": "Monday - Friday",
            "hours_display": "10:00 AM - 9:00 PM"
          }
        ],
        "active_status": "Active",
        "store_availability": "Open Now. Closes at 9:00 PM PDT",
        "distance_miles": 8.3,
        "time_zone": "PDT",
        "iana_time_zone": "America/Los_Angeles",
        "url": "https://www.carmax.com/stores/7126"
      }
    ],
    "source_url": "https://mobileapps-afd-prod-endpoint-drgsgffchcfkbmg4.z01.azurefd.net/api/stores/details?Take=10&KeyWord=90210"
  }
}

Request schema

No body schema

Response schema

#/definitions/carmax.storeSearchResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	carmax.StoreSearchResponse	No
data.source_url	string	No
data.stores	array	No
data.stores[].active_status	string	No	Active
data.stores[].address	string	No	21300 Roscoe Blvd
data.stores[].address_line1	string	No	21300 Roscoe Blvd
data.stores[].address_line2	string	No
data.stores[].city	string	No	Canoga Park
data.stores[].distance_miles	number	No	8.3
data.stores[].hours	array	No		StoreHours record, 6 fields: close_time, days_of_week_display, end_day_of_week, hours_display, open_time, start_day_of_week. Described under CarMax store detail API.
data.stores[].iana_time_zone	string	No	America/Los_Angeles
data.stores[].id	integer	No	7124
data.stores[].is_perfect_transfer_store	boolean	No
data.stores[].latitude	number	No	34.21972
data.stores[].longitude	number	No	-118.59617
data.stores[].name	string	No	CarMax Canoga Park
data.stores[].phone_numbers	array	No
data.stores[].phone_numbers[].number	string	No	8184316000
data.stores[].phone_numbers[].type	string	No	PhoneLocal
data.stores[].primary_phone_number	string	No	8184316000
data.stores[].state	string	No	California
data.stores[].state_abbreviation	string	No	CA
data.stores[].store_availability	string	No	Open Now. Closes at 9:00 PM PDT
data.stores[].time_zone	string	No	PDT
data.stores[].url	string	No	https://www.carmax.com/stores/7124
data.stores[].zip_code	string	No	91304
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/carmax/stores?keyword=coffee" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More CarMax endpoint docs CarMax Scraper API CarMax vehicle listing search API documentation CarMax Search Suggestions API documentation CarMax shop-by-brand make taxonomy API documentation CarMax store detail API documentation CarMax vehicle listing detail API documentation CarMax vehicle recommendations API documentation

Open in Playground Back to group

Docs menu

CarMax API endpoint

CarMax store locator API

GETapiKey1 credit/requestCarMaxcarmax.storeSearchResponseDoc/carmax/stores

Endpoint facts

Method: GET
API path: /carmax/stores
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: CarMax
Response schema: #/definitions/carmax.storeSearchResponseDoc

CarMax Scraper API Try CarMax store locator API in Playground CarMax API documentation

How this endpoint behaves

Query parameters:

zip (optional) — 5-digit US ZIP code to search near. Triggers a live geo-distance sort and populates distance_miles on every result. Provide this or keyword; zip takes precedence if both are given.
keyword (optional) — free-text match against store name or city (e.g. a city name).
take (optional) — maximum number of stores to return. Defaults to 10, capped at 300 (CarMax has fewer than 300 stores nationwide, so take=300 returns every store).

Either zip or keyword is required; omitting both returns 400 before any upstream request is made.

Notable response behavior:

distance_miles is only populated when zip was used to search — a keyword text search does not compute distance.
hours reports CarMax's own compact day-range representation (start_day_of_week/end_day_of_week, 0=Sunday through 6=Saturday) plus human-readable days_of_week_display/hours_display strings.
store_availability is a live, human-readable status string (e.g. "Open Now. Closes at 9:00 PM PDT").
phone_numbers lists every phone line CarMax publishes for the store, tagged by type (local sales line, service line, fax, toll-free, ...). primary_phone_number is CarMax's own designated primary contact number.

Live monitoring

Monitored request: GET /carmax/stores?zip=90210
Checks passed, 7 days to 14 Oct 2026: 99.6%
Median response time: 2.04 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /carmax/stores?zip=90210
Items in stores: 10
Fields filled in every checked item: 19

Field	Filled in, of 10 checked	Values in the sample
id	10
name	10	“CarMax Burbank” and 9 other values
address_line1	10
address	10
city	10	“Burbank” and 9 other values
state	10	California in all 10
state_abbreviation	10	CA in all 10
zip_code	10
phone_numbers	10	median 8 entries
primary_phone_number	10	3,105,689,272 to 9,094,660,565, median 7,144,818,460
latitude	10
longitude	10
hours	10	median 3 entries
active_status	10	Active in all 10
store_availability	10	Opening Soon. Opens at 10:00 AM… in all 10
distance_miles	10	8.3 to 48.4, median 24.6
time_zone	10	PDT in all 10
iana_time_zone	10	America/Los_Angeles in all 10
url	10	carmax.com

Request parameters

Parameter	Type	Required	Default	Description	Example
zip	string	No		5-digit US ZIP code to search near. Triggers a live geo-distance sort. Provide this or keyword; zip takes precedence if both are given	90210
keyword	string	No		Free-text match against store name or city	Richmond
take	integer	No	10	Maximum number of stores to return, defaults to 10, capped at 300	10
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/carmax/stores?keyword=coffee" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "stores": [
      {
        "id": 7126,
        "name": "CarMax Burbank",
        "address_line1": "301 N Victory Blvd",
        "city": "Burbank",
        "state": "California",
        "state_abbreviation": "CA",
        "zip_code": "91502",
        "phone_numbers": [
          {
            "type": "PhoneLocal",
            "number": "8184316000"
          }
        ],
        "primary_phone_number": "8184316000",
        "latitude": 34.17144,
        "longitude": -118.30294,
        "hours": [
          {
            "start_day_of_week": 1,
            "end_day_of_week": 5,
            "open_time": "10:00:00",
            "close_time": "21:00:00",
            "days_of_week_display": "Monday - Friday",
            "hours_display": "10:00 AM - 9:00 PM"
          }
        ],
        "active_status": "Active",
        "store_availability": "Open Now. Closes at 9:00 PM PDT",
        "distance_miles": 8.3,
        "time_zone": "PDT",
        "iana_time_zone": "America/Los_Angeles",
        "url": "https://www.carmax.com/stores/7126"
      }
    ],
    "source_url": "https://mobileapps-afd-prod-endpoint-drgsgffchcfkbmg4.z01.azurefd.net/api/stores/details?Take=10&KeyWord=90210"
  }
}

Request schema

No body schema

Response schema

#/definitions/carmax.storeSearchResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	carmax.StoreSearchResponse	No
data.source_url	string	No
data.stores	array	No
data.stores[].active_status	string	No	Active
data.stores[].address	string	No	21300 Roscoe Blvd
data.stores[].address_line1	string	No	21300 Roscoe Blvd
data.stores[].address_line2	string	No
data.stores[].city	string	No	Canoga Park
data.stores[].distance_miles	number	No	8.3
data.stores[].hours	array	No		StoreHours record, 6 fields: close_time, days_of_week_display, end_day_of_week, hours_display, open_time, start_day_of_week. Described under CarMax store detail API.
data.stores[].iana_time_zone	string	No	America/Los_Angeles
data.stores[].id	integer	No	7124
data.stores[].is_perfect_transfer_store	boolean	No
data.stores[].latitude	number	No	34.21972
data.stores[].longitude	number	No	-118.59617
data.stores[].name	string	No	CarMax Canoga Park
data.stores[].phone_numbers	array	No
data.stores[].phone_numbers[].number	string	No	8184316000
data.stores[].phone_numbers[].type	string	No	PhoneLocal
data.stores[].primary_phone_number	string	No	8184316000
data.stores[].state	string	No	California
data.stores[].state_abbreviation	string	No	CA
data.stores[].store_availability	string	No	Open Now. Closes at 9:00 PM PDT
data.stores[].time_zone	string	No	PDT
data.stores[].url	string	No	https://www.carmax.com/stores/7124
data.stores[].zip_code	string	No	91304
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/carmax/stores?keyword=coffee" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

CarMax store locator API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

CarMax store locator API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related