🚗 Car Listings Search

Search 10 major US car sites at once — one make/model, one run, one dataset.

Instead of running ten separate scrapers and stitching the results together yourself, this actor queries Hemmings, CarGurus, Bring a Trailer, Craigslist, Carfolio, Car and Driver, AutoTrader, TrueCar, Carvana, and CarsDirect in a single run and hands back every listing in one normalized shape — same field names, same structure, regardless of which site it came from. Ask for a used Ford F-150 and every site that has one gives you one; ask for a new one and it only bothers the sites that actually sell new cars.

✨ Why use this instead of ten separate scrapers

• 🔎 One search, ten sites — make/model/condition/price/year filters apply everywhere at once, so you get one clean comparison set instead of ten inconsistent ones.
• 🧠 Smart about new vs. used — asking for "new only" automatically skips sites that never carry new inventory, so you're not paying for or waiting on a search that can't return anything.
• ⚡ Built for speed — every site is queried at the same time, so the total run time is close to whichever single site is slowest, not the sum of all ten.
• 📄 Real depth, not just page 1 — a maxItemsPerSite of 500 actually goes and gets you up to 500 real listings per site, not just whatever happened to fit on the first screen.
• 🛡️ Built to survive anti-bot walls — the sites in this list are notoriously hard to scrape reliably. This actor handles that so you don't have to babysit failed runs.
• 💾 Skips repeat work — an identical search run recently is served instantly from cache instead of re-scraping everything.
• 🔔 Notifies you when it's done — optional Slack/Discord webhook, no extra credentials needed.
• 🖼️ Photos included — listing images are pulled through to the output wherever the site has one.
• 🧩 Resilient by design — one site failing or getting temporarily blocked never brings down the other nine; you still get everything the rest could find.

🌐 Individual site actors

Each site below also exists as its own standalone actor if you only need one source. This actor doesn't call or depend on them in any way — it's a fully separate implementation — but they're listed here in case a single-site actor is all you need.

Site	Actor
Bring a Trailer	bringatrailer-car-data-scraper-us
Hemmings	hemming-car-data-scraper-us
Craigslist	craigslist-only-car-data-scraper-us
CarGurus	cargurus-car-data-scraper-us
AutoTrader	autotrader-car-data-scraper-usa
TrueCar	truecar-car-data-scraper-us
Carvana	carvana-car-data-scraper-us
CarsDirect	cardirect-car-data-scraper-us
Car and Driver	caranddriver-car-data-scraper-us
Carfolio	carfolio-car-data-scraper-us

🗺️ Sites covered

Site	Inventory
hemming (Hemmings.com)	Used / classic
cargurus (CarGurus)	New & used
bringatrailer (Bring a Trailer)	Used (auction)
craigslist	Used (private)
carfolio	Reference specs, not for sale
caranddriver (Car and Driver)	New & used
autotraders (AutoTrader)	New & used
truecar (TrueCar)	Used
carvana	Used
cardirect (CarsDirect)	Used

One site failing or getting temporarily blocked never affects the others — every site is independently retried and fully isolated from the rest of the run.

⚙️ Input

Only make is required — everything else has a sensible default, grouped into sections so the input form stays simple unless you need to go further.

🔍 Search

Field	Type	Description
make	string	Required. e.g. "Ford".
model	string	Optional. e.g. "F-150". Leave blank to search all models of the make (where the site supports that).
condition	string	"any" (both) | "new" | "used". "New only" automatically skips sites that never have new inventory — see the table above — so you're not wasting a request on a site that would come back empty. "Used only" and "any" still query all 10, since every site has used stock.
yearMin / yearMax	integer	Optional year range, where supported.
priceMax	integer	Optional max price (USD), where supported.

🌍 Sites & result limits

Field	Type	Description
sites	array	Which sites to query — effectively a checklist of on/off switches, one per site. Defaults to just the fastest ones (hemming, cargurus, bringatrailer); turn on the rest here for fuller coverage if you don't mind the extra time.
maxItemsPerSite	integer	Stop each site once this many listings are collected. Default 5. Set to 0 for "no limit" — each site returns as much real inventory as it has for the query.

Every site is queried at the same time from the moment the run starts, so results come back roughly as fast as the quickest sites can deliver them, and the total run time doesn't stack up site by site.

⚡ Caching

Field	Type	Description
useCache	boolean	Default true. If an identical search (same make/model/filters/sites/limit) was already run before, instantly return those stored results instead of re-scraping every site again. Cached results never expire on their own — turn this off if a specific run needs to force a fresh scrape.

The cache persists across runs, keyed to the exact search (make/model/condition/year/price/sites/limit, case-insensitive). Change any of those and it's a cache miss — a fresh scrape — by design.

🔔 Notifications

Field	Type	Description
slackWebhookUrl	string	Optional. Posts a summary (result count per site, or errors) here when the run finishes. Create one under Slack → Apps → Incoming Webhooks.
discordWebhookUrl	string	Optional. Same summary, posted to a Discord channel. Create one under a channel's Integrations → Webhooks settings.

Both are plain webhook POSTs — no extra credentials needed from you beyond the URL itself, and a failed webhook post never fails the run.

🛡️ Proxy

Field	Type	Description
proxyConfiguration	object	Several of these sites are aggressive about blocking non-residential and non-US traffic. Defaults to a US-targeted residential proxy for the most reliable results.

📦 Output

One row per listing, normalized to the same shape regardless of source site — fields are ordered for how a shopper would actually scan a listing:

{
  "source": "cargurus",
  "url": "https://www.cargurus.com/details/445150934",
  "title": "2025 Ford F-150",
  "image": "https://static.cargurus.com/images/forsale/2026/07/23/07/19/2025_ford_f-150-pic-8007356962285664446-1024x768.jpeg",
  "make": "Ford",
  "model": "F-150",
  "price": 59000,
  "vin": "1FTFW5L82SKD91523",
  "location": "Randolph, OH",
  "sellerName": "Sarchione Ford",
  "sellerPhone": "(330) 594-8114",
  "currency": "USD",
  "trim": "Lariat SuperCrew 4WD",
  "year": 2025,
  "condition": "used",
  "mileage": 11797,
  "exteriorColor": "Iconic Silver Metallic",
  "listedAt": null
}

Not every field is available from every site — null means that particular site doesn't expose that field (or it wasn't available for that listing), not a scraping error. image is populated on every site except carfolio (only some listings there have a photo). sellerPhone is currently only exposed by cargurus and caranddriver — the rest either don't publish a phone number on the search page, or (Carvana, Bring a Trailer) aren't phone-based sales in the first place.

📝 Notes

• carfolio is a spec/reference database, not a for-sale marketplace — its rows never have price/mileage/VIN/condition/seller info, and it won't have every model (e.g. it has no F-150 listings at all despite covering Ford broadly).
• A residential proxy is strongly recommended (and defaulted on) — several of these sites are aggressive about blocking traffic that doesn't look like a real US visitor.

📬 Custom work / contact

Want a custom actor, a site added to this one, or anything tweaked for your use case? Reach out:

• 📧 Email: sajanbista1030@gmail.com
• 💼 LinkedIn: linkedin.com/in/sajan-bista