Cars.com Scraper

Pull structured vehicle listings from cars.com at scale. Search by make, ZIP and radius, or paste any cars.com search or vehicle URL, and get a clean record per car with price, MSRP, estimated monthly payment, deal rating, price drop, mileage, VIN, the full photo set, and the dealer 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, fuel type, CARFAX flags and the dealer phone number.

Why This Scraper?

• 90+ fields per vehicle, including deal rating, price-vs-market explanation, price drop, monthly payment estimate, and the full image gallery.
• Two ways in: build searches from makes, ZIP and filters, or paste search and vehicle URLs directly. Filter fields are ignored in URL mode so pasted links are used as-is.
• 11 sort orders (price, mileage, year, distance, best deal, newest) and price, year, mileage and stock-type filters.
• Optional detail enrichment adds interior color, transmission, fuel type, CARFAX one-owner / clean-title / no-accidents flags and the dealer phone number.
• One simple cap: set Max items and the run stops there once enough results are collected.
• Export results straight into Notion, Linear, Airtable or Apify via MCP connectors, without touching the dataset.

Data You Get

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

Field	Example
listingId	00000000-0000-0000-0000-000000000000
title	2024 Toyota Camry SE
year	2024
make	Toyota
model	Camry
trim	SE
price	24995
msrp	27500
monthlyPayment	$399
deal_rating	good-deal
deal_badge_text	Good Deal
price_drop	$500
mileage	12500
vin	0000000000000000
stockType	Used
cpoIndicator	true
exterior_color	Celestial Silver
fuelType	Gasoline
dealerName	Example Toyota
dealerRating	4.5
location	Los Angeles, CA (10 mi)
imageUrl	https://platform.cstatic-images.com/large/in/v2/example.jpg
imageCount	24
url	https://www.cars.com/vehicledetail/00000000-0000-0000-0000-000000000000/

Detail fields (when Fetch full details is on): interior_color, transmission, mpg_city, mpg_highway, carfax_1_owner, carfax_clean_title, carfax_no_accidents, dealer_phone.

How to Use

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
}

Input Parameters

Parameter	Type	Description
mode	string	search (build searches from makes + ZIP + filters) or url (use pasted URLs).
makes	array	Vehicle makes to search; each make is its own search. Empty = all makes.
models	array	Optional model names to narrow the search.
zip	string	US ZIP code to center the search on.
maximumDistance	integer	Search radius in miles around the ZIP.
stockType	string	all, used, new, or cpo (certified pre-owned).
priceMin	integer	Minimum price (USD).
priceMax	integer	Maximum price (USD).
yearMin	integer	Minimum model year.
yearMax	integer	Maximum model year.
mileageMax	integer	Maximum odometer reading.
sortBy	string	One of 11 sort orders (price, mileage, year, distance, best deal, newest).
urls	array	cars.com search or vehicle URLs (URL mode).
fetchDetails	boolean	Visit each vehicle page for interior color, transmission, CARFAX flags and dealer phone.
maxItems	integer	The single cap on the run. 0 = unlimited. Default 20.
maxPages	integer	Optional safety bound on pages per search. Empty = unlimited; the run stops at Max items.
proxy	object	Proxy configuration. Apify Residential, country US recommended.
maxResidentialMB	integer	Residential traffic budget in MB. Caps how much residential traffic a run may use; the run keeps working as long as cars.com still serves results. 0 = unlimited.
mcpConnectors	array	Optional MCP connectors to pipe results into (Notion, Linear, Airtable, Apify).
notionParentPageUrl	string	Notion parent page URL/id for the Notion connector.
maxNotifyListings	integer	Cap on items written to each connector per run.

Export to your apps (MCP connectors)

Optionally pipe each run's results into the tools you already use through Model Context Protocol (MCP) connectors. Authorize a connector under Apify, Settings, API & Integrations, then select it in mcpConnectors. Notion receives a rich page per vehicle (set notionParentPageUrl); Linear, Airtable and Apify get a best-effort write or digest. The MCP export never changes the dataset and never fails the run; maxNotifyListings caps how many items go to each connector.

Output Example

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

{
  "listingId": "00000000-0000-0000-0000-000000000000",
  "vin": "0000000000000000",
  "url": "https://www.cars.com/vehicledetail/00000000-0000-0000-0000-000000000000/",
  "title": "2024 Toyota Camry SE",
  "year": 2024,
  "make": "Toyota",
  "model": "Camry",
  "trim": "SE",
  "bodyStyle": "Sedan",
  "mileage": 12500,
  "drivetrain": "Front-wheel Drive",
  "fuelType": "Gasoline",
  "exterior_color": "Celestial Silver",
  "interior_color": "Black",
  "transmission": "8-Speed Automatic",
  "stockType": "Used",
  "cpoIndicator": true,
  "price": 24995,
  "msrp": 27500,
  "monthlyPayment": "$399",
  "price_drop": "$500",
  "deal_rating": "good-deal",
  "deal_badge_text": "Good Deal",
  "price_vs_market": "This vehicle is priced below the average market price for similar vehicles in the area.",
  "dealerName": "Example Toyota",
  "dealerRating": 4.5,
  "dealer_phone": "(000) 000-0000",
  "location": "Los Angeles, CA (10 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": "Good Deal", "variant": "good-deal", "description": "Priced below the average market price." }
  ],
  "scrapedAt": "2024-01-01T00:00:00+00:00"
}

Plan Requirement

cars.com serves US connections best, so this scraper is designed to run on Apify Residential proxy with country US (included on the Starter plan and higher). Datacenter and free-tier connections are commonly rejected and will return zero items. Set the proxy to Apify Residential, country US, for reliable results; if you run on datacenter, a free tier, or a non-US connection the run logs a warning before spending compute.

Reliability

• Built for resilient, unattended runs: transient errors are recovered automatically so a run keeps working without manual intervention.
• Residential traffic budget: set maxResidentialMB to cap residential spend. The run keeps returning results as long as cars.com still serves them, and will not silently drop to zero. 0 = unlimited.