# Carmax — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search CarMax's inventory to find vehicles by make, model, price, and features, then access detailed specs, photos, and pricing for any car that interests you. Locate nearby CarMax stores, view their hours and contact information, and browse the specific inventory available at each location.

**Category:** Automotive | **Website:** [carmax.com/](https://carmax.com/) | **Docs:** [parse.bot/marketplace/8c65847a-d029-4c10-9747-9811761e6df3/carmax-com-api](https://parse.bot/marketplace/8c65847a-d029-4c10-9747-9811761e6df3/carmax-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-carmax-com-api-8c65847a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_store_details

Get detailed information for a specific CarMax store, including address, phone numbers, hours of operation, holiday hours, service hours, and current open/closed status. The store_id can be found from vehicle search results (storeId field).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `store_id` | string | Yes | The unique CarMax store ID (e.g. 7810). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-carmax-com-api-8c65847a/get_store_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store_id":"<string>"}'
```

### get_store_inventory

Get car inventory available near a specific store. If zip_code is omitted, the scraper resolves it from the store's details. Returns the same vehicle listing format as search_cars. Paginated via skip/take offsets.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `skip` | integer | No | Number of results to skip for pagination. |
| `store_id` | string | Yes | The unique CarMax store ID (e.g. 7810). |
| `take` | integer | No | Number of results to return per page. |
| `zip_code` | string | No | 5-digit US ZIP code for the store area. If omitted, the scraper resolves it from the store's details. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-carmax-com-api-8c65847a/get_store_inventory \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"skip":"<integer>","store_id":"<string>","take":"<integer>","zip_code":"<string>"}'
```

### get_stores

Get a list of all CarMax store locations with names, addresses, and geographic coordinates. Parsed from structured data on the stores page. No pagination — returns the complete list.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-carmax-com-api-8c65847a/get_stores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_vehicle_details

Get detailed information for a specific vehicle by stock number, including specs, features, images, highlights, and customer reviews for the make/model. The stock_number can be obtained from search_cars results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `stock_number` | string | Yes | The unique CarMax stock number for the vehicle (e.g. 28679371). |
| `store_id` | string | No | Optional store ID to check transfer availability and fees. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-carmax-com-api-8c65847a/get_vehicle_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"stock_number":"<string>","store_id":"<string>"}'
```

### search_cars

Search for used cars on CarMax with filters and pagination. The uri parameter filters by make, model, or body type (e.g. /cars/toyota, /cars/suv). Returns vehicle listings sorted by the chosen order. Paginated via skip/take offsets.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `skip` | integer | No | Number of results to skip for pagination. |
| `sort` | string | No | Sort order for results. |
| `take` | integer | No | Number of results to return per page (max 100). |
| `uri` | string | No | Filter path for cars. Examples: /cars (all), /cars/toyota, /cars/toyota/camry, /cars/suv, /cars/sedan. |
| `zip_code` | string | No | 5-digit US ZIP code for location-based results and shipping estimates. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-carmax-com-api-8c65847a/search_cars \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"skip":"<integer>","sort":"<string>","take":"<integer>","uri":"<string>","zip_code":"<string>"}'
```