Cars.com Scraper: Prices, Deals, Mileage, VIN & Dealer Data

Cars.com Scraper turns cars.com into a clean vehicle data feed. Search by make, ZIP and radius, or paste any cars.com search or vehicle URL, and get a normalized record per car with price, MSRP, estimated monthly payment, deal rating, mileage, VIN, the primary photo, gallery thumbnails and photo count, and the dealer's name, rating and location. Two modes (search and URL), 11 sort orders, and price, year, mileage and stock-type filters. An optional detail pass adds interior color, transmission, the full equipment list, price history and the dealer phone number. Export to JSON, CSV or Excel, or pull results straight into your app through the API.

Why This Scraper?

• Two ways in. Build searches from makes, ZIP and filters, or paste cars.com search and vehicle URLs directly. Filter fields are ignored in URL mode, so pasted links are used exactly as given.
• 90+ fields per vehicle, including deal rating, price versus market explanation, price drop, monthly payment estimate and photo count.
• A normalized contract on every row. Price and currency, mileage and unit, dealer city, state and ZIP, ISO dates, and a NEW, USED or CERTIFIED condition, so you never parse a display string like "$2.6K" or "17,417 mi." yourself.
• Explicit detail status on every row. Every vehicle carries a detailLoaded / detailError pair, so you can tell an enriched row from a base row without guessing from null fields.
• Optional detail enrichment adds full specifications, the equipment list, seller type, price history with the original list price and days on market, ownership, title, accident and recall flags, and the dealer phone number.
• 11 sort orders and price, year, mileage and stock-type filters to narrow a search before you pay for results.
• Built for schedules. Incremental mode returns only new and changed listings on recurring runs, and a blocked connection is reported in the run's status message instead of looking like an empty search.

Use Cases

• Dealer and inventory monitoring: track price drops, days on market and deal ratings across your own or a competitor's stock.
• Car shopping and deal-finding tools: filter by price, year, mileage and stock type to power a search site or alert bot.
• Market and pricing research: build historical datasets of asking prices, MSRP and market-average deltas across makes, models and regions.
• Lead generation: collect dealer names, ratings, phone numbers and inventory details across a defined market.
• Vehicle history and condition analysis: pull ownership, accident and title flags alongside price and mileage for due diligence.

Data You Get

Sample shape: values are illustrative placeholders, not from a live listing.

Field	Example
listingId	00000000-0000-4000-8000-000000000001
vin	1FAKEVIN000000001
year / make / model / trim	2025 / Toyota / Crown / Limited
vehicleCondition	CERTIFIED (also NEW, USED)
priceAmount / priceCurrency	39298 / USD
msrpAmount	40985 (null when the seller does not publish one)
mileageValue / mileageUnit	17417 / mi
priceDropAmount	2692 (only on listings with a recent price drop)
dealDeltaAmount	-805 (negative means priced below the local market average; only on listings the site rates a great deal)
dealerName	Example Toyota of Springfield
dealerCity / dealerState / dealerZip	Irvine / CA / 92618
dealerDistanceMiles	10 (miles from your search ZIP; null in URL mode)
isShippable / shippingNote	false / null
imageUrl / imageCount	https://platform.cstatic-images.com/large/in/v2/example.jpg / 24
url	https://www.cars.com/vehicledetail/00000000-0000-4000-8000-000000000001/
detailLoaded / detailError	true / null
stockNumber	STK0001 (Fetch full details only)
daysOnMarket	10 (Fetch full details only)
scrapedAt	2026-09-13T12:00:00+00:00
changeType	NEW (Incremental mode only; also UPDATED, UNCHANGED, REAPPEARED, EXPIRED)

With Fetch full details on, each row also gets sellerType (DEALER or PRIVATE), dealer_phone, engine, transmission, interior_color, doors, cylinders, mpg_city and mpg_highway, features (the full published equipment list), priceHistory (one entry per published price change, oldest first), originalListPrice and priceBelowOriginalAmount, and vehicleHistory (oneOwner, cleanTitle, noAccidents, serviceRecords, openRecall, personalUseOnly, reportSource). These keys are present on every row and stay null when detail enrichment is off, so the row shape never changes between runs. cars.com does not publish per-vehicle coordinates, so this actor does not return a latitude and longitude pair either; use dealerZip, which is present on every row, to geocode instead.

How to Use

1. Pick a mode: search (build from makes, ZIP and filters) or url (paste cars.com search or vehicle links).
2. In search mode, set Makes, ZIP code and Search radius, then narrow with Stock type, price, year or mileage filters as needed. In url mode, paste one or more links; the filter fields are ignored.
3. Turn on Fetch full details if you need interior color, transmission, the equipment list, price history or the dealer phone number. It adds a small charge per vehicle.
4. Set Max items to control run size and cost, then click Start.

Search by make and ZIP:

{
  "mode": "search",
  "makes": ["toyota"],
  "zip": "90001",
  "maximumDistance": 50,
  "stockType": "used",
  "sortBy": "list_price",
  "maxItems": 50
}

Filter by price, year and mileage:

{
  "mode": "search",
  "makes": ["honda", "kia"],
  "zip": "10001",
  "priceMin": 15000,
  "priceMax": 28000,
  "yearMin": 2020,
  "mileageMax": 40000,
  "maxItems": 100
}

Paste cars.com URLs (filters ignored):

{
  "mode": "url",
  "urls": [
    "https://www.cars.com/shopping/results/?stock_type=used&makes[]=tesla&zip=94103&maximum_distance=100"
  ],
  "fetchDetails": true,
  "maxItems": 80
}

Recurring monitoring of the same search:

{
  "mode": "search",
  "makes": ["toyota"],
  "zip": "90001",
  "maximumDistance": 50,
  "incrementalMode": true,
  "maxItems": 500
}

Run it from your code

Python:

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("abotapi/cars-com-scraper").call(run_input={
    "mode": "search", "makes": ["toyota"], "zip": "90001", "maxItems": 50
})
for vehicle in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(vehicle["listingId"], vehicle["priceAmount"], vehicle["priceCurrency"], vehicle["mileageValue"])

JavaScript:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('abotapi/cars-com-scraper').call({ mode: 'search', makes: ['toyota'], zip: '90001', maxItems: 50 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Or connect it to Make, Zapier, n8n, Google Sheets or webhooks from the Integrations tab.

Resume and recurring updates

• Resume (resumeFromRunId) continues one interrupted run: paste its run or dataset ID and the actor skips every listing already collected there, so you do not pay twice.
• Incremental mode (incrementalMode) is for scheduled runs over the same search. The first run returns every listing as NEW. Later runs compare against the saved state: changed listings return UPDATED (with changedFields naming exactly what moved), and unchanged listings are suppressed and not billed unless emitUnchanged is on. EXPIRED is opt-in via emitExpired and is only produced once a run has scanned the tracked search all the way to the end, never when Max items or Max pages capped it, and never on a resumed run. REAPPEARED only happens to a listing a previous run already marked EXPIRED: if it is found again later, it comes back as REAPPEARED instead of NEW, keeping its original firstSeenAt. stateKey names or shares one monitoring campaign; leave it empty and the actor derives one from your search and filter settings. With Incremental mode off, output is exactly as before.

Send results into your apps (MCP connectors)

Optionally pipe each run's results into the apps you already use, via Model Context Protocol (MCP) connectors. This is an extra delivery step after the scrape; the Apify dataset is never changed, and a connector failure never fails the run.

What gets written to the connector: a condensed, human-readable summary of each vehicle, not the full JSON. Each item becomes one entry with a title and its key fields (price, mileage, VIN, body style, stock type, dealer, dealer rating, location, URL) flattened to plain text. The complete record always stays in the Apify dataset.

1. Authorize a connector once under Apify, Settings, API & Integrations (Notion, Linear, Airtable or Apify).
2. Select it in the mcpConnectors input field. Notion gets a rich page created per vehicle; other connectors get a best-effort write or digest.
3. For Notion, also set notionParentPageUrl to the page under which vehicle pages are created.

maxNotifyListings caps how many items are sent to each connector per run. Leave mcpConnectors empty to skip connector export entirely.

Input Parameters

Parameter	Type	Default	Description
mode	string	search	search (build from makes, ZIP and filters) or url (use pasted cars.com URLs).
makes	array	["tesla"]	Vehicle makes to search; each make is scraped as its own search. An empty array searches all makes.
models	array	none	Optional model names to narrow the search, applied across the selected makes.
zip	string	none (prefill: 90001)	US ZIP code to center the search on. Leave empty for a nationwide search.
maximumDistance	integer	50	Search radius in miles around the ZIP.
stockType	string	all	all, used, new, or cpo (certified pre-owned).
priceMin	integer	none	Minimum price (USD).
priceMax	integer	none	Maximum price (USD).
yearMin	integer	none	Minimum model year.
yearMax	integer	none	Maximum model year.
mileageMax	integer	none	Maximum odometer reading.
sortBy	string	best_match_desc	One of 11 sort orders (price, mileage, year, distance, best deal, newest).
urls	array	none (prefill: one sample search URL)	cars.com search or vehicle detail URLs (url mode). Filter fields above are ignored in this mode.
fetchDetails	boolean	false	Visit each vehicle page for interior color, transmission, fuel type, ownership/title/accident flags and the dealer phone number. Adds a small per-vehicle charge.
maxItems	integer	20	Stop after collecting this many vehicles, across all searches or URLs. 0 = unlimited.
maxPages	integer	none (an internal safety bound of 1000 applies if left empty)	Optional cap on result pages per search. If you set it, each search stops at this page count even before Max items is reached. Leave it empty to rely on Max items.
resumeFromRunId	string	none	Continue one specific previous run or dataset: listings already collected there are skipped. For recurring monitoring of the same search, use Incremental mode instead.
incrementalMode	boolean	false	Turn on for scheduled or recurring runs over the same search. See "Resume and recurring updates" above.
stateKey	string	none	Name a monitoring campaign to keep its state stable, or to deliberately share state across differently configured runs. Auto-derived from the search and filter settings when left empty.
emitUnchanged	boolean	false	Also return (and bill) listings unchanged since the last run, marked UNCHANGED.
emitExpired	boolean	false	Also return (and bill) listings from a previous run no longer found, marked EXPIRED, once a run has fully scanned the search.
proxy	object	Apify Residential, country US	Connection settings.
maxResidentialMB	integer	0	Residential traffic budget in MB. 0 = unlimited.
mcpConnectors	array	none	Optional MCP connectors to pipe results into (Notion, Linear, Airtable, Apify).
notionParentPageUrl	string	none	Notion parent page URL or id for the Notion connector.
maxNotifyListings	integer	50	Cap on items written to each connector per run.

Output Example

Sample shape: values are illustrative placeholders, not from a live listing.

{
  "listingId": "00000000-0000-4000-8000-000000000001",
  "vin": "1FAKEVIN000000001",
  "url": "https://www.cars.com/vehicledetail/00000000-0000-4000-8000-000000000001/",
  "title": "2025 Toyota Crown Limited",
  "year": 2025,
  "make": "Toyota",
  "model": "Crown",
  "trim": "Limited",
  "bodyStyle": "Sedan",
  "mileage": 17417,
  "drivetrain": "All-wheel Drive",
  "fuelType": "Hybrid",
  "exterior_color": "Heavy Metal",
  "interior_color": "Black",
  "transmission": "Automatic",
  "stockType": "Used",
  "cpoIndicator": true,
  "price": 39298,
  "msrp": 40985,
  "monthlyPayment": "$599",
  "price_drop": "$2.6K",
  "deal_rating": "great-deal",
  "deal_badge_text": "Great Deal",
  "price_vs_market": "This vehicle is priced $805 below the average market price of similar vehicles in the area at $40,103.",
  "dealerName": "Example Toyota of Springfield",
  "dealerRating": 4.5,
  "dealer_phone": "(000) 000-0000",
  "location": "Irvine, CA (38 mi)",
  "imageUrl": "https://platform.cstatic-images.com/large/in/v2/example.jpg",
  "imageCount": 24,
  "galleryImages": ["https://platform.cstatic-images.com/large/in/v2/example.jpg"],
  "carfax_1_owner": true,
  "carfax_clean_title": true,
  "carfax_no_accidents": true,
  "badges": [
    { "label": "Great Deal", "variant": "great-deal", "description": "Priced below the average market price." }
  ],
  "vehicleCondition": "CERTIFIED",
  "priceAmount": 39298,
  "priceCurrency": "USD",
  "msrpAmount": 40985,
  "monthlyPaymentAmount": 599,
  "priceDropAmount": 2692,
  "marketAverageAmount": 40103,
  "dealDeltaAmount": -805,
  "mileageValue": 17417,
  "mileageUnit": "mi",
  "dealerCity": "Irvine",
  "dealerState": "CA",
  "dealerZip": "92618",
  "dealerDistanceMiles": 38,
  "isShippable": false,
  "shippingNote": null,
  "sellerType": "DEALER",
  "stockNumber": "STK0001",
  "engine": "2.5L I-4 port/direct injection",
  "doors": 4,
  "cylinders": 4,
  "features": ["Apple CarPlay", "Backup Camera", "Heated Seats"],
  "listedAt": "2026-09-03",
  "daysOnMarket": 10,
  "originalListPrice": 40985,
  "priceBelowOriginalAmount": 1687,
  "priceHistory": [
    { "date": "2026-09-03", "event": "LISTED", "changeAmount": null, "price": 40985 },
    { "date": "2026-09-09", "event": "PRICE_INCREASE", "changeAmount": 1005, "price": 41990 },
    { "date": "2026-09-10", "event": "PRICE_DROP", "changeAmount": 2692, "price": 39298 }
  ],
  "vehicleHistory": {
    "oneOwner": true,
    "cleanTitle": true,
    "noAccidents": true,
    "serviceRecords": true,
    "openRecall": false,
    "personalUseOnly": true,
    "reportSource": "autocheck"
  },
  "detailLoaded": true,
  "detailError": null,
  "scrapedAt": "2026-09-13T12:00:00+00:00"
}

Plan Requirement

The default proxy setting (Apify Residential, country US) is what this actor is built around, and it is what reliable results require: cars.com commonly rejects non-residential and non-US connections, which can return zero items. If the connection this run selected is refused, the run steps down to another connection tier and warns you in the log, instead of failing silently. For consistently good coverage, keep Proxy set to Residential with country US, or check the Pricing tab for which plans include residential access. Use maxResidentialMB if you want to cap residential traffic spend on a large run.

FAQ

How much does it cost?

This actor uses Apify's pay-per-event pricing: a small run-start fee, a charge for each vehicle returned, and a smaller charge per vehicle only when Fetch full details is on. The Pricing tab shows the current rates. Use Max items to cap the cost of any run.

Is it legal to scrape cars.com?

This actor collects only publicly available vehicle listing data. You are responsible for how you use it: follow cars.com's terms and the laws that apply to you, and get legal advice if you plan commercial redistribution. Listing facts such as price, mileage and VIN are generally treated differently from photos and dealer branding, which may carry their own rights.

Can I get only new or changed listings on a schedule?

Yes. Schedule the actor from the Schedules tab and turn on Incremental mode. Each run then returns only new and changed listings by default, and unchanged ones are suppressed and not billed unless you turn on Emit unchanged.

What is the difference between Resume and Incremental mode?

Resume (resumeFromRunId) continues one specific interrupted run by its run or dataset ID, a one-time action. Incremental mode remembers a recurring search on its own and classifies every listing as NEW, UPDATED, UNCHANGED, REAPPEARED or EXPIRED against its own saved state on every scheduled run. Use Resume once, right after a run got cut off; use Incremental mode for ongoing monitoring of the same search.

Why did my run return no items?

If the connection is refused before any page can be read, the run ends early with a status message starting GEO_BLOCKED, so "no listings match your filters" is never confused with "the connection could not reach cars.com". Only the run-start fee is charged; no items are pushed. Check that Proxy is set to Residential with country US, then run it again in a few minutes.

Can I use it with AI agents or MCP?

Yes. Call it from any Apify integration or MCP client, and use the mcpConnectors field to push results into Notion, Linear or Airtable.

🔗 Want more car data?

Pair this actor with these related scrapers from the same team:

🚗 Autotrader US Scrape US car listings from Autotrader by make, model, ZIP, price, year, body style...	🚗 EasyAuto123 Scraper Scrape EasyAuto123 vehicle listings into clean structured data. Extract prices, VINs...
🚗 mobile.de From $0.8/1K. Scrape mobile.de vehicle listings with 30+ structured fields including...	🚗 Carsales.com.au Scraper Scrape structured vehicle listings from Carsales.com.au from $1 per 1K results. Built to...
🚗 Marktplaats.nl Scraper From $1/1K. Scrape Marktplaats.nl listings by keyword or URL. Extract title, price...	🚗 Turo Scraper Collect Turo vehicles by location and trip dates or listing URLs. Get make, model, year...

👉 Browse all abotapi scrapers

💬 Support & custom scrapers

• 🐞 Found a bug or a missing field? Open a ticket on the Issues tab. We usually reply within hours.
• 🛠️ Need another site, extra fields or a private build? Email abotapi@proton.me or message Telegram @abotapi.
• ⭐ Enjoying it? A quick review on the actor page helps other users find it.