CarMax Scraper

Extract public used-vehicle inventory from CarMax search-result pages or individual vehicle URLs. The actor is designed for dealerships, automotive marketplaces, inventory analysts, lead researchers, and AI agents that need bounded vehicle records in a stable dataset shape.

What it extracts

Each vehicle record can include the canonical URL, stock number, VIN, year, make, model, price, mileage, location, body type, fuel type, transmission, color, public description, image URLs, and publicly displayed features. CarMax may omit fields on some pages; missing values are returned as null and non-fatal limitations are listed in warnings.

Input

Provide one or more absolute https://www.carmax.com URLs in startUrls. Search URLs such as https://www.carmax.com/cars are expanded across up to maxPages pages. Individual vehicle URLs such as https://www.carmax.com/car/12345678 can be supplied directly. maxResults caps the number of vehicle records. includeDetails defaults to true; turn it off when you only need discovered vehicle URLs. Use proxyConfiguration when a cloud IP is challenged.

Example:

{
  "startUrls": [{ "url": "https://www.carmax.com/cars" }],
  "maxResults": 25,
  "maxPages": 3,
  "includeDetails": true
}

Output

{
  "recordType": "vehicle",
  "url": "https://www.carmax.com/car/12345678",
  "stockNumber": "26123456",
  "vin": null,
  "year": 2022,
  "make": "Toyota",
  "model": "Camry SE",
  "price": 24998,
  "mileage": 32145,
  "location": "CarMax Austin North",
  "imageUrls": [],
  "features": [],
  "warnings": []
}

Pricing

The intended PPE configuration charges $0.01 per run plus $0.005 per vehicle record. A run with no discovered vehicles returns a diagnostic summary instead of silently pretending that inventory was extracted.

Reliability and limits

The crawler uses a real browser, bounded pagination, low concurrency, deduplication, selector fallbacks, and JSON-LD/visible-page parsing. It does not log in, bypass a CAPTCHA, or collect private customer information. CarMax inventory, pricing, and vehicle availability change frequently; use the source URL and scrapedAt timestamp for freshness.

Use the data in accordance with CarMax's terms, applicable law, and the rights of the website and vehicle owners. This actor is for publicly displayed inventory only.

Use cases

• Schedule repeatable collection and export results to downstream workflows.
• Run a one-off research job and export the structured result as JSON, CSV, Excel, XML, or RSS from Apify.
• Schedule the same input to monitor changes over time and send completed datasets to a webhook or integration.
• Feed schema-shaped records into a database, spreadsheet, BI tool, or AI workflow with the source URL retained for verification.

Run CarMax Scraper with the Apify API

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('muhammadafzal/carmax-scraper').call({
  "startUrls": [
    {
      "url": "https://www.carmax.com/cars"
    }
  ],
  "maxResults": 25,
  "maxPages": 3,
  "includeDetails": true,
  "proxyConfiguration": {}
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

You can also run the Actor from Apify Console, schedules, webhooks, the REST API, Make, Zapier, n8n, or the hosted Apify MCP server.

Responsible use

Use this Actor only for data you are authorized to access. Follow the target website's terms, robots and access policies, and applicable privacy, database, copyright, anti-spam, and data-protection laws. Do not use it to bypass authentication or other access controls, collect private data, harass people, or make high-impact decisions without independent verification.

Support

When reporting a problem, include the Actor run ID, a redacted input, the expected result, and a small public example URL when applicable. Do not post API tokens, cookies, credentials, or personal data in an issue.

Frequently asked questions

Can I schedule CarMax Scraper?

Yes. Use an Apify schedule to run the same saved input at a chosen interval, then connect a webhook or integration to process the dataset when the run finishes.

How should I test a new input?

Begin with the prefilled example or a small limit. Confirm that the output fields, source coverage, runtime, and live charges match your workflow before increasing the scope.

How do I export the results?

Open the run's default dataset in Apify Console and export JSON, CSV, Excel, XML, or RSS. Applications can retrieve the same records through the Apify API client or REST dataset endpoint.

Can an AI agent call this Actor?

Yes. Add muhammadafzal/carmax-scraper through the hosted Apify MCP server or call it through the API. The Actor's input and dataset schemas help agents construct valid requests and interpret returned records.