# Autotrader.com Vehicle Scraper + Instant Results (`raidr-api/autotrader-us-scraper`) Actor

Scrape Autotrader.com (USA) vehicles by make, model, year, price, and mileage. Features exact listing dates, smart age filtering, and deduplication. Optimized for lowest cost per run using advanced extraction techniques. Get instant vehicle results with filtering for private listings only.

- **URL**: https://apify.com/raidr-api/autotrader-us-scraper.md
- **Developed by:** [Raidr API](https://apify.com/raidr-api) (community)
- **Categories:** E-commerce, Automation, Lead generation
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.99 / 1,000 dataset results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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 Vehicle Scraper

Scrape new and used vehicle listings from [AutoTrader.com](https://www.autotrader.com) by ZIP code, with rich filtering by make, price, year, mileage, body style, fuel, drivetrain, color, deal rating, seller type, and more. Export clean, structured car data to JSON, CSV, Excel, or HTML — or send it straight to your own tools.

### 🔍 What does AutoTrader Vehicle Scraper do?

**AutoTrader Vehicle Scraper** extracts **public vehicle listings** from AutoTrader.com and turns them into clean, ready-to-use data. Every field — VIN, price, mileage, specs, dealer, and photos — comes back structured and typed, so you can analyze inventory in seconds instead of clicking through pages. Run it on the **Apify platform** for API access, scheduling, integrations, proxy rotation, and monitoring.

- **Track inventory** — monitor what's for sale across any metro and price band
- **Analyze pricing** — compare asking prices by make, model, year, and deal rating
- **Source deals** — find well-priced vehicles worth buying or reselling
- **Generate dealer leads** — build lists of dealers and their inventory for permitted outreach
- **Feed your tools** — export to spreadsheets, dashboards, CRMs, or analytics pipelines

### 📊 What data can you extract from AutoTrader?

Every listing returns clean, structured fields:

| 🚗 Title | 🏭 Make / model / trim | 📅 Year |
|---|---|---|
| 🔖 VIN | 💰 Price | 🛣️ Mileage |
| 🎨 Exterior color | 🚙 Body style | ⛽ Fuel type |
| ⚙️ Transmission | 🛞 Drivetrain | 🏷️ Condition |
| 🏆 Deal rating | 🧑‍💼 Dealer name & location | ☎️ Dealer phone |
| 📸 Photos | 🔗 Listing URL | 🕒 Scraped timestamp |

Enable **Fetch Full Details** to also collect the seller description, full feature list, warranties, stock number, dealer rating, and the complete image set.

### 🚀 How to scrape AutoTrader vehicles

No coding required.

1. **Create a free Apify account** using your email.
2. **Open AutoTrader Vehicle Scraper.**
3. **Enter a ZIP code** and a search radius (use 0 for a nationwide search).
4. **Add filters** (optional) — makes, price, year, mileage, condition, body style, fuel, drivetrain, cylinders, doors, colors, deal rating, vehicle history, at-home services, or seller type.
5. **Set Maximum Results** and click **Start**.
6. **Download your data** in JSON, CSV, Excel, or HTML — or pull it via API.

### ⬇️ Input

Set everything visually in the input form, or paste JSON directly:

```json
{
    "zipcode": "77002",
    "searchRadius": 50,
    "make": ["BMW", "Audi"],
    "minPrice": 15000,
    "maxPrice": 60000,
    "minYear": 2020,
    "maxYear": 2024,
    "maxMileage": 60000,
    "condition": ["used", "certified"],
    "bodyType": ["suv"],
    "fuelType": ["gasoline", "hybrid"],
    "driveType": ["awd"],
    "dealRating": ["great", "good"],
    "sellerType": "dealer",
    "sort": "newest",
    "fetchDetails": false,
    "maxItems": 500
}
````

**Available filters:** ZIP code, search radius, make, price range, year range, maximum mileage, condition, body style, fuel type, drivetrain, engine cylinders, doors, exterior/interior color, deal rating, vehicle history, at-home services, transmission, seller type, and sort order. Leave any field empty to skip that filter.

### ⬆️ Output

Each vehicle is saved as a structured record, ready to download in JSON, CSV, Excel, or HTML:

```json
{
    "id": 784139204,
    "vin": "5UX33EU01R9U25987",
    "url": "https://www.autotrader.com/cars-for-sale/vehicle/784139204",
    "title": "Used 2024 BMW X5 M60i",
    "year": 2024,
    "make": "BMW",
    "model": "X5",
    "trim": "M60i",
    "price": 73000,
    "priceFormatted": "$73,000",
    "mileage": 17089,
    "exteriorColor": "Black Sapphire Metallic",
    "bodyStyle": "Sport Utility",
    "fuelType": "Gasoline",
    "transmission": "8-Speed Automatic",
    "driveType": "All Wheel Drive",
    "condition": "USED",
    "dealHint": "Good",
    "dealerName": "Grubbs Volvo Cars Central Houston",
    "dealerCity": "Houston",
    "dealerState": "TX",
    "dealerPhone": "3469714079",
    "imageUrls": ["https://images.autotrader.com/hn/c/..."],
    "scrapedAt": "2026-07-01T00:00:00.000Z"
}
```

### 💰 How much does it cost to scrape AutoTrader?

AutoTrader Vehicle Scraper runs on Apify's **pay-per-use** model — you only pay for the resources a run consumes. Search-only runs are inexpensive; enabling **Fetch Full Details** collects a lot more per vehicle and costs more, so keep **Maximum Results** modest when it's on. Use filters to bound each run.

**Free tier:** New Apify users get monthly free credits — enough to scrape thousands of listings at no cost.

### ✨ Tips for best results

- **Get more than one search normally shows.** A single AutoTrader search only surfaces a limited number of results — this scraper automatically pulls far beyond that limit for complete metro coverage. Set a high **Maximum Results** and let it run.
- **Use residential proxies in production** (selected by default) for reliable, uninterrupted access.
- **Start small.** Run with a low result cap first to confirm your filters, then scale up.
- **Enable Fetch Full Details selectively** — only when you need descriptions, full features, warranties, or the complete image set.
- Only organic listings are returned; sponsored/spotlight placements are excluded.

### 🔗 Integrations

Connect AutoTrader Vehicle Scraper to your favorite tools:

- **Google Sheets** — auto-export new listings to a spreadsheet
- **Zapier & Make** — trigger workflows when new vehicles are found
- **Slack** — get results in your team channels
- **Webhooks** — send data to any URL when a run finishes
- **API** — integrate directly with your own applications

### 🛠️ Using the API

Run the scraper and pull results programmatically with the Apify API:

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run_input = {
    "zipcode": "77002",
    "make": ["BMW"],
    "maxPrice": 60000,
    "maxItems": 100
}

run = client.actor("your-username/autotrader-vehicle-scraper").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["title"], item["priceFormatted"])
```

### ❓ FAQ

#### How does AutoTrader Vehicle Scraper work?

It works just like searching AutoTrader yourself — it opens the results for your ZIP code and filters, then collects the publicly visible details from each listing, only far faster and at scale.

#### Can I scrape a whole city's inventory?

Yes. A single AutoTrader search caps how many results it shows, but this scraper automatically pulls far more for complete coverage. Set a high **Maximum Results** or narrow with filters.

#### Can I scrape multiple locations?

Each run centers on one ZIP code and radius. To cover several areas, run the scraper multiple times with different ZIP codes, or schedule automated runs for each.

#### Why should I use residential proxies?

Residential proxies (on by default) give the most reliable access to AutoTrader. No extra setup is needed.

#### Is it legal to scrape AutoTrader?

Scraping publicly available data is generally legal. This scraper only collects publicly visible listing information — no private user data or content behind access controls. Always use scraped data responsibly and in line with applicable laws and AutoTrader's Terms of Service.

### 📞 Support and feedback

- **Questions or a bug?** Open an issue on the Actor's **Issues** tab.
- **Need a field added or a custom solution?** Let us know — we'd love to help.

***

*AutoTrader Vehicle Scraper is not affiliated with or endorsed by AutoTrader. Use responsibly and in accordance with AutoTrader's Terms of Service.*

# Actor input Schema

## `zipcode` (type: `string`):

ZIP code used as the center point for the search.

## `searchRadius` (type: `integer`):

Distance around the ZIP code, in miles. Use 0 for a nationwide search.

## `maxItems` (type: `integer`):

Maximum number of unique listings to save. Note: AutoTrader caps a single search at ~400 records — pulls above that are automatically sliced by make/price/year for coverage.

## `sort` (type: `string`):

Ordering for results (applies within each slice when a large pull is sliced).

## `fetchDetails` (type: `boolean`):

Also open each listing's detail page to add the seller description, full feature list, warranties, stock number, dealer rating, and the complete image set. Slower and uses more proxy bandwidth (one extra ~0.5 MB page per listing).

## `make` (type: `array`):

Filter by one or more makes. Leave empty to include all makes.

## `minPrice` (type: `integer`):

Minimum price in USD. Leave empty for no minimum.

## `maxPrice` (type: `integer`):

Maximum price in USD. Leave empty for no maximum.

## `minYear` (type: `integer`):

Minimum model year. Leave empty for no minimum.

## `maxYear` (type: `integer`):

Maximum model year. Leave empty for no maximum.

## `maxMileage` (type: `integer`):

Only include vehicles at or below this odometer reading. Leave empty for no limit.

## `condition` (type: `array`):

Filter by listing condition. Leave empty to include all.

## `bodyType` (type: `array`):

Filter by body style. Leave empty to include all.

## `fuelType` (type: `array`):

Filter by fuel type. Leave empty to include all.

## `driveType` (type: `array`):

Filter by drivetrain. Leave empty to include all.

## `cylinders` (type: `array`):

Filter by engine cylinder count. Leave empty to include all.

## `doors` (type: `array`):

Filter by number of doors. Leave empty to include all.

## `exteriorColor` (type: `array`):

Filter by exterior color. Leave empty to include all.

## `interiorColor` (type: `array`):

Filter by interior color. Leave empty to include all.

## `dealRating` (type: `array`):

Only include listings AutoTrader flags with these deal ratings. Leave empty to include all.

## `vehicleHistory` (type: `array`):

Filter by vehicle history attributes. Leave empty to include all.

## `homeServices` (type: `array`):

Filter by at-home buying services offered. Leave empty to include all.

## `transmission` (type: `string`):

Filter by transmission type.

## `sellerType` (type: `string`):

Filter by seller type.

## `proxyConfiguration` (type: `object`):

Proxy settings. Residential proxies are strongly recommended in production (AutoTrader is behind Akamai; datacenter IPs are usually challenged).

## Actor input object example

```json
{
  "zipcode": "90001",
  "searchRadius": 50,
  "maxItems": 500,
  "sort": "newest",
  "fetchDetails": false,
  "transmission": "",
  "sellerType": "",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `runStats` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("raidr-api/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("raidr-api/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 raidr-api/autotrader-us-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=raidr-api/autotrader-us-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Autotrader.com Vehicle Scraper + Instant Results",
        "description": "Scrape Autotrader.com (USA) vehicles by make, model, year, price, and mileage. Features exact listing dates, smart age filtering, and deduplication. Optimized for lowest cost per run using advanced extraction techniques. Get instant vehicle results with filtering for private listings only.",
        "version": "0.0",
        "x-build-id": "6zuykun6rlNqyQXPo"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/raidr-api~autotrader-us-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-raidr-api-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/raidr-api~autotrader-us-scraper/runs": {
            "post": {
                "operationId": "runs-sync-raidr-api-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/raidr-api~autotrader-us-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-raidr-api-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": [
                    "zipcode"
                ],
                "properties": {
                    "zipcode": {
                        "title": "📍 ZIP Code",
                        "type": "string",
                        "description": "ZIP code used as the center point for the search.",
                        "default": "90001"
                    },
                    "searchRadius": {
                        "title": "🗺️ Search Radius (miles)",
                        "minimum": 0,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Distance around the ZIP code, in miles. Use 0 for a nationwide search.",
                        "default": 50
                    },
                    "maxItems": {
                        "title": "📦 Maximum Results",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum number of unique listings to save. Note: AutoTrader caps a single search at ~400 records — pulls above that are automatically sliced by make/price/year for coverage.",
                        "default": 500
                    },
                    "sort": {
                        "title": "↕️ Sort Results By",
                        "enum": [
                            "newest",
                            "relevance"
                        ],
                        "type": "string",
                        "description": "Ordering for results (applies within each slice when a large pull is sliced).",
                        "default": "newest"
                    },
                    "fetchDetails": {
                        "title": "🔎 Fetch Full Details",
                        "type": "boolean",
                        "description": "Also open each listing's detail page to add the seller description, full feature list, warranties, stock number, dealer rating, and the complete image set. Slower and uses more proxy bandwidth (one extra ~0.5 MB page per listing).",
                        "default": false
                    },
                    "make": {
                        "title": "🚘 Makes",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Filter by one or more makes. Leave empty to include all makes.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "Acura",
                                "Alfa Romeo",
                                "Aston Martin",
                                "Audi",
                                "Bentley",
                                "BMW",
                                "Buick",
                                "Cadillac",
                                "Chevrolet",
                                "Chrysler",
                                "Dodge",
                                "Ferrari",
                                "Fiat",
                                "Ford",
                                "Genesis",
                                "GMC",
                                "Honda",
                                "Hummer",
                                "Hyundai",
                                "Infiniti",
                                "Jaguar",
                                "Jeep",
                                "Kia",
                                "Lamborghini",
                                "Land Rover",
                                "Lexus",
                                "Lincoln",
                                "Lotus",
                                "Lucid",
                                "Maserati",
                                "Mazda",
                                "McLaren",
                                "Mercedes-Benz",
                                "Mini",
                                "Mitsubishi",
                                "Nissan",
                                "Polestar",
                                "Porsche",
                                "Ram",
                                "Rivian",
                                "Rolls-Royce",
                                "Subaru",
                                "Tesla",
                                "Toyota",
                                "Volkswagen",
                                "Volvo"
                            ]
                        }
                    },
                    "minPrice": {
                        "title": "💵 Minimum Price",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Minimum price in USD. Leave empty for no minimum."
                    },
                    "maxPrice": {
                        "title": "💰 Maximum Price",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum price in USD. Leave empty for no maximum."
                    },
                    "minYear": {
                        "title": "📅 Minimum Year",
                        "minimum": 1900,
                        "type": "integer",
                        "description": "Minimum model year. Leave empty for no minimum."
                    },
                    "maxYear": {
                        "title": "📅 Maximum Year",
                        "minimum": 1900,
                        "type": "integer",
                        "description": "Maximum model year. Leave empty for no maximum."
                    },
                    "maxMileage": {
                        "title": "🧭 Maximum Mileage",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Only include vehicles at or below this odometer reading. Leave empty for no limit."
                    },
                    "condition": {
                        "title": "🏷️ Condition",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Filter by listing condition. Leave empty to include all.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "new",
                                "used",
                                "certified",
                                "third-party-certified"
                            ],
                            "enumTitles": [
                                "New",
                                "Used",
                                "Certified Pre-Owned",
                                "Third-Party Certified"
                            ]
                        }
                    },
                    "bodyType": {
                        "title": "🚙 Body Styles",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Filter by body style. Leave empty to include all.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "sedan",
                                "suv",
                                "truck",
                                "coupe",
                                "hatchback",
                                "wagon",
                                "van",
                                "convertible"
                            ],
                            "enumTitles": [
                                "Sedan",
                                "SUV / Crossover",
                                "Truck",
                                "Coupe",
                                "Hatchback",
                                "Wagon",
                                "Van / Minivan",
                                "Convertible"
                            ]
                        }
                    },
                    "fuelType": {
                        "title": "⛽ Fuel Types",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Filter by fuel type. Leave empty to include all.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "gasoline",
                                "diesel",
                                "electric",
                                "hybrid",
                                "plug-in-hybrid"
                            ],
                            "enumTitles": [
                                "Gasoline",
                                "Diesel",
                                "Electric",
                                "Hybrid",
                                "Plug-in Hybrid"
                            ]
                        }
                    },
                    "driveType": {
                        "title": "🛞 Drivetrains",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Filter by drivetrain. Leave empty to include all.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "awd",
                                "fwd",
                                "rwd"
                            ],
                            "enumTitles": [
                                "AWD / 4WD",
                                "Front-Wheel Drive",
                                "Rear-Wheel Drive"
                            ]
                        }
                    },
                    "cylinders": {
                        "title": "🔧 Engine Cylinders",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Filter by engine cylinder count. Leave empty to include all.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "3",
                                "4",
                                "5",
                                "6",
                                "8",
                                "10",
                                "12",
                                "16",
                                "rotary"
                            ],
                            "enumTitles": [
                                "3 Cylinder",
                                "4 Cylinder",
                                "5 Cylinder",
                                "6 Cylinder",
                                "8 Cylinder",
                                "10 Cylinder",
                                "12 Cylinder",
                                "16 Cylinder",
                                "Rotary"
                            ]
                        }
                    },
                    "doors": {
                        "title": "🚪 Doors",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Filter by number of doors. Leave empty to include all.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "2",
                                "3",
                                "4",
                                "5"
                            ],
                            "enumTitles": [
                                "2 Doors",
                                "3 Doors",
                                "4 Doors",
                                "5 Doors"
                            ]
                        }
                    },
                    "exteriorColor": {
                        "title": "🎨 Exterior Colors",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Filter by exterior color. Leave empty to include all.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "beige",
                                "black",
                                "blue",
                                "brown",
                                "burgundy",
                                "charcoal",
                                "gold",
                                "gray",
                                "green",
                                "off-white",
                                "orange",
                                "pink",
                                "purple",
                                "red",
                                "silver",
                                "tan",
                                "turquoise",
                                "white",
                                "yellow"
                            ],
                            "enumTitles": [
                                "Beige",
                                "Black",
                                "Blue",
                                "Brown",
                                "Burgundy",
                                "Charcoal",
                                "Gold",
                                "Gray",
                                "Green",
                                "Off White",
                                "Orange",
                                "Pink",
                                "Purple",
                                "Red",
                                "Silver",
                                "Tan",
                                "Turquoise",
                                "White",
                                "Yellow"
                            ]
                        }
                    },
                    "interiorColor": {
                        "title": "🪑 Interior Colors",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Filter by interior color. Leave empty to include all.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "beige",
                                "black",
                                "blue",
                                "brown",
                                "burgundy",
                                "charcoal",
                                "gold",
                                "gray",
                                "green",
                                "off-white",
                                "orange",
                                "pink",
                                "purple",
                                "red",
                                "silver",
                                "tan",
                                "turquoise",
                                "white",
                                "yellow"
                            ],
                            "enumTitles": [
                                "Beige",
                                "Black",
                                "Blue",
                                "Brown",
                                "Burgundy",
                                "Charcoal",
                                "Gold",
                                "Gray",
                                "Green",
                                "Off White",
                                "Orange",
                                "Pink",
                                "Purple",
                                "Red",
                                "Silver",
                                "Tan",
                                "Turquoise",
                                "White",
                                "Yellow"
                            ]
                        }
                    },
                    "dealRating": {
                        "title": "🏆 Deal Rating",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Only include listings AutoTrader flags with these deal ratings. Leave empty to include all.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "great",
                                "good"
                            ],
                            "enumTitles": [
                                "Great Price",
                                "Good Price"
                            ]
                        }
                    },
                    "vehicleHistory": {
                        "title": "📜 Vehicle History",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Filter by vehicle history attributes. Leave empty to include all.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "clean-title",
                                "no-accidents",
                                "no-frame-damage",
                                "one-owner",
                                "free-report"
                            ],
                            "enumTitles": [
                                "Clean Title",
                                "No Accidents",
                                "No Frame Damage",
                                "Single Owner",
                                "Free History Report"
                            ]
                        }
                    },
                    "homeServices": {
                        "title": "🏠 At-Home Services",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Filter by at-home buying services offered. Leave empty to include all.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "video-walkaround",
                                "home-test-drive",
                                "online-paperwork",
                                "home-delivery",
                                "buy-online"
                            ],
                            "enumTitles": [
                                "Video Walkaround",
                                "Test Drive at Home",
                                "Online Paperwork",
                                "Local Home Delivery",
                                "Buy Online"
                            ]
                        }
                    },
                    "transmission": {
                        "title": "⚙️ Transmission",
                        "enum": [
                            "",
                            "automatic",
                            "manual"
                        ],
                        "type": "string",
                        "description": "Filter by transmission type.",
                        "default": ""
                    },
                    "sellerType": {
                        "title": "🧑‍💼 Seller Type",
                        "enum": [
                            "",
                            "dealer",
                            "private"
                        ],
                        "type": "string",
                        "description": "Filter by seller type.",
                        "default": ""
                    },
                    "proxyConfiguration": {
                        "title": "🌐 Proxy Configuration",
                        "type": "object",
                        "description": "Proxy settings. Residential proxies are strongly recommended in production (AutoTrader is behind Akamai; datacenter IPs are usually challenged).",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
