# AutoTempest Multi-Site Used Car Search Scraper (`crawlyth-forge/autotempest-multi-site-used-car-search-scraper`) Actor

Pull individual used-car listings aggregated by AutoTempest from Cars.com, Carvana, eBay Motors, TrueCar and dealer networks, filtered by make, model, year, price, ZIP radius and vehicle attributes.

- **URL**: https://apify.com/crawlyth-forge/autotempest-multi-site-used-car-search-scraper.md
- **Developed by:** [crawlyth forge](https://apify.com/crawlyth-forge) (community)
- **Categories:** Automation, Lead generation, E-commerce
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

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

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## AutoTempest Multi-Site Used Car Search Scraper

Scrape used-car listings aggregated by [AutoTempest.com](https://www.autotempest.com) — a search engine that pulls inventory from Cars.com, Carvana, eBay Motors, TrueCar, AutoWeb, CarGurus, Cars & Bids, Hemmings, PrivateAuto, and regional dealer networks into one results page. Filter by make, model, year, price, ZIP/radius, body style, drivetrain, fuel type, title status, doors, cylinders, and color. No login, no API key, no cookies required.

### What this actor does

- Searches AutoTempest's aggregated used-car inventory with the same filters available on the website
- Returns each individual listing with price, mileage, year/make/model/trim, location, posted date, source site, and a direct outbound link
- Automatically retries with a free datacenter proxy if the first attempt is blocked or empty
- Omits any field it cannot populate — no placeholder or fabricated values

### Output per listing

- `listingId`, `sitecode` — AutoTempest's internal listing/source identifiers
- `title` — full listing title as posted (e.g. `2023 Toyota Camry SE`)
- `year`, `make`, `model`, `trim` — parsed from the title
- `price` (USD), `mileage` (miles)
- `sourceSite` — human-readable source (`Cars.com`, `Carvana`, `eBay Motors`, `TrueCar`, `AutoWeb`, `CarGurus`, `Cars & Bids`, `Hemmings`, `PrivateAuto`, dealer network name, etc.)
- `city`, `distanceMiles` — listing location relative to your search ZIP (when the source publishes a physical location; nationwide-shipping sources like Carvana may omit distance)
- `dealerName` — when the seller is a dealership
- `postedDate` — AutoTempest's own relative/absolute date text (`Today`, `Jun 10th`, etc.)
- `description` — snippet of the listing's ad copy
- `thumbnailUrl` — listing photo
- `listingUrl` — outbound link to the source site or AutoTempest's own redirect page
- `searchZip`, `searchRadius` — the search parameters that produced this record
- `recordType: "carListing"`, `scrapedAt`

**Note on `listingUrl`:** most listings link directly to the source marketplace (`cars.com`, `carvana.com`, `ebay.com`, ...). A minority (AutoByTel/dealer-network listings) route through AutoTempest's own `/details/...` redirect page, which then forwards to the dealer. Both are valid, resolvable URLs.

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `make` | select | `toyota` | Vehicle manufacturer (64 makes) or blank for any |
| `makeCustom` | string | – | Free-text make override |
| `model` | string | – | Free-text model (e.g. `camry`, `f-150`) |
| `zip` | string | `10001` | 5-digit US ZIP to search around |
| `radius` | select | `50` | `25`/`50`/`100`/`300`/`500`/`1000` miles, `state`, `country`, or `any` |
| `minYear` / `maxYear` | integer | – | Model year range (1980-2027) |
| `minPrice` / `maxPrice` | integer | – | Price range (USD) |
| `minMileage` / `maxMileage` | integer | – | Mileage range (miles) |
| `postedWithinDays` | select | – | Only listings posted in the last 1/3/7/10 days, or any age |
| `keywords` | string | – | Free-text keyword search against listing title/description (e.g. `hybrid`, `one owner`) |
| `sort` | select | `best_match` | Best match, newest/oldest posted, nearest, year, price, mileage |
| `bodyStyles` | array | – | Convertible, coupe, hatchback, minivan, sedan, SUV, truck, van, wagon |
| `driveTypes` | array | – | 4WD, AWD, FWD, RWD |
| `fuelTypes` | array | – | Diesel, electric, flex, gas, hybrid, hydrogen, natural gas |
| `titleStatus` | array | – | Clean, branded, salvage, rebuilt, lemon |
| `cylinders` | array | – | 2-12, or not specified |
| `doors` | array | – | 2-3 doors, 4+ doors, or not specified |
| `exteriorColors` / `interiorColors` | array | – | Standard color palette |
| `transmission` | select | – | Automatic or manual, or blank for any |
| `saleType` | select | – | Auction or classified listings, or blank for any |
| `saleBy` | select | – | Dealer or private-party listings, or blank for any |
| `maxItems` | integer | `50` | Hard cap on emitted records (1-300) |
| `proxyConfiguration` | object | AUTO group | Only used as a fallback if the direct render is blocked |

#### Example: Toyota Camry near NYC, $10k-$30k, 2018-2023

```json
{
  "make": "toyota",
  "model": "camry",
  "zip": "10001",
  "radius": "50",
  "minYear": 2018,
  "maxYear": 2023,
  "minPrice": 10000,
  "maxPrice": 30000,
  "sort": "price_asc",
  "maxItems": 50
}
```

#### Example: Any AWD SUVs, hybrid or electric, clean title only

```json
{
  "zip": "90210",
  "radius": "100",
  "bodyStyles": ["suv"],
  "driveTypes": ["awd"],
  "fuelTypes": ["hybrid", "electric"],
  "titleStatus": ["clean"],
  "maxItems": 100
}
```

### Use cases

- **Car shopping** — compare listings across Cars.com, Carvana, eBay Motors, and dealer networks in one export
- **Market research** — track pricing and mileage distributions for a make/model in a region
- **Dealer intelligence** — monitor competing inventory near a specific ZIP code
- **Price-drop alerts** — run on a schedule and diff against previous results

### FAQ

**How many listings can I get per search?** AutoTempest renders a finite set of cards per page load (no infinite scroll/pagination on the base results page). Broad searches (popular make, no filters, 50mi radius) typically render 100-250 combined listings across all embedded sources; narrow searches return fewer. The actor delivers every listing it can render up to your `maxItems` cap — this is a genuine upstream ceiling, not an actor limitation.

**Which sources are included?** AutoTempest embeds listing data directly for Cars.com, Carvana, eBay Motors, TrueCar, CarGurus, AutoWeb, Cars & Bids, Hemmings, PrivateAuto, and several regional dealer networks. AutoTrader.com, Facebook Marketplace, and Craigslist appear on the AutoTempest website as "compare on this site" outbound links only (no listing data is embedded for them), so they are not included in the dataset.

**Do I need a proxy or login?** No. The actor renders the public search page directly. A free Apify datacenter proxy is used automatically only if a request gets blocked.

**Why do some listings lack `distanceMiles` or `dealerName`?** Nationwide-shipping sources (e.g. Carvana) don't always publish a fixed dealer location, so no distance-from-ZIP is available. Private-seller listings have no `dealerName`.

**Can I search without a ZIP code?** Yes — set `radius` to `any` and leave the location-specific filtering to your make/model/price criteria; AutoTempest will still default to a broad regional view.

# Actor input Schema

## `make` (type: `string`):

Vehicle manufacturer to search. Leave blank to search all makes.

## `makeCustom` (type: `string`):

Free-text make slug override, for makes not in the dropdown (e.g. a newly-added brand). Takes precedence over `make` if set.

## `model` (type: `string`):

Free-text model name (e.g. `camry`, `civic`, `f-150`). Depends on `make` being set.

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

5-digit US ZIP code to search around.

## `radius` (type: `string`):

Distance from the ZIP code to include listings from.

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

Drop listings older than this model year.

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

Drop listings newer than this model year.

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

Drop listings priced below this amount.

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

Drop listings priced above this amount.

## `minMileage` (type: `integer`):

Drop listings with fewer miles than this.

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

Drop listings with more miles than this.

## `postedWithinDays` (type: `string`):

Only include listings posted within this many days. Leave blank for any age.

## `keywords` (type: `string`):

Free-text keyword search applied to the listing title/description (e.g. `hybrid`, `low miles`, `one owner`). Leave blank to skip.

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

How AutoTempest orders results before scraping.

## `bodyStyles` (type: `array`):

Limit to one or more body styles. Leave empty for any.

## `driveTypes` (type: `array`):

Limit to one or more drivetrain types. Leave empty for any.

## `fuelTypes` (type: `array`):

Limit to one or more fuel types. Leave empty for any.

## `titleStatus` (type: `array`):

Limit to one or more title/condition statuses. Leave empty for any.

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

Limit to one or more cylinder counts. Leave empty for any.

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

Limit to 2-3 door or 4+ door vehicles. Leave empty for any.

## `exteriorColors` (type: `array`):

Limit to one or more exterior colors. Leave empty for any.

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

Limit to automatic or manual transmission listings. Leave blank for any.

## `saleType` (type: `string`):

Limit to auction listings or standard classified listings. Leave blank for any.

## `saleBy` (type: `string`):

Limit to dealer-sold or private-party listings. Leave blank for any.

## `interiorColors` (type: `array`):

Limit to one or more interior colors. Leave empty for any.

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

Hard cap on emitted records. AutoTempest renders a finite set of listings per search (typically 50-250 depending on inventory); the actor delivers every listing it can find up to this cap.

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

AutoTempest is not proxy-gated in normal operation. The actor renders without a proxy first, and only falls back to the free Apify AUTO datacenter proxy group if the first render is blocked or empty.

## Actor input object example

```json
{
  "make": "toyota",
  "zip": "10001",
  "radius": "50",
  "postedWithinDays": "",
  "sort": "best_match",
  "bodyStyles": [],
  "driveTypes": [],
  "fuelTypes": [],
  "titleStatus": [],
  "cylinders": [],
  "doors": [],
  "exteriorColors": [],
  "transmission": "",
  "saleType": "",
  "saleBy": "",
  "interiorColors": [],
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `listings` (type: `string`):

Dataset containing all scraped AutoTempest car listings.

# 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 = {
    "make": "toyota",
    "zip": "10001",
    "radius": "50",
    "postedWithinDays": "",
    "sort": "best_match",
    "bodyStyles": [],
    "driveTypes": [],
    "fuelTypes": [],
    "titleStatus": [],
    "cylinders": [],
    "doors": [],
    "exteriorColors": [],
    "transmission": "",
    "saleType": "",
    "saleBy": "",
    "interiorColors": [],
    "maxItems": 50,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlyth-forge/autotempest-multi-site-used-car-search-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 = {
    "make": "toyota",
    "zip": "10001",
    "radius": "50",
    "postedWithinDays": "",
    "sort": "best_match",
    "bodyStyles": [],
    "driveTypes": [],
    "fuelTypes": [],
    "titleStatus": [],
    "cylinders": [],
    "doors": [],
    "exteriorColors": [],
    "transmission": "",
    "saleType": "",
    "saleBy": "",
    "interiorColors": [],
    "maxItems": 50,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("crawlyth-forge/autotempest-multi-site-used-car-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "make": "toyota",
  "zip": "10001",
  "radius": "50",
  "postedWithinDays": "",
  "sort": "best_match",
  "bodyStyles": [],
  "driveTypes": [],
  "fuelTypes": [],
  "titleStatus": [],
  "cylinders": [],
  "doors": [],
  "exteriorColors": [],
  "transmission": "",
  "saleType": "",
  "saleBy": "",
  "interiorColors": [],
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call crawlyth-forge/autotempest-multi-site-used-car-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,crawlyth-forge/autotempest-multi-site-used-car-search-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/I9YmIsKEyGw5b0hhM/builds/AHZQHfaaSTPq0BsTL/openapi.json
