# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/bringatrailer/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/bringatrailer/get-auction-results \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bringatrailer/get-current-auctions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bringatrailer/get-listing-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bringatrailer/get-makes-and-models-directory \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bringatrailer/get-model-auction-results \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bringatrailer/get-price-trend-comparison \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bringatrailer/get-price-trends \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bringatrailer/search-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.