# Bringatrailer — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search live and historical Bring a Trailer auctions to find pricing trends, model comparisons, and detailed listing information for classic and collectible vehicles. Track auction results, compare price trends across models, and browse the complete directory of makes and models available on the platform.

**Category:** Automotive | **Website:** [bringatrailer.com/](https://bringatrailer.com/) | **Docs:** [parse.bot/marketplace/130132d2-01e5-433e-a941-995805be2e41/bringatrailer-com-api](https://parse.bot/marketplace/130132d2-01e5-433e-a941-995805be2e41/bringatrailer-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-bringatrailer-com-api-130132d2/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_auction_results

Retrieves completed auction results with sale prices. Returns paginated listings sorted by most recently completed. Each item includes final bid amount, sold text with date, and listing metadata. Only page 1 is reliably supported; higher pages may time out.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Only page 1 is reliably supported. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bringatrailer-com-api-130132d2/get_auction_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_current_auctions

Retrieves all currently live auctions on Bring a Trailer. Each auction item includes the current bid amount, title, URL, end timestamp, location, and whether the listing has no reserve. The locations array provides geographic filter options.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bringatrailer-com-api-130132d2/get_current_auctions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_listing_detail

Retrieves full details for a specific auction listing page including JSON-LD structured data (with Product offers/pricing when available), extracted listing essentials, and page metadata. Accepts either a full URL or a listing slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full listing URL (e.g. 'https://bringatrailer.com/listing/1977-porsche-911s-targa-77/') or listing slug (e.g. '1977-porsche-911s-targa-77'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bringatrailer-com-api-130132d2/get_listing_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_makes_and_models_directory

Retrieves the complete directory of all makes and their associated models available on Bring a Trailer. Each make includes an array of models with name, URL, and slug. Use slugs with get_model_auction_results, get_price_trends, and get_price_trend_comparison.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bringatrailer-com-api-130132d2/get_makes_and_models_directory \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_model_auction_results

Retrieves completed auctions for a specific make/model combination with optional time period filtering. Returns paginated auction results with pricing statistics including sold and unsold data points. Use search_listings or get_makes_and_models_directory to discover valid make/model slugs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make` | string | Yes | Make slug in lowercase (e.g. 'porsche', 'ferrari', 'bmw'). |
| `model` | string | Yes | Model slug in lowercase (e.g. '911', '488', 'm3'). Use search_listings or get_makes_and_models_directory to find valid slugs. |
| `page` | integer | No | Page number for pagination. |
| `recency` | string | No | Time period filter. Accepted values: '1Y', '2Y', '3Y', '5Y'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bringatrailer-com-api-130132d2/get_model_auction_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"make":"<string>","model":"<string>","page":"<integer>","recency":"<string>"}'
```

### get_price_trend_comparison

Compares average sale prices between the most recent 12 months and the previous 12 months for a specific make/model. Useful for identifying whether a model is appreciating or depreciating. Returns zeros when no sales data is available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make` | string | Yes | Make slug in lowercase (e.g. 'porsche', 'ferrari', 'bmw'). |
| `model` | string | Yes | Model slug in lowercase (e.g. '911', '488', 'm3'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bringatrailer-com-api-130132d2/get_price_trend_comparison \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"make":"<string>","model":"<string>"}'
```

### get_price_trends

Computes pricing statistics for a specific make/model over a time period. Returns count, min, max, average, and median sale prices derived from completed auctions. Returns zeros when no sales data is available for the specified period.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make` | string | Yes | Make slug in lowercase (e.g. 'porsche', 'ferrari', 'bmw'). |
| `model` | string | Yes | Model slug in lowercase (e.g. '911', '488', 'm3'). |
| `recency` | string | No | Time period for statistics. Accepted values: '1Y', '2Y', '3Y', '5Y'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bringatrailer-com-api-130132d2/get_price_trends \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"make":"<string>","model":"<string>","recency":"<string>"}'
```

### search_listings

Searches for makes, models, or listings by keyword using autocomplete. Returns matching model pages and listing categories with URLs and destination IDs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'Porsche 911', 'Ferrari', 'BMW M3'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bringatrailer-com-api-130132d2/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```