Autotrader US - Cars, Prices, Dealers & VINs
Pricing
from $1.50 / 1,000 listing results
Scrape US car listings from Autotrader by make, model, ZIP, price, year, body style, filters, or listing URLs. Returns VIN, price, KBB deal rating, mileage, colors, MPG, drivetrain, dealer name, phone, location, history flags, photos, and 60+ fields.
You can access the Autotrader US - Cars, Prices, Dealers & VINs programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, youโll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "1.1", "x-build-id": "snnFu1q7Q66GIDJIu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~autotrader-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-autotrader-com-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/abotapi~autotrader-com-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-autotrader-com-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/abotapi~autotrader-com-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-autotrader-com-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Search mode", "enum": [ "search", "url" ], "type": "string", "description": "Choose 'search' to build a query from filters below, or 'url' to paste Autotrader search or listing links.", "default": "search" }, "zip": { "title": "ZIP code", "type": "string", "description": "US ZIP code the search is centred on. Required in search mode." }, "searchRadius": { "title": "Search radius (miles)", "minimum": 10, "maximum": 500, "type": "integer", "description": "Distance from the ZIP code to search. Use a large value for a wider area.", "default": 50 }, "make": { "title": "Make(s)", "type": "array", "description": "Vehicle make codes, e.g. HONDA, TOYOTA, FORD. Leave empty for all makes.", "items": { "type": "string" } }, "model": { "title": "Model(s)", "type": "array", "description": "Vehicle model codes, e.g. CIVIC, CAMRY. Leave empty for all models of the selected make(s).", "items": { "type": "string" } }, "minYear": { "title": "Minimum year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Oldest model year to include." }, "maxYear": { "title": "Maximum year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Newest model year to include." }, "minPrice": { "title": "Minimum price (USD)", "minimum": 0, "type": "integer", "description": "Lowest listing price to include." }, "maxPrice": { "title": "Maximum price (USD)", "minimum": 0, "type": "integer", "description": "Highest listing price to include." }, "maxMileage": { "title": "Maximum mileage", "minimum": 0, "type": "integer", "description": "Highest odometer reading to include." }, "condition": { "title": "Condition", "type": "array", "description": "New, Used, Certified, or Third-party certified. Leave empty for all.", "items": { "type": "string", "enum": [ "new", "used", "certified", "third-party-certified" ], "enumTitles": [ "New", "Used", "Manufacturer Certified", "Third-Party Certified" ] } }, "bodyStyle": { "title": "Body style", "type": "array", "description": "Filter by one or more body styles.", "items": { "type": "string", "enum": [ "sedan", "suv", "truck", "coupe", "convertible", "hatchback", "van", "wagon" ], "enumTitles": [ "Sedan", "SUV / Crossover", "Truck", "Coupe", "Convertible", "Hatchback", "Van / Minivan", "Wagon" ] } }, "fuelType": { "title": "Fuel type", "type": "array", "description": "Filter by fuel type.", "items": { "type": "string", "enum": [ "gasoline", "hybrid", "electric", "diesel", "plug-in-hybrid", "hydrogen" ], "enumTitles": [ "Gasoline", "Hybrid", "Electric", "Diesel", "Plug-in Hybrid", "Hydrogen" ] } }, "driveType": { "title": "Drivetrain", "type": "array", "description": "Filter by drivetrain.", "items": { "type": "string", "enum": [ "awd-4wd", "fwd", "rwd" ], "enumTitles": [ "AWD / 4WD", "Front Wheel Drive", "Rear Wheel Drive" ] } }, "transmission": { "title": "Transmission", "type": "array", "description": "Filter by transmission.", "items": { "type": "string", "enum": [ "automatic", "manual" ], "enumTitles": [ "Automatic", "Manual" ] } }, "exteriorColor": { "title": "Exterior color", "type": "array", "description": "Filter by simplified exterior color, e.g. BLACK, WHITE, RED, BLUE, GRAY.", "items": { "type": "string" } }, "vehicleHistory": { "title": "Vehicle history", "type": "array", "description": "Restrict to vehicles matching history criteria.", "items": { "type": "string", "enum": [ "clean-title", "no-accidents", "no-frame-damage", "single-owner", "free-report" ], "enumTitles": [ "Clean Title", "No Accidents", "No Frame Damage", "Single Owner", "Free Report" ] } }, "dealType": { "title": "Deal rating", "type": "array", "description": "Restrict to Good Price or Great Price listings (per the site's price rating).", "items": { "type": "string", "enum": [ "good-price", "great-price" ], "enumTitles": [ "Good Price", "Great Price" ] } }, "sellerType": { "title": "Seller type", "enum": [ "any", "dealer", "private" ], "type": "string", "description": "Restrict to dealers or private sellers.", "default": "any" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "price-asc", "price-desc", "mileage-asc", "year-desc", "year-asc", "distance-asc", "newest" ], "type": "string", "description": "Ordering of the results.", "default": "relevance" }, "urls": { "title": "Autotrader URLs", "type": "array", "description": "Paste Autotrader search result pages (SEO, query-form, paginated, filtered, used/new, make-only, body-style, mobile host), the listing JSON service URL, or individual vehicle pages. Dealer directory pages are skipped with a warning. Leaving this untouched in URL mode scrapes the example URLs. In URL mode the filter fields above are ignored.", "default": [ "https://www.autotrader.com/cars-for-sale/all-cars/honda/civic/los-angeles-ca", "https://www.autotrader.com/cars-for-sale/all-cars?zip=90012&makeCode=HONDA&channel=ATC&allListingType=all-cars", "https://www.autotrader.com/cars-for-sale/all-cars?zip=90012&makeCode=HONDA&firstRecord=25&channel=ATC", "https://www.autotrader.com/cars-for-sale/all-cars?zip=90012&makeCode=HONDA&modelCode=CIVIC&startYear=2018&maxPrice=20000&sortBy=derivedpriceASC", "https://www.autotrader.com/cars-for-sale/used-cars/honda/civic/los-angeles-ca", "https://www.autotrader.com/cars-for-sale/new-cars/toyota/camry/los-angeles-ca", "https://www.autotrader.com/cars-for-sale/all-cars/honda", "https://www.autotrader.com/cars-for-sale/all-cars/suv-crossover/los-angeles-ca", "https://www.autotrader.com/cars-for-sale/all-cars?zip=90012&sellerType=d&listingType=CERTIFIED&firstRecord=25", "https://www.autotrader.com/cars-for-sale/Honda/Civic/Los+Angeles+CA-90012", "https://m.autotrader.com/cars-for-sale/all-cars/honda/accord/los-angeles-ca", "https://www.autotrader.com/cars-for-sale/vehicle/790571046", "https://www.autotrader.com/cars-for-sale/vehicle/793391957?zip=90012", "https://www.autotrader.com/rest/lsc/listing?allListingType=all-cars&numRecords=25&firstRecord=0&channel=ATC&zip=10001&makeCode=FORD" ], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (alias of Autotrader URLs)", "type": "array", "description": "Alias of Autotrader URLs for compatibility with other Autotrader scrapers. Used when Autotrader URLs is empty or still the example list; when it holds URLs it selects URL mode. Items may be plain strings or {url} objects.", "items": { "type": "string" } }, "fetchDetails": { "title": "Fetch full detail per listing", "type": "boolean", "description": "When on, each listing is enriched with the richer per-vehicle page (full options, extended specs, complete history). Adds an extra request per listing.", "default": false }, "maxListings": { "title": "Max listings", "minimum": 0, "type": "integer", "description": "The sole soft cap on the run, applied across the whole run (not per page or per search). Default 20. Set 0 for unlimited.", "default": 20 }, "maxItems": { "title": "Max items (alias of Max listings)", "minimum": 0, "type": "integer", "description": "Alias of Max listings. Used only when Max listings is not set." }, "maxPages": { "title": "Max pages per search", "minimum": 0, "type": "integer", "description": "Safety bound on how many result pages to walk per search or URL. 0 (default) means unlimited โ the walk stops naturally once a page comes back empty or keeps repeating listings already collected, or sooner once Max listings is reached. Set a number only for an explicit page cap below that natural stop.", "default": 0 }, "endPage": { "title": "End page (alias of Max pages per search)", "minimum": 0, "type": "integer", "description": "Alias of Max pages per search. Used only when Max pages per search is not set." }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Autotrader serves the same US listings to any exit (results are driven by the ZIP code, not the visitor's location). Datacenter and Residential both work: pick Datacenter or Auto and the actor tries datacenter connections first, then falls back to residential; the default Residential group needs an Apify plan that includes it. Leave the country unset.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "sessionCookie": { "title": "Session cookie (optional, advanced)", "type": "string", "description": "Optional. Paste a full cookie header from a logged-in browser on autotrader.com (must include a cleared `_abck` plus `bm_sz`/`ak_bmsc`). When supplied, the run replays it over fast HTTP and skips the browser entirely โ far cheaper and more reliable. The cookie is short-lived (~15โ30 min); refresh it before each run. Leave blank to use the default browser mode." }, "resumeFromRunId": { "title": "Resume from a prior run", "type": "string", "description": "Optional. 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. Leave empty for a normal fresh run." }, "incrementalMode": { "title": "Incremental mode (only new and changed listings)", "type": "boolean", "description": "Remember what each scheduled run returned and label every listing NEW, UPDATED, UNCHANGED, REAPPEARED or EXPIRED. UNCHANGED listings are skipped (not saved, not charged) unless Emit unchanged is on. Off by default: output is identical to a normal run.", "default": false }, "stateKey": { "title": "State key (incremental mode only)", "type": "string", "description": "Optional name for the remembered baseline. Leave empty to key it automatically on your search or URLs and filters (changing Max listings never starts a new baseline). Use the same key across runs to share one baseline." }, "emitUnchanged": { "title": "Emit unchanged listings (incremental mode only)", "type": "boolean", "description": "Also save listings that did not change since the last run, labelled UNCHANGED. Default off.", "default": false }, "emitExpired": { "title": "Emit expired listings (incremental mode only)", "type": "boolean", "description": "Save a row labelled EXPIRED for listings seen in the baseline that the latest complete scan no longer returns. Skipped when the scan was cut short by Max listings, Max pages or a resume.", "default": true }, "ignoreFieldsForChanges": { "title": "Ignore fields when detecting changes (incremental mode only)", "type": "array", "description": "Output field names that must not count as a change, for example price or distanceFromSearch. They stay in the output.", "items": { "type": "string" } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API & Integrations, then select it here. Notion gets a rich page-per-item export; other connectors get a best-effort write. Leave empty to skip; never changes the dataset output. Supported: Notion, Linear, Airtable, Apify." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL or id of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Autotrader US - Cars, Prices, Dealers & VINs from the options below:
If youโd like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: