# Autotrader US – Car Listings, VINs & Dealer Data (`abotapi/autotrader-com-scraper`) Actor

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.

- **URL**: https://apify.com/abotapi/autotrader-com-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Categories:** E-commerce, Developer tools, Travel
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 listing results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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 US Car Scraper

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

### Why This Scraper

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

### Data You Get

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

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

### How to Use

Search by make and model near a ZIP code:

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

Search with filters:

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

Paste one or more Autotrader URLs:

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

Enrich every listing with the full detail page:

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

### Input Parameters

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| mode | string | search | "search" to use filters, "url" to paste links. |
| zip | string | 90012 | US ZIP code the search is centred on (search mode). |
| searchRadius | integer | 50 | Search radius in miles. |
| make | array | \["HONDA"] | Make codes, e.g. HONDA, TOYOTA. Empty for all. |
| model | array | | Model codes, e.g. CIVIC. Empty for all. |
| minYear / maxYear | integer | | Model year range. |
| minPrice / maxPrice | integer | | Price range in USD. |
| maxMileage | integer | | Maximum odometer reading. |
| condition | array | | New, Used, Certified, Third-Party Certified. |
| bodyStyle | array | | Sedan, SUV, Truck, Coupe, Convertible, Hatchback, Van, Wagon. |
| fuelType | array | | Gasoline, Hybrid, Electric, Diesel, Plug-in Hybrid, Hydrogen. |
| driveType | array | | AWD/4WD, Front Wheel Drive, Rear Wheel Drive. |
| transmission | array | | Automatic, Manual. |
| exteriorColor | array | | Simplified color, e.g. BLACK, WHITE, RED. |
| vehicleHistory | array | | Clean Title, No Accidents, No Frame Damage, Single Owner, Free Report. |
| dealType | array | | Good Price, Great Price. |
| sellerType | string | any | Any, Dealer, Private Seller. |
| sortBy | string | relevance | Relevance, price, mileage, year, distance, or newest. |
| urls | array | | Autotrader search or listing URLs (URL mode). |
| fetchDetails | boolean | false | Enrich each listing with the full detail page. |
| maxListings | integer | 20 | Maximum listings to return. 0 for unlimited. |
| maxPages | integer | 200 | Safety limit on pages per search. |
| proxy | object | Apify Residential (pool) | Connection configuration. |

### Output Example

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

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

### Send Results Into Your Apps (MCP Connectors)

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

### Plan Requirement

This actor needs an Apify Proxy plan that includes the Residential group (Starter plan or higher). Leave the proxy country unset — Autotrader returns the same US listings to any residential exit (the search is centred on the ZIP code you enter, not the visitor's location), so the actor rotates a US-centered residential pool for the widest selection of clean exits.

# Actor input Schema

## `mode` (type: `string`):

Choose 'search' to build a query from filters below, or 'url' to paste Autotrader search or listing links.

## `zip` (type: `string`):

US ZIP code the search is centred on. Required in search mode.

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

Distance from the ZIP code to search. Use a large value for a wider area.

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

Vehicle make codes, e.g. HONDA, TOYOTA, FORD. Leave empty for all makes.

## `model` (type: `array`):

Vehicle model codes, e.g. CIVIC, CAMRY. Leave empty for all models of the selected make(s).

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

Oldest model year to include.

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

Newest model year to include.

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

Lowest listing price to include.

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

Highest listing price to include.

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

Highest odometer reading to include.

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

New, Used, Certified, or Third-party certified. Leave empty for all.

## `bodyStyle` (type: `array`):

Filter by one or more body styles.

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

Filter by fuel type.

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

Filter by drivetrain.

## `transmission` (type: `array`):

Filter by transmission.

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

Filter by simplified exterior color, e.g. BLACK, WHITE, RED, BLUE, GRAY.

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

Restrict to vehicles matching history criteria.

## `dealType` (type: `array`):

Restrict to Good Price or Great Price listings (per the site's price rating).

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

Restrict to dealers or private sellers.

## `sortBy` (type: `string`):

Ordering of the results.

## `urls` (type: `array`):

Paste Autotrader search result pages or individual listing pages. Multiple URLs supported. In URL mode the filter fields above are ignored.

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

When on, each listing is enriched with the richer per-vehicle page (full options, extended specs, complete history). Adds an extra request per listing.

## `maxListings` (type: `integer`):

Maximum number of listings to return. This is the main cap. Set 0 for unlimited (stops at Max pages).

## `maxPages` (type: `integer`):

Safety limit on pages walked per search. Leave at the default; the run stops at Max listings.

## `proxy` (type: `object`):

Autotrader serves the same US listings to any residential exit (results are driven by the ZIP code, not the visitor's location). Leave the country unset so the actor can rotate across a US-centered residential pool for the most reliable, cost-effective results. Requires an Apify Proxy plan that includes the Residential group (Starter or higher).

## `mcpConnectors` (type: `array`):

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` (type: `string`):

URL or id of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors.

## `maxNotifyListings` (type: `integer`):

Cap on items written to each connector per run. Does not affect the dataset.

## Actor input object example

```json
{
  "mode": "search",
  "zip": "90012",
  "searchRadius": 50,
  "make": [
    "HONDA"
  ],
  "sellerType": "any",
  "sortBy": "relevance",
  "urls": [
    "https://www.autotrader.com/cars-for-sale/all-cars/honda/civic/los-angeles-ca"
  ],
  "fetchDetails": false,
  "maxListings": 20,
  "maxPages": 200,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "maxNotifyListings": 50
}
```

# Actor output Schema

## `overview` (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 = {
    "zip": "90012",
    "make": [
        "HONDA"
    ],
    "urls": [
        "https://www.autotrader.com/cars-for-sale/all-cars/honda/civic/los-angeles-ca"
    ],
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/autotrader-com-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 = {
    "zip": "90012",
    "make": ["HONDA"],
    "urls": ["https://www.autotrader.com/cars-for-sale/all-cars/honda/civic/los-angeles-ca"],
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/autotrader-com-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 '{
  "zip": "90012",
  "make": [
    "HONDA"
  ],
  "urls": [
    "https://www.autotrader.com/cars-for-sale/all-cars/honda/civic/los-angeles-ca"
  ],
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call abotapi/autotrader-com-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Autotrader US – Car Listings, VINs & Dealer Data",
        "description": "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.",
        "version": "1.0",
        "x-build-id": "JV01K8O6zfhqIsufT"
    },
    "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 or individual listing pages. Multiple URLs supported. In URL mode the filter fields above are ignored.",
                        "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": "Maximum number of listings to return. This is the main cap. Set 0 for unlimited (stops at Max pages).",
                        "default": 20
                    },
                    "maxPages": {
                        "title": "Max pages",
                        "minimum": 1,
                        "maximum": 200,
                        "type": "integer",
                        "description": "Safety limit on pages walked per search. Leave at the default; the run stops at Max listings.",
                        "default": 200
                    },
                    "proxy": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Autotrader serves the same US listings to any residential exit (results are driven by the ZIP code, not the visitor's location). Leave the country unset so the actor can rotate across a US-centered residential pool for the most reliable, cost-effective results. Requires an Apify Proxy plan that includes the Residential group (Starter or higher).",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    },
                    "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
                                    }
                                }
                            },
                            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
