Autotrader US Car Scraper

Extract car listings from Autotrader (autotrader.com), the large US vehicle marketplace. Search by make, model, ZIP code, price, year, body style, fuel type, drivetrain, color, seller type, and more, or paste Autotrader search and listing links directly. Every result comes back as clean, structured JSON with 60+ fields per vehicle, including full dealer contact details and the site's own price rating.

Why This Scraper

• 60+ fields per listing, a richer output than other Autotrader scrapers on the Store.
• Full dealer contact: name, phone, city, state, ZIP, and distance from your search.
• The site's price intelligence: deal rating (Great / Good), plus the KBB fair-purchase price range and how each listing compares.
• Vehicle history flags: no accidents, clean title, single owner, no frame or flood damage.
• Two ways to search: build a query from filters, or paste any Autotrader URL.
• Forward auto pagination that walks the whole result set by default (no artificial page cap), bounded only by the maxListings total cap so runs stay predictable.
• Optional detail enrichment for full options, extended specs, and complete history per vehicle.
• Optional export of results into Notion, Linear, Airtable, or Apify via MCP connectors.

Data You Get

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

Field	Example
id	000000001
vin	1XXXX00000X000000
year	2023
make	Sample Make
model	Sample Model
trim	Sample Trim
price	22000
dealIndicator	Great
kbbFairPurchasePrice	22500
mileage	30000
exteriorColor	White
interiorColor	Black
fuelType	Gasoline
transmission	Automatic
driveType	Front Wheel Drive
mpgCity	30
mpgHighway	38
sellerName	Sample Motors
sellerPhone	+10000000000
sellerCity	Sample City
sellerState	CA
vehicleHistory.noAccidentsReported	true
images	["https://images.autotrader.com/000000000.jpg"]
url	https://www.autotrader.com/cars-for-sale/vehicle/000000001

How to Use

Search by make and model near a ZIP code:

{
  "mode": "search",
  "zip": "90012",
  "make": ["HONDA"],
  "model": ["CIVIC"],
  "searchRadius": 50,
  "maxListings": 50
}

Search with filters:

{
  "mode": "search",
  "zip": "10001",
  "bodyStyle": ["suv"],
  "fuelType": ["hybrid"],
  "driveType": ["awd-4wd"],
  "minPrice": 20000,
  "maxPrice": 40000,
  "minYear": 2021,
  "sortBy": "price-asc",
  "maxListings": 100
}

Paste one or more Autotrader URLs:

{
  "mode": "url",
  "urls": [
    "https://www.autotrader.com/cars-for-sale/all-cars/honda/civic/los-angeles-ca",
    "https://www.autotrader.com/cars-for-sale/vehicle/000000001"
  ],
  "maxListings": 60
}

Enrich every listing with the full detail page:

{
  "mode": "search",
  "zip": "90012",
  "make": ["TOYOTA"],
  "fetchDetails": true,
  "maxListings": 25
}

Input Parameters

Parameter	Type	Default	Description
mode	string	search	"search" to use filters, "url" to paste links.
zip	string	90012	US ZIP code the search is centred on (search mode).
searchRadius	integer	50	Search radius in miles.
make	array	["HONDA"]	Make codes, e.g. HONDA, TOYOTA. Empty for all.
model	array		Model codes, e.g. CIVIC. Empty for all.
minYear / maxYear	integer		Model year range.
minPrice / maxPrice	integer		Price range in USD.
maxMileage	integer		Maximum odometer reading.
condition	array		New, Used, Certified, Third-Party Certified.
bodyStyle	array		Sedan, SUV, Truck, Coupe, Convertible, Hatchback, Van, Wagon.
fuelType	array		Gasoline, Hybrid, Electric, Diesel, Plug-in Hybrid, Hydrogen.
driveType	array		AWD/4WD, Front Wheel Drive, Rear Wheel Drive.
transmission	array		Automatic, Manual.
exteriorColor	array		Simplified color, e.g. BLACK, WHITE, RED.
vehicleHistory	array		Clean Title, No Accidents, No Frame Damage, Single Owner, Free Report.
dealType	array		Good Price, Great Price.
sellerType	string	any	Any, Dealer, Private Seller.
sortBy	string	relevance	Relevance, price, mileage, year, distance, or newest.
urls	array		Autotrader search or listing URLs (URL mode).
fetchDetails	boolean	false	Enrich each listing with the full detail page.
maxListings	integer	20	The sole soft cap on the run, applied across the whole run (not per page or per search). 0 means unlimited.
maxPages	integer	0	Safety bound on result pages walked per search or URL. 0 (default) means unlimited: the walk stops on its own once a page comes back empty or keeps repeating listings already collected, or sooner once maxListings is reached. Set a number only for an explicit page cap below that natural stop.
resumeFromRunId	string	none	Paste a previous run ID or dataset ID to continue a large walk-all pull: listings already saved by that run are loaded before scraping starts and skipped, so this run only appends new listings.
proxy	object	Apify Residential (pool)	Connection configuration.
sessionCookie	string	—	Optional, advanced, and no longer needed for speed — normal runs already fetch directly. Supply a browser cookie header for autotrader.com only if a run cannot retrieve results without one. The cookie is short-lived (about 15–60 minutes), so paste a fresh one shortly before the run. Leave blank for normal use.

By default maxPages is 0 (unlimited): a search or URL entry walks every result page until the storefront naturally runs out — an empty page, or a page that keeps repeating listings already collected — or until maxListings (the run's only soft cap, default 20, set 0 for unlimited) is reached, whichever comes first. Set maxPages to a number only when you want an explicit page cap below that natural stop.

For a very large walk-all pull, use resumeFromRunId in a follow-up run instead of starting over: paste the ID of a previous run (or its dataset) and this run loads the listings it already saved, skips them, and appends only new listings to a fresh dataset. Leave it empty for a normal run.

The actor also checkpoints its own progress internally, so if a run is interrupted by a platform migration it picks back up without re-saving (and re-charging for) listings it already wrote.

Using the optional session cookie (advanced)

Normal runs need no setup and already retrieve results directly — you do not need a cookie for speed. This option is a fallback for the rare case where a run reports that it could not retrieve results:

1. Open autotrader.com in Chrome and load any search (for example, trucks).
2. Open DevTools → Network, reload the page, right-click the top document request, and choose Copy → Copy as cURL.
3. Paste the whole command into a text editor and copy just the value after -b '...' (the cookie string) into the sessionCookie field.

The cookie expires after a short while, so grab a fresh one right before a run. Without it, the actor retrieves results on its own and only falls back to its slower built-in mode if that ever stops working.

Output Example

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

{
  "id": "000000001",
  "vin": "1XXXX00000X000000",
  "url": "https://www.autotrader.com/cars-for-sale/vehicle/000000001",
  "title": "Used 2023 Sample Make Sample Model",
  "year": 2023,
  "make": "Sample Make",
  "model": "Sample Model",
  "trim": "Sample Trim",
  "price": 22000,
  "displayPrice": 22000,
  "dealIndicator": "Great",
  "kbbFairPurchasePrice": 22500,
  "kbbPriceLow": 21000,
  "kbbPriceHigh": 23500,
  "mileage": 30000,
  "exteriorColor": "White",
  "interiorColor": "Black",
  "fuelType": "Gasoline",
  "transmission": "Automatic",
  "driveType": "Front Wheel Drive",
  "mpgCity": 30,
  "mpgHighway": 38,
  "sellerName": "Sample Motors",
  "sellerType": "dealer",
  "isPrivateSeller": false,
  "sellerPhone": "+10000000000",
  "sellerCity": "Sample City",
  "sellerState": "CA",
  "sellerZip": "00000",
  "vehicleHistory": {
    "noAccidentsReported": true,
    "noSalvageTitle": true,
    "singleOwner": true
  },
  "images": ["https://images.autotrader.com/000000000.jpg"],
  "dealer": {
    "name": "Sample Motors",
    "phone": { "value": "0000000000" },
    "location": { "address": { "city": "Sample City", "state": "CA", "zip": "00000" } }
  }
}

Send Results Into Your Apps (MCP Connectors)

Optionally pipe results into the apps you already use. Authorize a connector under Apify, Settings, Integrations, then select it in the input (for Notion, also set notionParentPageUrl). Each item is written as a condensed, human-readable summary (a title plus key fields), not the full JSON; the complete record always stays in the Apify dataset. Leave the connector field empty to skip; it never changes the dataset output.

Plan Requirement

This actor needs an Apify Proxy plan that includes the Residential group (Starter plan or higher). Leave the proxy country unset — Autotrader returns the same US listings to any residential exit (the search is centred on the ZIP code you enter, not the visitor's location), so the actor works through its own ordered pool of residential exits, starting with the ones the site currently accepts.