# AutoTrader US Car Listings Scraper (`cryptosignals/autotrader-us-scraper`) Actor Scrape used, new and certified pre-owned car listings from AutoTrader.com — full vehicle and dealer details. $0.003/listing. - **URL**: https://apify.com/cryptosignals/autotrader-us-scraper.md - **Developed by:** [Web Data Labs](https://apify.com/cryptosignals) (community) - **Categories:** E-commerce, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 US Car Listings Scraper Extract used, new and certified pre-owned vehicle listings from AutoTrader.com — at scale, with full vehicle and dealer details, in clean structured JSON. ### The Problem If you're a car dealer doing competitive intelligence, a researcher tracking used-car prices, or building a price-comparison tool, AutoTrader is one of the largest US inventories — but there's no public API. Manually copying listings is slow. Browser extensions break. Hand-rolled scrapers get blocked. You end up spending more time fighting CAPTCHAs than analyzing data. This actor handles it for you. Give it a search query, a ZIP code and a result cap — get back a clean dataset of car listings with prices, mileage, VINs and dealer info. ### What You Get For every listing, the actor returns: | Field | Example | |-------|---------| | `listingUrl` | Direct link to the AutoTrader VDP | | `title` | "2019 Toyota Camry LE" | | `make`, `model`, `year` | "Toyota", "Camry", `2019` | | `price`, `mileage` | `18995`, `42150` | | `condition` | `"used"` / `"new"` / `"certified"` | | `vin` | 17-character VIN (used cars) | | `dealerName`, `dealerCity`, `dealerState` | Dealer info for follow-up | | `exteriorColor`, `interiorColor` | Color details | | `drivetrain`, `transmission`, `engine` | Drivetrain spec | ### Pricing — Pay Per Result **$0.003 per listing scraped.** You only pay for what's delivered. No subscription, no compute charges, no proxy fees on top. First 500 results free for new users to evaluate. ### Input ```json { "searchQuery": "Toyota Camry", "zipCode": "10001", "maxResults": 50, "condition": "used" } ```` | Field | Type | Default | Notes | |-------|------|---------|-------| | `searchQuery` | string | "Toyota Camry" | Make + model, or just model | | `zipCode` | string | "10001" | 5-digit US ZIP | | `maxResults` | integer | 50 | 1 to 500 | | `condition` | enum | "all" | `all` / `used` / `new` / `certified` | ### Output Each row in the dataset: ```json { "listingUrl": "https://www.autotrader.com/cars-for-sale/vehicledetails.xhtml?listingId=...", "title": "2019 Toyota Camry LE", "make": "Toyota", "model": "Camry", "year": 2019, "price": 18995, "mileage": 42150, "condition": "used", "vin": "4T1B11HK5KU234567", "dealerName": "Manhattan Toyota", "dealerCity": "New York", "dealerState": "NY", "exteriorColor": "Silver", "interiorColor": "Black", "drivetrain": "FWD", "transmission": "Automatic", "engine": "2.5L I4" } ``` ### Use Cases - **Price tracking** — monitor used-car prices for specific make/model/trim across markets - **Dealer inventory research** — see what competitors are listing - **Market analysis** — aggregate inventory across regions for valuation models - **Comparison tools** — power a Kelley-Blue-Book-style comparison site - **Lead generation** — find dealers with specific inventory for your B2B outreach ### How It Works 1. The actor accepts your search input (query + ZIP + condition + max). 2. Spins up a real browser session using residential proxies for clean access. 3. Paginates through AutoTrader search results in batches of 25. 4. Returns structured listing data — typed integers for `price`/`mileage`/`year`, normalized condition, parsed dealer address. 5. Charges $0.003 per listing actually delivered to your dataset. ### Notes - VIN coverage: ~95% on used vehicles. New vehicles often don't expose VINs publicly until purchase. - Color and drivetrain coverage varies by dealer — some listings omit these. - If AutoTrader temporarily rate-limits, the actor retries with backoff. If still blocked after 3 attempts on a page, it returns what it has and exits cleanly. ### Support Open an issue on the actor page if you need additional fields, alternative search filters (year range, price range, body style) or higher result caps. # Actor input Schema ## `searchQuery` (type: `string`): Make and/or model to search for, e.g. 'Toyota Camry' or 'Ford F-150' ## `zipCode` (type: `string`): 5-digit US ZIP code to search around ## `maxResults` (type: `integer`): Maximum number of listings to scrape (1-500) ## `condition` (type: `string`): Filter by vehicle condition ## Actor input object example ```json { "searchQuery": "Toyota Camry", "zipCode": "10001", "maxResults": 50, "condition": "all" } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("cryptosignals/autotrader-us-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 = {} # Run the Actor and wait for it to finish run = client.actor("cryptosignals/autotrader-us-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 '{}' | apify call cryptosignals/autotrader-us-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=cryptosignals/autotrader-us-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "AutoTrader US Car Listings Scraper", "description": "Scrape used, new and certified pre-owned car listings from AutoTrader.com — full vehicle and dealer details. $0.003/listing.", "version": "0.1", "x-build-id": "bep1oQj0EYRKjiAFX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cryptosignals~autotrader-us-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cryptosignals-autotrader-us-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/cryptosignals~autotrader-us-scraper/runs": { "post": { "operationId": "runs-sync-cryptosignals-autotrader-us-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/cryptosignals~autotrader-us-scraper/run-sync": { "post": { "operationId": "run-sync-cryptosignals-autotrader-us-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": [ "searchQuery", "zipCode" ], "properties": { "searchQuery": { "title": "Search query", "type": "string", "description": "Make and/or model to search for, e.g. 'Toyota Camry' or 'Ford F-150'", "default": "Toyota Camry" }, "zipCode": { "title": "ZIP code", "pattern": "^[0-9]{5}$", "type": "string", "description": "5-digit US ZIP code to search around", "default": "10001" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of listings to scrape (1-500)", "default": 50 }, "condition": { "title": "Condition", "enum": [ "all", "used", "new", "certified" ], "type": "string", "description": "Filter by vehicle condition", "default": "all" } } }, "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 } } } } } } } } } } ```