# Bid.cars — 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 and browse salvage and insurance vehicle auctions from Copart and IAAI marketplaces, view detailed listing information including photos, pricing history, and vehicle specifications by VIN or lot number. Find similar vehicles, access sales history, and explore available makes and models to discover your next auction opportunity.

**Category:** Automotive | **Website:** [bid.cars/](https://bid.cars/) | **Docs:** [parse.bot/marketplace/5b8ead15-21cd-4bae-9b89-af79a6918fa7/bid-cars-api](https://parse.bot/marketplace/5b8ead15-21cd-4bae-9b89-af79a6918fa7/bid-cars-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-bid-cars-api-5b8ead15/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_listing_details

Retrieve full details for a specific vehicle lot, enriched with additional pricing and auction data extracted from the lot page HTML. Returns the listing's base data plus an enriched_details object containing estimatedAmount1, estimatedAmount2, buyNowAmount, currentBid, finalBid, auctionType, liveAuctionStartDateTime, and more.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lot_number` | string | Yes | The lot number to look up (e.g. 1-84218605). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bid-cars-api-5b8ead15/get_listing_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lot_number":"<string>"}'
```

### get_lot_photos

Retrieve all available photo URLs for a specific vehicle lot. Returns thumbnail and large image URLs keyed by img_1, img_2, etc. Uses the search index for image data with HTML page fallback.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lot_number` | string | Yes | The lot number to get photos for (e.g. 1-84218605). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bid-cars-api-5b8ead15/get_lot_photos \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lot_number":"<string>"}'
```

### get_makes_list

Retrieve the complete sorted list of unique vehicle makes available on the platform. Returns all known makes including cars, motorcycles, and other vehicle types.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bid-cars-api-5b8ead15/get_makes_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_models_list

Retrieve all models available for a specific vehicle make, sorted alphabetically. The make must match one of the values returned by get_makes_list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make` | string | Yes | Vehicle make to get models for (e.g. Toyota, Ford, BMW). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bid-cars-api-5b8ead15/get_models_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"make":"<string>"}'
```

### get_sales_history

Retrieve the historical sales records for a specific vehicle lot by parsing the lot detail page. Returns an array of prior sales with auction source, date, lot number, final bid, odometer, status, and seller. Returns an empty array if the lot has no prior sales history.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lot_number` | string | Yes | The lot number to look up sales history for (e.g. 1-84218605). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bid-cars-api-5b8ead15/get_sales_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lot_number":"<string>"}'
```

### get_similar_lots

Retrieve similar lots for a given vehicle lot number. Returns an array of recently sold similar vehicles with name, lot_number, tag, date, seller, image URL, and final price. Works best with currently active listings; archived lots may return an empty array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lot_number` | string | Yes | The lot number to find similar lots for (e.g. 1-84218605). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bid-cars-api-5b8ead15/get_similar_lots \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lot_number":"<string>"}'
```

### get_vehicle_by_lot

Look up a vehicle listing by its auction lot number. Returns the first matching active listing with full details including images, specs, pricing, and auction status, or a message object if no vehicle is found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lot` | string | Yes | Auction lot number (e.g. 1-84218605). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bid-cars-api-5b8ead15/get_vehicle_by_lot \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lot":"<string>"}'
```

### get_vehicle_by_vin

Look up a vehicle listing by its VIN (Vehicle Identification Number). Returns the first matching active listing with full details including images, specs, pricing, and auction status, or a message object if no vehicle is found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `vin` | string | Yes | Vehicle Identification Number, 17 characters (e.g. 5YFB4MDE8RP115085). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bid-cars-api-5b8ead15/get_vehicle_by_vin \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vin":"<string>"}'
```

### search_by_keyword

Search for vehicles by a free-text keyword (make, model, VIN, or lot number). Returns paginated results of matching active listings (50 per page).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'Toyota Camry', 'Ford F-150', or a VIN). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bid-cars-api-5b8ead15/search_by_keyword \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### search_listings

Search for vehicle listings with various filters. Returns paginated results of active auction listings (50 per page). Supports filtering by make, model, year range, status, and auction type. When get_count is set to 'true', returns a count summary object instead of listing data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `auction_type` | string | No | Auction type filter. |
| `get_count` | string | No | Set to 'true' to return a count summary object instead of listing data. |
| `make` | string | No | Vehicle make filter. Use 'All' for no make filter. |
| `model` | string | No | Vehicle model filter. Use 'All' for no model filter. |
| `page` | integer | No | Page number for pagination. |
| `status` | string | No | Listing status filter. |
| `year_from` | string | No | Minimum model year. |
| `year_to` | string | No | Maximum model year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bid-cars-api-5b8ead15/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"auction_type":"<string>","get_count":"<string>","make":"<string>","model":"<string>","page":"<integer>","status":"<string>","year_from":"<string>","year_to":"<string>"}'
```