# Carmax Cars Search Scraper (`stealth_mode/carmax-cars-search-scraper`) Actor Extract complete vehicle inventory from CarMax with 60+ fields per listing. Get pricing, specs, store info, features, and condition data — perfect for price monitoring, competitive analysis, and automotive market research. - **URL**: https://apify.com/stealth\_mode/carmax-cars-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Product Search Scraper: Scrape Inventory Data at Scale --- ### What Is CarMax? CarMax is North America's largest used car retailer, operating both online and through physical locations. The platform hosts tens of thousands of inventory listings with detailed vehicle specifications, pricing, condition reports, and customer reviews. Manually tracking inventory changes, prices, or market trends is impractical — the **CarMax Product Search Scraper** automates data extraction from search result pages and catalog listings, turning browsing sessions into structured datasets. --- ### Overview The **CarMax Product Search Scraper** extracts comprehensive vehicle listing data from CarMax.com search pages. It captures everything from basic vehicle specs (year, make, model) to advanced details (horsepower, torque, transfer terms, and EV tax credit eligibility). Ideal for: - **Price monitor tools** tracking vehicle depreciation and market shifts - **Competitive analysis platforms** comparing dealer inventories - **Automotive researchers** studying market trends and supply - **Automotive marketplaces** aggregating inventory across sources - **Finance platforms** analyzing vehicle availability and pricing patterns Key advantages include high per-URL item limits (up to 200), graceful error handling, and rich data spanning vehicle specs, financial terms, location details, and customer reviews. --- ### Input Format The scraper accepts a straightforward JSON configuration: ```json { "urls": [ "https://www.carmax.com/cars/bmw" ], "ignore_url_failures": true, "max_items_per_url": 200 } ```` #### Input Parameters | Parameter | Type | Description | Example | |---|---|---|---| | `urls` | Array | URLs of CarMax search or category pages to scrape | `["https://www.carmax.com/cars/bmw"]` | | `ignore_url_failures` | Boolean | If `true`, scraper skips failed URLs and continues running. If `false`, stops on first error | `true` | | `max_items_per_url` | Integer | Maximum vehicles extracted per URL (1-200) | `200` | **Usage notes:** - Target search pages: e.g., `carmax.com/cars/bmw`, `carmax.com/cars/audi`, or filtered URLs with price/mileage ranges - Batch up to 10-20 URLs in a single run for efficiency - Higher `max_items_per_url` values increase runtime; balance against data needs *** ### Output Format **Sample output** ```json { "stock_number": 28865592, "vin": "3FMTK3SU5PMA85266", "year": 2023, "make": "Ford", "model": "Mustang Mach-E", "body": "4D Sport Utility", "trim": "Premium", "base_price": 37998, "original_price": null, "has_price_drop": false, "mileage": 15322, "store_id": 6059, "store_name": "Buffalo", "store_city": "Buffalo", "state": "New York", "state_abbreviation": "NY", "distance": 0, "average_rating": 5, "number_of_reviews": 3, "repair_pal_data": null, "is_new_arrival": false, "is_transferable": false, "features": [ "Skylight(s)", "Apple CarPlay", "Lane Departure Warning", "Smart Key", "Android Auto", "Auxiliary Audio Input", "ABS Brakes", "Power Seat(s)", "Front Seat Heaters", "Side Airbags", "Alloy Wheels", "Power Locks", "Power Windows", "Rear Defroster", "Automated Cruise Control", "Blind Spot Monitor", "Heated Steering Wheel", "Power Hatch/Deck Lid", "Power Mirrors", "Memory Seat(s)", "Satellite Radio Ready", "Parking Sensors", "Bluetooth Technology", "Navigation System", "Sync System", "Rear View Camera", "Leatherette Seats", "Overhead Airbags", "SiriusXM Trial Available", "Premium Sound", "Sunroof(s)" ], "highlighted_features": "4WD/AWD,Leatherette Seats,Satellite Radio Ready,Parking Sensors,Rear View Camera,Skylight(s)", "highlights": [ "singleOwner", "lowMiles", "warranty", "advancedFeatures", "premiumAudio" ], "last_made_saleable_date": "2026-06-23T16:08:48.223Z", "transfer_fee": null, "transfer_tags": [ "SameLocation" ], "transfer_text": "Test drive today at", "transfer_type": "test-drive", "show_estimated_dates": false, "min_estimated_transfer_duration_in_days": 0, "max_estimated_transfer_duration_in_days": 0, "transfer_arrival_day_description": "today", "transfer_times_unavailable": false, "exterior_color": "Blue", "interior_color": "Black", "normalized_exterior_color": null, "normalized_interior_color": null, "transmission": "Automatic", "review": null, "number_of_favorites": 0, "is_saleable": true, "is_coming_soon": null, "is_reserved": null, "mpg_city": null, "mpg_highway": null, "original_battery_range_in_miles": 224, "cylinders": null, "drive_train": "All Wheel Drive", "engine_type": "Electric", "fuel_type": null, "horsepower": null, "horsepower_rpm": null, "engine_size": "0.0L", "engine_torque": null, "engine_torque_rpm": null, "prior_use_descriptions": null, "is_available_to_transact": null, "recommendation_type": null, "best_finance_decision": null, "store": { "id": 6059, "name": "Buffalo", "city": null, "state_abbreviation": null, "distance_in_miles": null, "zip_code": null, "disclaimer": null, "current_capabilities": null, "disclaimer_text": null, "short_disclaimer_text": null }, "feature_score": 8, "vehicle_size": "Compact", "packages": [ "Pony Package" ], "vehicle_types": [ "Sedans", "SUVs" ], "series": null, "is_saved_car": null, "hero_image_url": "https://img2.carmax.com/assets/28865592/hero.jpg?width=400", "hero_thumbnail_image_url": null, "is_ev_tax_credit_eligible": null, "badge": null, "from_url": "https://www.carmax.com/cars" } ``` Each vehicle listing returns a comprehensive record with 60+ fields organized by category: #### Vehicle Identification | Field | Meaning | |---|---| | `Stock Number` | CarMax's internal vehicle identifier | | `VIN` | Vehicle Identification Number (unique identifier) | | `Badge` | Special badges (e.g., "One Owner," "Accident Free") | | `Hero Image URL` | High-resolution main vehicle photo URL | | `Hero Thumbnail Image URL` | Thumbnail version of hero image | #### Vehicle Specs & Basics | Field | Meaning | |---|---| | `Year` | Model year of the vehicle | | `Make` | Manufacturer (e.g., BMW, Toyota) | | `Model` | Specific model name (e.g., 3 Series, Civic) | | `Body` | Body type (e.g., Sedan, SUV, Truck) | | `Trim` | Trim level (e.g., LX, Sport, Limited) | | `Series` | Model line or generation | | `Vehicle Size` | Size classification (compact, mid-size, full-size) | | `Vehicle Types` | Categories the vehicle belongs to | #### Pricing & Financial Terms | Field | Meaning | |---|---| | `Base Price` | Current listed price | | `Original Price` | Price before any reductions | | `Has Price Drop` | Boolean indicating if price has decreased | | `Transfer Fee` | Fee to transfer vehicle to your home store | | `Best Finance Decision` | CarMax's financing recommendation for this vehicle | | `Is EV Tax Credit Eligible` | Whether vehicle qualifies for federal EV tax credits | #### Condition & Mileage | Field | Meaning | |---|---| | `Mileage` | Current odometer reading | | `Is Saleable` | Whether the vehicle can currently be purchased | | `Is Coming Soon` | Whether vehicle is arriving soon but not yet available | | `Is Reserved` | Whether a customer has reserved the vehicle | | `Prior Use Descriptions` | Vehicle history (e.g., "Service Loaner," "Trade-in") | #### Appearance & Color | Field | Meaning | |---|---| | `Exterior Color` | Paint color as listed (e.g., "Pearl White Multi-Coat") | | `Interior Color` | Cabin color (e.g., "Black Leather") | | `Normalized Exterior Color` | Standardized exterior color for filtering | | `Normalized Interior Color` | Standardized interior color for filtering | #### Engine & Performance | Field | Meaning | |---|---| | `Engine Type` | Engine category (e.g., V6, Inline-4, Electric) | | `Cylinders` | Number of engine cylinders | | `Engine Size` | Displacement in liters (e.g., 2.0L) | | `Horsepower` | Max power output | | `Horsepower RPM` | RPM at which horsepower is achieved | | `Engine Torque` | Max torque in lb-ft | | `Engine Torque RPM` | RPM at which torque is achieved | | `Fuel Type` | Fuel source (gasoline, diesel, hybrid, electric) | | `Drive Train` | Drivetrain type (FWD, RWD, AWD, 4WD) | | `Transmission` | Transmission type and speeds (e.g., "6-Speed Automatic") | | `MPG City` | City fuel economy | | `MPG Highway` | Highway fuel economy | #### Battery & Electric Vehicles | Field | Meaning | |---|---| | `Original Battery Range In Miles` | Electric range for EV/PHEVs | #### Location & Store | Field | Meaning | |---|---| | `Store ID` | CarMax store identifier | | `Store Name` | Local store location name | | `Store City` | City of the store | | `State` | Full state name | | `State Abbreviation` | Two-letter state code (e.g., "CA") | | `Distance` | Miles from user's search location (if applicable) | #### Transfer & Delivery | Field | Meaning | |---|---| | `Is Transferable` | Whether the vehicle can be transferred to another store | | `Transfer Type` | Type of transfer available | | `Transfer Text` | Human-readable transfer description | | `Transfer Tags` | Tags describing transfer options | | `Show Estimated Dates` | Whether estimated transfer dates are shown | | `Min Estimated Transfer Duration In Days` | Fastest estimated transfer time | | `Max Estimated Transfer Duration In Days` | Slowest estimated transfer time | | `Transfer Arrival Day Description` | Narrative description of arrival timing | | `Transfer Times Unavailable` | Boolean if transfer times are unknown | #### Features & Packages | Field | Meaning | |---|---| | `Features` | Complete list of vehicle features | | `Highlighted Features` | Top 3-5 standout features | | `Highlights` | Key selling points | | `Packages` | Option packages included (e.g., "Sport Package") | #### Customer Review & Confidence | Field | Meaning | |---|---| | `Review` | Customer satisfaction score or review text | | `Average Rating` | Average customer rating (e.g., 4.5/5) | | `Number Of Reviews` | Count of customer reviews | | `Number Of Favorites` | How many users added to favorites | | `Repair Pal Data` | Reliability and repair cost data | #### Availability & Status | Field | Meaning | |---|---| | `Is New Arrival` | Whether vehicle recently arrived in inventory | | `Is Available To Transact` | Purchase availability status | | `Recommendation Type` | CarMax's recommendation category | | `Last Made Saleable Date` | Last date vehicle was available for purchase | #### Metadata | Field | Meaning | |---|---| | `Feature Score` | Internal score based on features and condition | | `Is Saved Car` | Whether customer saved this listing | | `Store` | Store object with full details | *** ### How to Use 1. **Identify search URLs** — Visit CarMax.com, use filters (make, price range, mileage, location), and copy the resulting search page URL. - Example: `https://www.carmax.com/cars/bmw?maxPrice=35000` 2. **Prepare input** — Add URLs to the `urls` array. Keep `ignore_url_failures: true` for robust runs. 3. **Set item limits** — Adjust `max_items_per_url` based on inventory size (higher = longer runtime). 4. **Execute scraper** — Start the run and monitor progress in real-time. 5. **Export data** — Download results as JSON, CSV, or Excel for analysis or integration. **Best practices:** - Scrape during off-peak hours to minimize resource usage - Use specific search URLs (filtered by make/price) for targeted runs - Test with `max_items_per_url: 10` first to validate output before bulk runs *** ### Use Cases & Business Value - **Price monitoring:** Track price drops and market trends for specific models - **Inventory analysis:** Compare stock levels, features, and availability across regions - **Competitive research:** Monitor competitor inventory and pricing strategies - **Market intelligence:** Analyze vehicle depreciation, popular trims, and demand patterns - **Integration:** Feed vehicle data into automotive marketplaces, price prediction engines, or finance platforms The **CarMax Product Search Scraper** transforms raw browsing into actionable data, powering insights that drive smarter automotive decisions. *** ### Conclusion Whether you're monitoring the used car market, building an automotive aggregator, or analyzing competitive pricing, the **CarMax Product Search Scraper** delivers complete vehicle data with minimal setup. With 60+ fields spanning specs, pricing, reviews, and logistics, you get the intelligence needed to stay ahead in automotive e-commerce. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the Cars list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## Actor input object example ```json { "urls": [ "https://www.carmax.com/cars/bmw" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # 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 = { "urls": [ "https://www.carmax.com/cars/bmw" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/carmax-cars-search-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 = { "urls": ["https://www.carmax.com/cars/bmw"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/carmax-cars-search-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 '{ "urls": [ "https://www.carmax.com/cars/bmw" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/carmax-cars-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/carmax-cars-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Carmax Cars Search Scraper", "description": "Extract complete vehicle inventory from CarMax with 60+ fields per listing. Get pricing, specs, store info, features, and condition data — perfect for price monitoring, competitive analysis, and automotive market research.", "version": "0.0", "x-build-id": "LKdJWU6ppCZ6w4KNT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~carmax-cars-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-carmax-cars-search-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/stealth_mode~carmax-cars-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-carmax-cars-search-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/stealth_mode~carmax-cars-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-carmax-cars-search-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", "properties": { "urls": { "title": "URLs of the Cars list urls to scrape", "type": "array", "description": "Add the URLs of the Cars list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "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 } } } } } } } } } } ```