# Bringatrailer Auctions Scraper (`stealth_mode/bringatrailer-auctions-scraper`) Actor

Extract detailed auction listings from BringaTrailer.com with complete bidding data, vehicle specifications, and seller information. Scrape 30+ fields per auction including current bids, watchers, geographic data, and status — perfect for market analysis and competitive intelligence.

- **URL**: https://apify.com/stealth\_mode/bringatrailer-auctions-scraper.md
- **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community)
- **Categories:** Automation, Developer tools, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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

## BringaTrailer Auctions Scraper: Collect Collector Car Data at Scale

---

### What Is BringaTrailer.com?

BringaTrailer.com is the premier online auction platform for collector vehicles, classic cars, and automotive enthusiasts worldwide. With thousands of active auctions at any given time, the platform generates real-time pricing data, market trends, and bidding behavior that are invaluable for dealers, collectors, researchers, and market analysts. Extracting this data manually is impractical at scale — the **BringaTrailer Auctions Scraper** automates comprehensive data collection from auction listings, enabling you to build databases, analyze market trends, and monitor competitor activity.

---

### Overview

The **BringaTrailer Auctions Scraper** extracts detailed records from BringaTrailer auction pages, converting raw listings into structured, machine-readable data. It is designed for:

- **Automotive dealers** tracking market prices and demand trends
- **Collectors and enthusiasts** monitoring vehicles of interest and bidding patterns
- **Researchers** studying collector car markets and valuation trends
- **Market analysts** building datasets for pricing models and competitive intelligence
- **Data aggregators** feeding automotive inventory into multi-platform databases

The scraper captures over 30 data points per auction, including bid history, vehicle specifications, location data, premium flags, and real-time auction status — everything needed for comprehensive market analysis.

---

### Input Format

The scraper accepts a JSON configuration object controlling which auctions to scrape and how:

```json
{
  "urls": [
    "https://bringatrailer.com/auctions/"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}
````

#### Configuration Fields

| Field | Type | Description |
|---|---|---|
| `urls` | Array | Direct links to BringaTrailer auction pages or category URLs (e.g., search results, filtered lists) |
| `ignore_url_failures` | Boolean | If `true`, continues scraping if individual URLs fail; if `false`, stops the run on first error |
| `max_items_per_url` | Integer | Maximum number of auction listings to collect per URL (e.g., `200`). Higher values capture more data but increase runtime |

> **Tip:** Use category or search result URLs to collect multiple auctions in one run (e.g., `https://bringatrailer.com/auctions/?make=Ferrari`). Set `max_items_per_url` to `200` to capture a full page of results.

***

### Output Format

**Sample output**

```json
{
  "active": true,
  "categories": [
    "7"
  ],
  "comments": null,
  "current_bid": 500000,
  "current_bid_formatted": "USD $500,000",
  "current_bid_label": "Bid:",
  "country": "United States",
  "country_code": "US",
  "country_code_alpha3": "USA",
  "country_flag": "<img class=\"countries-flags\" src=\"https://bringatrailer.com/wp-content/themes/bringatrailer/assets/img/countries/us.svg\" alt=\"United States\" />",
  "currency": "USD",
  "era": "1990",
  "excerpt": "This Porsche 911 Turbo 3.6 is one of the first 288 North American-market examples produced, each of which was assembled in early-mid 1993 for the 1994 model year. Ordered in Guards Red over a black interior with all-leather seats, the car is powered by a turbocharged 3.6-liter flat-six paired with a five-speed manual transaxle.",
  "in_subscription": false,
  "keyword_pages": [
    1833043,
    1832975,
    89009061
  ],
  "lat": "33.6894",
  "lon": "-111.837",
  "noreserve": false,
  "premium": true,
  "processing_type": null,
  "pusher": "post;list;112989832",
  "repeat": false,
  "searchable": "German 964 Turbo Porsche Located in United States WP0AC296XRS480113 1994 Porsche 911 Turbo 3.6 United States",
  "sold_text": "",
  "sold_text_timestamp": 1782752400,
  "thumbnail_url": "https://bringatrailer.com/wp-content/uploads/2026/04/1994_porsche_911-turbo-3.6_Web205071420199420Porsche2091120Turbo202-1-18023.jpg?w=470&h=318&crop=1",
  "timestamp_end": 1782752400,
  "title": "27k-Mile 1994 Porsche 911 Turbo 3.6",
  "url": "https://bringatrailer.com/listing/1994-porsche-911-turbo-3-6-33/",
  "views": null,
  "watch_url": "https://bringatrailer.com/wp-admin/admin-ajax.php?action=bat_listing_watch&listing=112989832&watch=yes",
  "watched": false,
  "watchers": null,
  "year": "1994",
  "id": 112989832,
  "from_url": "https://bringatrailer.com/auctions/"
}
```

Each scraped auction returns a comprehensive record with 34 fields covering vehicle details, bidding data, and auction status:

#### Auction Identification & Basics

| Field | Meaning |
|---|---|
| `ID` | Unique BringaTrailer identifier for this auction |
| `Title` | Auction title as displayed (e.g., "1987 Ferrari Testarossa") |
| `URL` | Direct link to the auction listing page |
| `Excerpt` | Short summary text of the vehicle |
| `Thumbnail URL` | Image URL for the auction thumbnail |
| `Watch URL` | URL to add the auction to your watchlist |

#### Bidding & Pricing Data

| Field | Meaning |
|---|---|
| `Current Bid` | Highest bid amount as a numeric value |
| `Current Bid Formatted` | Formatted bid amount with currency symbol (e.g., "$125,000") |
| `Current Bid Label` | Text label for bid status (e.g., "Highest bid", "Reserve not met") |
| `No Reserve` | Boolean flag: `true` if auction has no reserve price |
| `Sold Text` | Final sale status text if auction ended (e.g., "Sold for $145,000") |
| `Sold Text Timestamp` | Timestamp when the auction closed/sold |

#### Auction Status & Activity

| Field | Meaning |
|---|---|
| `Active` | Boolean: `true` if auction is currently live |
| `Watched` | Boolean: `true` if you are watching this auction |
| `Watchers` | Count of users watching this auction |
| `Comments` | Number of comments/questions on the listing |
| `Views` | Total number of page views for this auction |
| `Timestamp End` | Expected auction end date/time (ISO format) |

#### Vehicle & Category Information

| Field | Meaning |
|---|---|
| `Year` | Vehicle model year (e.g., `1987`) |
| `Era` | Vehicle era/generation classification |
| `Categories` | Vehicle categories (e.g., "Classic Cars", "Supercars") |
| `Searchable` | Boolean: whether the vehicle appears in search results |
| `Keyword Pages` | Related keyword pages or tags |

#### Geographic & Currency Data

| Field | Meaning |
|---|---|
| `Country` | Country name where the vehicle is located |
| `Country Code` | Two-letter ISO country code (e.g., `US`, `DE`) |
| `Country Code Alpha3` | Three-letter country code (e.g., `USA`, `DEU`) |
| `Country Flag` | Emoji or URL of the country flag |
| `Currency` | Currency of the bid amount (e.g., `USD`, `EUR`) |
| `Latitude` | Geographic latitude of vehicle location |
| `Longitude` | Geographic longitude of vehicle location |

#### Auction Flags & Features

| Field | Meaning |
|---|---|
| `Premium` | Boolean: `true` if this is a premium/featured listing |
| `In Subscription` | Boolean: `true` if included in a subscription service |
| `Repeat` | Boolean: `true` if the vehicle is being re-auctioned |
| `Processing Type` | Auction processing method (e.g., standard, express) |
| `Pusher` | Boolean or value indicating if auction has promotional push |

***

### How to Use

1. **Identify auction URLs** — Navigate to BringaTrailer.com and copy URLs of auction pages or search results you want to scrape. Examples:
   - Single auction: `https://bringatrailer.com/auctions/1987-ferrari-testarossa/`
   - Category/search: `https://bringatrailer.com/auctions/?make=Ferrari&year=1980-1989`
   - All auctions: `https://bringatrailer.com/auctions/`

2. **Configure the scraper** — Paste URLs into the `urls` array. Set `max_items_per_url` based on your needs:
   - `20–50` for targeted, quick scrapes
   - `200+` for comprehensive dataset collection

3. **Enable error handling** — Keep `ignore_url_failures: true` to prevent one failed URL from stopping your entire run.

4. **Execute the scraper** — Start the actor and monitor progress in the run log.

5. **Download and process** — Export results as JSON, CSV, or Excel for analysis in spreadsheets, databases, or custom applications.

**Best practices:**

- Spread large scrapes across multiple runs to avoid timeouts
- Use filtered category URLs to reduce `max_items_per_url` needs
- Cross-reference `Sold Text Timestamp` with `Timestamp End` to identify completed auctions

***

### Use Cases & Business Value

- **Market pricing analysis:** Track historical bid trends and final sale prices across vehicle categories and eras
- **Competitor monitoring:** Watch what vehicles competitors are bidding on and at what price points
- **Inventory management:** Build datasets of available vehicles for dealerships or auction analytics platforms
- **Collector intelligence:** Identify vehicles of interest, monitor watchers, and analyze market demand
- **Academic research:** Study collector car markets, pricing elasticity, and auction dynamics

The **BringaTrailer Auctions Scraper** transforms raw auction listings into actionable intelligence, enabling data-driven decisions in automotive trading, investment, and market research.

***

### Conclusion

The **BringaTrailer Auctions Scraper** is an essential tool for anyone serious about collector car markets. With over 30 data fields per auction covering bidding activity, vehicle specs, location, and real-time status, it delivers the complete picture needed for market analysis, competitive research, and investment decisions. Automate your data collection today and unlock insights that manual browsing cannot provide.

# Actor input Schema

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

Add the URLs of the auctions urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## `max_items_per_url` (type: `integer`):

The maximum number of items to scrape per URL.

## Actor input object example

```json
{
  "urls": [
    "https://bringatrailer.com/auctions/"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}
```

# 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 = {
    "urls": [
        "https://bringatrailer.com/auctions/"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("stealth_mode/bringatrailer-auctions-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 = {
    "urls": ["https://bringatrailer.com/auctions/"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/bringatrailer-auctions-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 '{
  "urls": [
    "https://bringatrailer.com/auctions/"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}' |
apify call stealth_mode/bringatrailer-auctions-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Bringatrailer Auctions Scraper",
        "description": "Extract detailed auction listings from BringaTrailer.com with complete bidding data, vehicle specifications, and seller information. Scrape 30+ fields per auction including current bids, watchers, geographic data, and status — perfect for market analysis and competitive intelligence.",
        "version": "0.0",
        "x-build-id": "LAwxg2exbyS9cWjbw"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/stealth_mode~bringatrailer-auctions-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-stealth_mode-bringatrailer-auctions-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/stealth_mode~bringatrailer-auctions-scraper/runs": {
            "post": {
                "operationId": "runs-sync-stealth_mode-bringatrailer-auctions-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/stealth_mode~bringatrailer-auctions-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-stealth_mode-bringatrailer-auctions-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "urls": {
                        "title": "URLs of the auctions urls to scrape",
                        "type": "array",
                        "description": "Add the URLs of the auctions urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "ignore_url_failures": {
                        "title": "Continue running even if some URLs fail to be scraped",
                        "type": "boolean",
                        "description": "If true, the scraper will continue running even if some URLs fail to be scraped."
                    },
                    "max_items_per_url": {
                        "title": "Max items per URL",
                        "type": "integer",
                        "description": "The maximum number of items to scrape per URL."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
