# CarMax Used Car Listings Scraper (`crawlerbros/carmax-scraper`) Actor Scrape used car listings from CarMax.com by keyword search or by manufacturer. Get price, mileage, year, trim, color, transmission, fuel type, and images. - **URL**: https://apify.com/crawlerbros/carmax-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, E-commerce, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## CarMax Scraper Scrape used car listings from [CarMax](https://www.carmax.com) — America's largest used-car retailer. Search inventory by keyword or browse by manufacturer, and get price, mileage, model year, trim, color, transmission, fuel type, drivetrain, and photos for every vehicle. No login and no browser required — results come back in seconds. ### What this actor does - **Search by keyword** — free-text search across CarMax's nationwide inventory (e.g. `toyota camry`, `suv`, `pickup truck`) - **Browse by manufacturer** — pick any of CarMax's 35 supported brands, optionally narrowed to a specific model - **Location-aware** — supply a US ZIP code to center results on a specific CarMax store's local inventory - **Built-in filters** — price range, model-year range, and maximum mileage - **Rich vehicle data** — VIN, trim, drivetrain, horsepower, city/highway MPG, exterior/interior color, and top vehicle features - **Clean output** — every field is real data pulled straight from CarMax; empty fields are simply omitted, never left blank or null ### Output per vehicle - `vehicleId`, `vin` - `make`, `model`, `year`, `trim` - `price` (USD), `mileage` - `exteriorColor`, `interiorColor` - `transmission`, `fuelType`, `driveTrain`, `bodyType` - `horsepower`, `mpgCity`, `mpgHighway` - `location` (store city + state), `storeName` - `features[]` — top equipment highlights - `imageUrl` — vehicle photo - `vehicleUrl` — direct link to the CarMax listing - `isNewArrival` — whether CarMax flags the vehicle as a new arrival (boolean) - `sourceUrl`, `scrapedAt`, `recordType` ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `search` | `search` (keyword) or `byMake` (browse by manufacturer) | | `searchQuery` | string | `toyota` | Free-text search (mode=search) | | `make` | string | `Toyota` | Manufacturer to browse (mode=byMake) | | `model` | string | – | Narrow `byMake` browsing, or filter `search` results, to a specific model | | `zipCode` | string | – | US ZIP code to center results on a local store | | `minPrice` / `maxPrice` | int | – | Price range in USD | | `minYear` / `maxYear` | int | – | Model-year range | | `maxMileage` | int | – | Drop vehicles with more miles than this | | `maxItems` | int | `24` | Hard cap on emitted records | #### Example: keyword search with filters ```json { "mode": "search", "searchQuery": "toyota", "maxPrice": 30000, "minYear": 2020, "maxMileage": 40000 } ```` #### Example: browse by manufacturer ```json { "mode": "byMake", "make": "Honda", "model": "Civic" } ``` ### FAQ **Do I need a CarMax account or cookies?** No. This actor reads CarMax's public inventory pages directly — no login, no API key, no cookies. **How many vehicles does one run return?** CarMax renders a single results page per unique search/manufacturer/ZIP combination, typically up to ~24 vehicles. Run different searches (by model, price range, or ZIP code) to explore more of the nationwide inventory. **Why are some vehicle fields missing?** Only fields CarMax actually publishes for a given vehicle are included — for example, not every listing has a documented trim level or interior color. Fields are never filled with placeholder or guessed values. **Can I filter by price or mileage?** Yes — `minPrice`, `maxPrice`, `minYear`, `maxYear`, and `maxMileage` are all supported and applied to every result. **Is this actor region-specific?** CarMax operates across the United States. Use the `zipCode` input to see inventory near a specific location. # Actor input Schema ## `mode` (type: `string`): What to fetch. ## `searchQuery` (type: `string`): Free-text search, e.g. `toyota camry`, `suv`, `honda civic`. ## `make` (type: `string`): Browse CarMax inventory for a specific manufacturer. ## `model` (type: `string`): Narrow `byMake` browsing to a specific model (e.g. `Camry`), or filter `search` results whose model contains this text. ## `zipCode` (type: `string`): US ZIP code to center results on a specific CarMax store's local inventory (defaults to CarMax's own IP-based location). ## `minPrice` (type: `integer`): Drop vehicles priced below this amount. ## `maxPrice` (type: `integer`): Drop vehicles priced above this amount. ## `minYear` (type: `integer`): Drop vehicles older than this model year. ## `maxYear` (type: `integer`): Drop vehicles newer than this model year. ## `maxMileage` (type: `integer`): Drop vehicles with more miles than this. ## `maxItems` (type: `integer`): Hard cap on emitted records. CarMax renders a single results page per search/make combination (typically up to ~24 vehicles); use ZIP code, model, or price/year/mileage filters to explore additional inventory. ## Actor input object example ```json { "mode": "search", "searchQuery": "toyota", "make": "Toyota", "maxItems": 24 } ``` # Actor output Schema ## `vehicles` (type: `string`): Dataset containing all scraped CarMax vehicle listings. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "search", "searchQuery": "toyota", "make": "Toyota", "maxItems": 24 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/carmax-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "search", "searchQuery": "toyota", "make": "Toyota", "maxItems": 24, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/carmax-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "search", "searchQuery": "toyota", "make": "Toyota", "maxItems": 24 }' | apify call crawlerbros/carmax-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/carmax-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "CarMax Used Car Listings Scraper", "description": "Scrape used car listings from CarMax.com by keyword search or by manufacturer. Get price, mileage, year, trim, color, transmission, fuel type, and images.", "version": "1.0", "x-build-id": "Zg2grvASMcJh0lWEi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~carmax-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-carmax-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~carmax-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-carmax-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~carmax-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-carmax-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byMake" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Free-text search, e.g. `toyota camry`, `suv`, `honda civic`.", "default": "toyota" }, "make": { "title": "Manufacturer (mode=byMake)", "enum": [ "Acura", "Alfa Romeo", "Audi", "BMW", "Buick", "Cadillac", "Chevrolet", "Chrysler", "Dodge", "Fiat", "Ford", "Genesis", "GMC", "Honda", "Hyundai", "Infiniti", "Jaguar", "Jeep", "Kia", "Land Rover", "Lexus", "Lincoln", "Maserati", "Mazda", "Mercedes-Benz", "Mini", "Mitsubishi", "Nissan", "Porsche", "Ram", "Subaru", "Tesla", "Toyota", "Volkswagen", "Volvo" ], "type": "string", "description": "Browse CarMax inventory for a specific manufacturer.", "default": "Toyota" }, "model": { "title": "Model (optional)", "type": "string", "description": "Narrow `byMake` browsing to a specific model (e.g. `Camry`), or filter `search` results whose model contains this text." }, "zipCode": { "title": "ZIP code (optional)", "type": "string", "description": "US ZIP code to center results on a specific CarMax store's local inventory (defaults to CarMax's own IP-based location)." }, "minPrice": { "title": "Min price (USD)", "minimum": 0, "maximum": 500000, "type": "integer", "description": "Drop vehicles priced below this amount." }, "maxPrice": { "title": "Max price (USD)", "minimum": 0, "maximum": 500000, "type": "integer", "description": "Drop vehicles priced above this amount." }, "minYear": { "title": "Min model year", "minimum": 1980, "maximum": 2100, "type": "integer", "description": "Drop vehicles older than this model year." }, "maxYear": { "title": "Max model year", "minimum": 1980, "maximum": 2100, "type": "integer", "description": "Drop vehicles newer than this model year." }, "maxMileage": { "title": "Max mileage", "minimum": 0, "maximum": 500000, "type": "integer", "description": "Drop vehicles with more miles than this." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 100, "type": "integer", "description": "Hard cap on emitted records. CarMax renders a single results page per search/make combination (typically up to ~24 vehicles); use ZIP code, model, or price/year/mileage filters to explore additional inventory.", "default": 24 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```