🚗 Carfax.com Scraper

Pull rich, structured vehicle data directly from Carfax.com — by URL, VIN, or location-based search filters. Returns dealer info, pricing, options, accident & service history, owner timeline, MPG, photos, and dozens of other fields per listing.

🌟 Why Choose This Actor?

• 🛡️ Anti-block by design — auto-falls-back from direct → datacenter proxy → residential proxy. Once residential kicks in, it stays sticky for the rest of the run.
• ⚡ Real-time output — every vehicle is pushed to the dataset the moment it lands. Crash mid-run? You still keep everything you scraped.
• 🧩 Bulk URL & VIN input — paste 1 or 10,000 URLs/VINs. Concurrent fetches under the hood.
• 🔎 Full search filter set — ZIP + radius, make/model, year range, price range, mileage, accidents, owners, certified-only, body styles, colors, drivetrain, fuel, transmission, popular options.
• 📊 Four pre-built dataset views — Overview, Dealer, History, Price — so the output table renders cleanly with the columns that matter.
• 🤖 Pay-Per-Event pricing — pay only for actor starts and successful results.

---

✨ Key Features

• 🌐 Bulk input: vehicle URLs and/or raw VINs
• 📍 Search by ZIP code with radius up to 3,000 mi
• 🏷️ Filter by make, model, year, price, mileage, condition
• 🛡️ One-owner / no-accident / personal-use / certified toggles
• 🎨 Filter by body style, exterior/interior colour, drivetrain, fuel, transmission, engine
• 💰 Dealer ratings, reviews, group, franchise partnerships
• 📜 Owner history, accident summary, service records timeline
• 🖼️ All listing photos (multiple resolutions)
• 🛞 Trim, sub-trim, cab type, bed length, drive type, MPG

---

📥 Input

Field	Type	Description
urls	array	🔗 Carfax vehicle URLs (bulk). Skips search when set.
VINs	array	🆔 Raw 17-char VINs (alternative to URLs).
zipcode	string	📍 US ZIP for search center.
type	enum	used or new.
sort	enum	BEST, PRICE_ASC, PRICE_DESC, MILEAGE_ASC, …
radius	enum	Search radius in miles.
maker, model	string	Make / model filter.
minYear, maxYear	integer	Year range.
priceOver, priceUnder	integer	Price range.
mileageMin, mileageMax	integer	Mileage range.
certified, noAccidents, oneOwner, personalUse, serviceRecords	boolean	Quality filters.
bodyStyles, valueBadges, exteriorColors, interiorColors, driveTypes, engines, fuelTypes, popularOptions	array	List filters.
transmission	enum	Automatic, Manual, Unspecified.
maxItems	integer	Cap on returned listings.
requestDelay	number	Optional soft delay between requests.
proxyConfiguration	object	🛡️ Default = no proxy. Actor auto-falls-back.

Example input

{
  "zipcode": "10001",
  "type": "used",
  "sort": "BEST",
  "radius": "50",
  "maker": "Honda",
  "model": "Civic",
  "minYear": 2018,
  "maxYear": 2024,
  "priceUnder": 25000,
  "oneOwner": true,
  "noAccidents": true,
  "maxItems": 100,
  "proxyConfiguration": { "useApifyProxy": false }
}

Or with explicit URLs:

{
  "urls": [
    { "url": "https://www.carfax.com/vehicle/1GTW7AFP5R1189896" },
    { "url": "https://www.carfax.com/vehicle/5N1AT3CB1RC734551" }
  ],
  "maxItems": 50
}

---

📤 Output

Every record is pushed to the dataset the moment it is scraped (live saving). Sample item:

{
  "url": "https://www.carfax.com/vehicle/1GTW7AFP5R1189896",
  "vin": "1GTW7AFP5R1189896",
  "title": "Used 2024 GMC Savana 2500",
  "mileage": "10,263 miles",
  "color": "White",
  "bodyType": "Van",
  "engine": "6 Cyl 4.3 L",
  "transmission": "Automatic",
  "currentPrice": 30800,
  "listPrice": 30800,
  "onePrice": 32860,
  "badge": "GREAT",
  "dealerName": "Atlantic Chevrolet",
  "dealerCity": "Bay Shore",
  "dealerState": "NY",
  "dealerPhone": "6317720769",
  "dealerAverageRating": 4.5,
  "oneOwner": true,
  "noAccidents": false,
  "serviceRecords": true,
  "ownerHistory": [{ "ownerNumber": 1, "purchaseDate": "05/24/24", "city": "Phoenix", "state": "AZ" }],
  "accidentHistory": ["Other damage reported"],
  "images": ["https://carfax-img.vast.com/.../1/344x258", "…"]
}

The dataset ships with four views so the Apify Console renders the output in clean tables:

• Overview — title, year, make/model, price, mileage, colors, dealer, image, link
• Dealer — address, phone, rating, reviews, group, franchise
• History — VIN, owner history, accidents, service records, use history
• Price — list/current/one price, monthly payment estimate, badges

---

🚀 How to Use (Apify Console)

1. Sign in at https://console.apify.com.
2. Open this actor and click Start.
3. Fill in either:
   • 🔗 a list of vehicle URLs/VINs, or
   • 📍 a ZIP + filters.
4. Leave proxy on default (no proxy) — the actor auto-escalates if Carfax pushes back.
5. Watch the live log — every vehicle is announced as it lands.
6. Open the Output tab and pick a view (Overview / Dealer / History / Price).
7. Export to JSON, CSV, or XLSX.

🤖 Use via API

curl -X POST "https://api.apify.com/v2/acts/<USER>~carfax-scraper/runs?token=$APIFY_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "zipcode": "10001",
       "maker": "Honda",
       "model": "Civic",
       "maxItems": 100
     }'

---

💎 Best Use Cases

• 🏷️ Price-monitoring across dealers in a region
• 🚙 Inventory analytics for car-buying tools and aggregators
• 📊 Market analysis (price/mileage/age curves by make-model-trim)
• 🛡️ Pre-purchase due-diligence — accident & owner history pull-through
• 📞 Sales enablement — dealer contact + review surface

---

💰 Pricing — Pay Per Event

This actor uses Pay-Per-Event billing. You pay only for two events:

Event	When	Charge
actor-start	Once per run	Small flat fee
result-item	Per vehicle saved	Per-item fee

Failed runs (no items) cost only the start fee. If you hit your spend cap the actor stops cleanly — it never errors out.

---

❓ Frequently Asked Questions

Why does the run start with no proxy? Because Carfax often serves clean responses without one. The actor only escalates to a proxy when it sees a real block, saving you both time and proxy credits.

What happens if my proxy choice keeps getting blocked? After 3 failed retries on residential, the actor logs the failure and stops cleanly. The dataset still contains everything it already saved.

Can I scrape Carfax-Canada / Carfax-UK? Today, US Carfax only. Open an issue if you need another region.

Why is the output table empty in the Console? Switch to the Overview, Dealer, History, or Price view — those are pre-built. The default empty view will fill in as soon as the first item is pushed.

How do I extract VINs from URLs? Done automatically — paste full vehicle URLs and the actor pulls the VIN out of the path.

---

⚖️ Cautions / Legal

• Data is collected only from publicly accessible Carfax pages.
• The end user is responsible for compliance with Carfax's terms of service and applicable laws (GDPR, CCPA, anti-spam, etc.).
• The actor honours reasonable rate limits and uses random jitter between requests.

---

📨 Support & Feedback

Found a bug or want a new field? Open an issue on this actor's page — feedback is read and answered.