# Autotrader Scraper — US Car Listings, Prices & Dealers (`khadinakbar/autotrader-scraper`) Actor Scrape US Autotrader.com car listings by ZIP, make, model, and filters. Returns price, mileage, year, trim, VIN, specs, dealer contact, and photos, with optional per-vehicle detail enrichment. HTTP-only via residential proxy, MCP-ready for AI agents. - **URL**: https://apify.com/khadinakbar/autotrader-scraper.md - **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community) - **Categories:** E-commerce, Lead generation, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 vehicle scraped (search card)s This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Autotrader Scraper — US Car Listings, Prices, Specs & Dealers Scrape vehicle listings from **US Autotrader.com** by ZIP, make, model, and filters. Get structured price, mileage, year, trim, VIN, full specs, dealer contact, and photos — with optional per-vehicle **detail enrichment** (seller comments, full feature list, all images). Built HTTP-only over residential proxy and **MCP-ready** for AI agents. ### What you get - **Search by location + vehicle** — ZIP code + radius, make, model, condition (used / new / certified), price range, model-year range, and max mileage. - **Rich per-vehicle data** — price, KBB fair price, deal rating, mileage, year/make/model/trim, body style, engine, transmission, drivetrain, fuel type, MPG, color, doors, VIN. - **Dealer / seller info** — dealer name, phone, city, state, and a private-seller flag. - **Optional detail enrichment** — seller comments, the full features/options list, and every listing photo, pulled from each vehicle's detail page. - **Power-user mode** — paste ready-made Autotrader search URLs to use any filter the structured inputs don't expose. ### When to use it - Dealer & market price intelligence — track inventory, pricing, and days-on-lot in any US metro. - Lead generation — build lists of dealers and private sellers with contact info. - Automotive market research — model availability, price distribution, mileage trends by region. - Feeding an AI agent — single ZIP/make/model in, clean structured JSON out. This actor scrapes the **US** site (autotrader.com). It does not cover Autotrader UK or Canada. ### Output One dataset row per vehicle. Core fields: | Field | Type | Description | |---|---|---| | `listingId` | string | Autotrader listing ID | | `vin` | string | Vehicle Identification Number | | `title` | string | Full listing title | | `year` / `make` / `model` / `trim` | int / string | Vehicle identity | | `bodyStyle` | string | Sedan, SUV, Truck, … | | `condition` | string | USED / NEW / CERTIFIED | | `price` | int | Sale price (USD) | | `priceRating` | string | Deal rating: Great / Good / Fair | | `kbbFairPrice` | int | Kelley Blue Book fair price | | `mileage` | int | Odometer (miles) | | `exteriorColor` / `interiorColor` | string | Colors | | `engine` / `transmission` / `driveType` / `fuelType` | string | Powertrain | | `mpgCity` / `mpgHighway` | int | EPA fuel economy | | `doors` | int | Door count | | `daysOnSite` | int | Days listed on Autotrader | | `dealerName` / `dealerPhone` / `dealerCity` / `dealerState` | string | Seller info | | `privateSeller` | bool | Private-party flag | | `vdpUrl` | string | Listing detail page URL | | `primaryImage` / `imageCount` / `images` | string / int / array | Photos | | `sellerComments` | string | Seller description *(detail mode)* | | `features` | array | Features / options *(detail mode)* | | `detailScraped` | bool | Whether detail enrichment ran | | `rank` / `searchZip` / `scrapedAt` | int / string / ISO 8601 | Search context | #### Example record ```json { "listingId": "768905204", "vin": "1HGCV1F47NA086022", "year": 2022, "make": "Honda", "model": "Accord", "trim": "Sport Special Edition", "condition": "USED", "price": 24072, "priceRating": "Great", "kbbFairPrice": 25810, "mileage": 34479, "exteriorColor": "Still Night Pearl", "engine": "4-Cylinder Turbo", "transmission": "Continuously Variable Automatic", "fuelType": "Gasoline", "mpgCity": 29, "mpgHighway": 35, "dealerName": "Keyes Toyota", "dealerState": "CA", "vdpUrl": "https://www.autotrader.com/cars-for-sale/vehicle/768905204", "imageCount": 39, "detailScraped": true, "scrapedAt": "2026-06-24T11:25:06.781Z" } ```` ### Pricing (pay-per-event) | Event | Price | |---|---| | Actor start | $0.00005 | | Vehicle scraped (search card) | $0.004 | | Vehicle scraped + detail enriched | $0.009 | Detail enrichment (`enrichDetails: true`, the default) charges the higher rate because it loads each vehicle's detail page for seller comments, the full feature list, and all photos. Set `enrichDetails: false` for fast, cheaper search-card data. Pay-per-usage (compute + proxy) is also available — pick at run time. ### Input ```json { "zipCode": "90064", "make": "Honda", "model": "Accord", "condition": "Used", "searchRadius": 50, "minPrice": 10000, "maxPrice": 35000, "minYear": 2019, "maxMileage": 60000, "maxResults": 100, "enrichDetails": true } ``` - **`zipCode`** — 5-digit US ZIP to center the search (required unless you pass `searchUrls`). - **`make` / `model`** — single-word makes work directly (Honda, Toyota, Ford, BMW, Subaru…). For makes with non-obvious codes, use `searchUrls`. - **`condition`** — All / Used / New / Certified. - **`searchUrls`** — advanced: paste full Autotrader search-results URLs to use any filter; overrides the structured inputs. - **`maxResults`** — cap on total listings (each is billed). Autotrader limits deep pagination to ~1,000 per search. - **`enrichDetails`** — visit each vehicle's detail page for seller comments, full features, and all photos. ### Reliability Autotrader is protected by Akamai and **blocks datacenter IPs**, so this actor runs over **Apify Residential (US)** proxy by default — leave it as-is. Each request uses a consistent Chrome-TLS session warmed against the homepage; blocked sessions are rotated automatically (up to 8 attempts), so transient blocks don't fail your run. If a search legitimately has no matches, the run completes successfully with an empty dataset and a clear status message. ### MCP / AI agents This actor is MCP-ready. Exposed as `apify--autotrader-scraper`, it takes a narrow input (ZIP + make/model/filters) and returns flat, structured JSON — a clean tool call for Claude, ChatGPT, or any MCP client. ### FAQ **Does it cover Autotrader UK or Canada?** No — US autotrader.com only. **Can I get every listing for a search?** Up to Autotrader's own deep-pagination ceiling (~1,000 results per search). Narrow with filters to go deeper into a segment. **Why is detail mode more expensive?** It loads an extra page per vehicle (the detail page) for seller comments, the full feature list, and all photos. **How do I scrape a single vehicle?** Use a search that returns it, or paste a search URL. The detail page is also reachable at `https://www.autotrader.com/cars-for-sale/vehicle/{listingId}`. ### Legal This actor scrapes only **publicly available** listing data from Autotrader.com. Use it responsibly and in compliance with Autotrader's Terms of Service and all applicable laws (including data-protection regulations) in your jurisdiction. You are responsible for how you use the scraped data. This tool is intended for legitimate market research, price intelligence, and lead generation. Do not use it to send unsolicited communications in violation of applicable law. # Actor input Schema ## `zipCode` (type: `string`): US ZIP code to center the search on (e.g. '90064'). Autotrader is US-only. Combine with searchRadius to widen the area. Ignored when you provide searchUrls. NOT a city name — use a 5-digit ZIP. ## `make` (type: `string`): Vehicle make to filter by, e.g. 'Honda', 'Toyota', 'Ford', 'BMW'. Single-word makes work directly; for makes whose Autotrader code differs (e.g. 'Mercedes-Benz') paste a ready-made search URL into searchUrls instead. Leave empty to search all makes. NOT a model name. ## `model` (type: `string`): Vehicle model to filter by, e.g. 'Accord', 'Civic', 'F-150'. Requires make to be set. Leave empty to include all models of the chosen make. NOT a trim — trims are returned as data, not filtered here. ## `condition` (type: `string`): Filter by listing condition. 'All' includes used, new, and certified pre-owned. Use 'Certified' for CPO only. ## `searchRadius` (type: `integer`): Radius in miles around the ZIP code to include. Defaults to 25. Use a larger radius (e.g. 200) for rare vehicles, or 0 for that ZIP's local sellers only. ## `minPrice` (type: `integer`): Only return listings at or above this price in USD. Leave empty for no lower bound. ## `maxPrice` (type: `integer`): Only return listings at or below this price in USD. Leave empty for no upper bound. ## `minYear` (type: `integer`): Earliest model year to include (e.g. 2018). Leave empty for no lower bound. ## `maxYear` (type: `integer`): Latest model year to include (e.g. 2024). Leave empty for no upper bound. ## `maxMileage` (type: `integer`): Only return vehicles at or below this odometer reading in miles. Leave empty for no mileage cap. ## `searchUrls` (type: `array`): Optional. Paste one or more full Autotrader search-results URLs (e.g. 'https://www.autotrader.com/cars-for-sale/cars?zip=90064\&makeCodeList=HONDA'). When provided, these override the structured filters above — useful for filters not exposed here or for makes with non-obvious codes. ## `maxResults` (type: `integer`): Maximum number of listings to return across all pages of a search. Defaults to 100. Each result is billed, so set this to control cost. Autotrader limits deep pagination to roughly 1,000 results per search. ## `enrichDetails` (type: `boolean`): When true (default), each listing is enriched by visiting its vehicle detail page to add seller comments, the full features/options list, and all photos. Adds one extra page fetch per vehicle and is billed at the higher 'vehicle-detail-enriched' rate. Set false for fast, cheaper search-card data only. ## `proxyConfiguration` (type: `object`): Proxy settings. Autotrader is protected by Akamai and BLOCKS datacenter IPs — Apify Residential (US) is required and is the default. Do not switch to datacenter or the run will be blocked. ## Actor input object example ```json { "zipCode": "90064", "make": "Honda", "model": "Accord", "condition": "All", "searchRadius": 25, "minPrice": 10000, "maxPrice": 35000, "minYear": 2018, "maxYear": 2024, "maxMileage": 60000, "searchUrls": [ "https://www.autotrader.com/cars-for-sale/cars?zip=90064&makeCodeList=HONDA" ], "maxResults": 100, "enrichDetails": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `results` (type: `string`): Array of vehicle listings. One row per vehicle. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "zipCode": "90064", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("khadinakbar/autotrader-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "zipCode": "90064", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("khadinakbar/autotrader-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "zipCode": "90064", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call khadinakbar/autotrader-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=khadinakbar/autotrader-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Autotrader Scraper — US Car Listings, Prices & Dealers", "description": "Scrape US Autotrader.com car listings by ZIP, make, model, and filters. Returns price, mileage, year, trim, VIN, specs, dealer contact, and photos, with optional per-vehicle detail enrichment. HTTP-only via residential proxy, MCP-ready for AI agents.", "version": "0.2", "x-build-id": "CipiducJclYP0DXNg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~autotrader-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-autotrader-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/khadinakbar~autotrader-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-autotrader-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/khadinakbar~autotrader-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-autotrader-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", "properties": { "zipCode": { "title": "ZIP code", "type": "string", "description": "US ZIP code to center the search on (e.g. '90064'). Autotrader is US-only. Combine with searchRadius to widen the area. Ignored when you provide searchUrls. NOT a city name — use a 5-digit ZIP." }, "make": { "title": "Make", "type": "string", "description": "Vehicle make to filter by, e.g. 'Honda', 'Toyota', 'Ford', 'BMW'. Single-word makes work directly; for makes whose Autotrader code differs (e.g. 'Mercedes-Benz') paste a ready-made search URL into searchUrls instead. Leave empty to search all makes. NOT a model name." }, "model": { "title": "Model", "type": "string", "description": "Vehicle model to filter by, e.g. 'Accord', 'Civic', 'F-150'. Requires make to be set. Leave empty to include all models of the chosen make. NOT a trim — trims are returned as data, not filtered here." }, "condition": { "title": "Condition", "enum": [ "All", "Used", "New", "Certified" ], "type": "string", "description": "Filter by listing condition. 'All' includes used, new, and certified pre-owned. Use 'Certified' for CPO only.", "default": "All" }, "searchRadius": { "title": "Search radius (miles)", "type": "integer", "description": "Radius in miles around the ZIP code to include. Defaults to 25. Use a larger radius (e.g. 200) for rare vehicles, or 0 for that ZIP's local sellers only.", "default": 25 }, "minPrice": { "title": "Min price (USD)", "type": "integer", "description": "Only return listings at or above this price in USD. Leave empty for no lower bound." }, "maxPrice": { "title": "Max price (USD)", "type": "integer", "description": "Only return listings at or below this price in USD. Leave empty for no upper bound." }, "minYear": { "title": "Min model year", "type": "integer", "description": "Earliest model year to include (e.g. 2018). Leave empty for no lower bound." }, "maxYear": { "title": "Max model year", "type": "integer", "description": "Latest model year to include (e.g. 2024). Leave empty for no upper bound." }, "maxMileage": { "title": "Max mileage", "type": "integer", "description": "Only return vehicles at or below this odometer reading in miles. Leave empty for no mileage cap." }, "searchUrls": { "title": "Search URLs (advanced)", "type": "array", "description": "Optional. Paste one or more full Autotrader search-results URLs (e.g. 'https://www.autotrader.com/cars-for-sale/cars?zip=90064&makeCodeList=HONDA'). When provided, these override the structured filters above — useful for filters not exposed here or for makes with non-obvious codes.", "items": { "type": "string" } }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of listings to return across all pages of a search. Defaults to 100. Each result is billed, so set this to control cost. Autotrader limits deep pagination to roughly 1,000 results per search.", "default": 100 }, "enrichDetails": { "title": "Scrape full vehicle detail", "type": "boolean", "description": "When true (default), each listing is enriched by visiting its vehicle detail page to add seller comments, the full features/options list, and all photos. Adds one extra page fetch per vehicle and is billed at the higher 'vehicle-detail-enriched' rate. Set false for fast, cheaper search-card data only.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Autotrader is protected by Akamai and BLOCKS datacenter IPs — Apify Residential (US) is required and is the default. Do not switch to datacenter or the run will be blocked.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } }, "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 } } } } } } } } } } ```