Vehicle Listings Scraper for CarGurus

🚗 Vehicle Listings Scraper – Prices, Specs & Dealer Data

Extract structured vehicle listing data from public search-result pages, including prices, makes, models, mileage, locations, seller information, features, ratings and more. Select a country, ZIP/postcode, make and optional model or condition to build your dataset.

Trademark Disclaimer: This Actor is an independent tool and is not affiliated with, endorsed by, sponsored by, or otherwise associated with CarGurus or its subsidiaries. CarGurus and related trademarks are the property of their respective owners.

🌟 Why Choose This Actor?

🧭 Zero-URL workflow — No need to copy a search URL. Select a country, ZIP/postcode and make, and the Actor builds the request for you.

🛡️ Smart 3-tier connection strategy — Starts with a direct request, then automatically falls back to datacenter proxy → residential proxy with 3 retries if the target website pushes back. Once escalated, the Actor stays on the stronger tier.

🇺🇸🇨🇦🇬🇧 Multi-country support — Supports US, Canada and UK marketplaces with automatic currency tagging.

⚡ Real-time output — Each matching listing is pushed to the dataset as soon as it is parsed.

🛞🆕 Condition filter — Choose Used or New inventory.

🎯 Make + optional model filter — Filter results by vehicle make and optionally by model.

📦 80+ structured fields per listing — Capture pricing, deal rating, dealer phone, fuel economy, colors, drivetrain, fuel type, images and more.

🧠 Browser-fingerprinted HTTP — Uses Chrome TLS and HTTP/2 impersonation for HTTP requests.

🧭 VIN-based deduplication — Prevents duplicate vehicle records from being pushed to the dataset.

---

📥 Input

Field	Type	Required	Description
country	enum US / CA / UK	✅	Marketplace to query.
zipcode	string	✅	ZIP code or postcode used to anchor the search.
make	enum (44 brands)	✅	Vehicle brand.
model	string	Optional	Narrow results to a specific model. Case-insensitive.
condition	enum used / new	✅	Choose used or new inventory.
maxItems	integer	Optional	Maximum number of matching listings. 0 = no cap. Default: 50.
proxyConfiguration	object	Optional	Leave blank to use the automatic connection fallback strategy.

Example Input

📤 Output

Each dataset row represents a single vehicle listing.

Selected fields

Field	Type	Example
id	string	5TFBY5F12AX122219 (VIN)
sku	number	433980025
name	string	2010 Toyota Tundra Limited Double Cab 5.7L 4WD
url	string	Vehicle listing URL
price	string	17895
priceCurrency	string	USD
localizedTotalPrice	string	$17,895
brand	string	Toyota
model	string	Tundra
trimName	string	Limited Double Cab 5.7L 4WD
vehicleModelDate	integer	2010
mileage	integer	99050
unitMileage	object	{ value: 99050, unit: "MILES" }
color	string	Gray
vehicleInteriorColor	string	Gray
engine	string	381 hp 5.7L V8
vehicleTransmission	string	Automatic
driveWheelConfiguration	string	Four-Wheel Drive
fuelType	string	Gasoline
cityFuelEconomy	object	{ value: 13, unit: "MPG" }
highwayFuelEconomy	object	{ value: 17, unit: "MPG" }
dealRating	string	GREAT_PRICE
dealScore	number	0.761643
daysOnMarket	integer	164
pictureCount	integer	12
dealerName	string	Williston Economy Motors
sellerCity	string	South Burlington
sellerRegion	string	VT
sellerPostalCode	string	05403
phoneNumberString	string	(802) 255-8955
primaryImage	URL	Vehicle image URL
dealerLogoUrl	URL	Dealer logo URL
googleStaticMapUrl	URL	Dealer location map URL

Additional fields

inclusionType, listingSource, bodyType, bodyTypeGroupId, salesStatus, compliance, priceDropData, financeDto, evBatteryDto, stockNumber, ncapOverallSafetyRating, howToShop, buyingOption, sellerType, isFranchiseDealer, franchiseMake, distance, localizedFuelEconomy, description, expectedPrice, priceDifferential, imvPrice, feesCompliant, localizedDoors, normalizedExteriorColor, condition, availability, priceValidUntil, sortScore, debugInfo, offset, mpn and more.

🚀 How to Use

Apify Console

1. 🔐 Sign in to the Apify Console.

2. 🔍 Open Vehicle Listings Scraper – Prices, Specs & Dealer Data.

3. 🌍 Select a country and enter a ZIP/postcode.

4. 🚗 Select a vehicle make and optionally enter a model.

5. 🛞 Select Used or New.

6. 🎯 Set the maximum number of listings if required.

7. ▶️ Click Start.

8. 👀 Monitor matching listings in the Output tab.

9. 💾 Export results to JSON, CSV, XLSX or other supported formats.

🤖 Use via API

curl -X POST "https://api.apify.com/v2/acts/<ACTOR_ID>/run-sync-get-dataset-items?token=$APIFY_TOKEN" \

     -H "Content-Type: application/json" \

     -d '{

       "country": "US",

       "zipcode": "10001",

       "make": "Toyota",

       "condition": "used",

       "maxItems": 50

     }'

🎯 Best Use Cases

📊 Market-price benchmarking by make, model and region

🏬 Inventory monitoring for specific dealers

🚗 Lead generation for automotive businesses

📈 Deal-rating and days-on-market analysis

🌍 Cross-country vehicle pricing comparison

🤖 AI agents requiring fresh vehicle listing data

📦 Automotive market research and dataset creation

❓ Frequently Asked Questions

Q. Do I need a proxy?

No. The Actor starts without a proxy and automatically falls back to datacenter and residential proxies if the target website pushes back. Leave Proxy configuration as-is unless you have a specific reason to configure it manually.

Q. Why is the model field optional?

The make-level filter already narrows the result set. Leave the model field blank to collect listings across the selected make.

Q. Does it support new and used inventory?

Yes. Select Used for pre-owned inventory or New for new inventory. The output also includes an itemType field for further filtering.

Q. Why am I seeing fewer rows than maxItems?

The search may contain fewer unique listings than your requested maximum. The Actor continues pagination until the target is reached or no new VINs are returned.

To increase results, try a different ZIP/postcode, remove the model filter or select a more common make.

Q. Is this legal?

The Actor is designed to collect information that is publicly visible on vehicle search-result pages. You are responsible for ensuring that your use complies with applicable website terms, privacy laws, data-protection regulations and other applicable requirements.

🛟 Support and Feedback

Found a quirk or need a custom field?

Open an issue on the Actor page or contact: dev.scraperengine@gmail.com

⚖️ Legal / Cautions

• This Actor is an independent third-party tool.

• It is not affiliated with, endorsed by, sponsored by, or otherwise associated with CarGurus or its subsidiaries.

• CarGurus and related trademarks belong to their respective owners.

• Data is collected from publicly available vehicle search-result pages.

• Do not scrape private accounts or content behind authentication.

• The end user is responsible for compliance with applicable laws, regulations and website Terms of Service.

• Respect applicable rate limits and other technical restrictions.

⚠️ One more thing I would change

Your current README says:

🛞🆕 Condition filter — choose Used (incl. CPO + priority) or New.

and:

Used = pre-owned + CPO + priority listings.

I would remove "CPO + priority" from the marketing copy unless those are definitely the target site's own current categories. It's not necessary for the Legal issue, and simpler wording reduces unnecessary trademark/product terminology.

Most important changes before submitting

Item	Current	Fix
Actor name	❌ CarGurus Listings Scraper	✅ Vehicle Listings Scraper – Prices, Specs & Dealer Data
Actor logo	❌ CarGurus logo	✅ Keep removed
Description	🟡 Disclaimer present	✅ Keep stronger independent-tool disclaimer
README title	❌ CarGurus Listings Scraper	✅ Descriptive title
README disclaimer	🟡 Present only at end/description	✅ Put disclaimer near the top
Website references	🟡 Repeated	✅ Keep only where technically necessary
Trademark implication	🟡 Possible from branding	✅ Clearly state no affiliation/endorsement/sponsorship