---
type: "firecrawl-provider"
description: "bid.cars, a public aggregator of US salvage and insurance auction lots from Copart and IAAI: active-lot search with the site's filters, sort and 50-per-page pagination, one lot's detail page (vehicle data, damage, documents, bidding state, sales history), the public sold comparables for a lot (the only anonymous source of final prices), and the make/model taxonomy with active lot counts. Anonymous, read-only; no bidding."
use_when: "bid.cars, a public aggregator of US salvage and insurance auction lots from Copart and IAAI: active-lot search with the site's filters, sort and 50-per-page pagination, one lot's detail page (vehicle data, damage, documents, bidding state, sales history), the public sold comparables for a lot (the only anonymous source of final prices), and the make/model taxonomy with active lot counts. Anonymous, read-only; no bidding."
categories: "Retail"
capabilities: 4
credits_per_call: 5
---
# bid.cars on Firecrawl Alexandria

bid.cars, a public aggregator of US salvage and insurance auction lots from Copart and IAAI: active-lot search with the site's filters, sort and 50-per-page pagination, one lot's detail page (vehicle data, damage, documents, bidding state, sales history), the public sold comparables for a lot (the only anonymous source of final prices), and the make/model taxonomy with active lot counts. Anonymous, read-only; no bidding.

- Categories: Retail
- Category index: [Retail category](https://firecrawl.dev/alexandria/agents/categories/retail)
- Provider key: `bid-cars`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/bid-cars)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/bid-cars/openapi.json)

## Capabilities

- [Get lot](https://firecrawl.dev/alexandria/agents/providers/bid-cars/vehicles/get_lot): One bid.cars lot from its server-rendered detail page `GET /en/lot/{lot}/{tag}`, addressed by lot id (`0-46008811`, `1-51374586`), by VIN (resolved through the site's `/app/search/en/vin-lot/{vin}/false` lookup) or by a pasted lot URL. Returns the Vehicle JSON-LD identity (year, make, model, VIN, colour, transmission, damages, sale date), the header (title, location, shipping terminal, seller, sale document, estimated value range), the bidding box (current bid and time left for active lots; `archived: true` with `auction_ended_on` and a hidden final bid for sold lots: the site masks final bids for anonymous users), the vehicle information block (loss, damages, odometer, start code, key, ACV/ERC, body, colour, engine, transmission, fuel, drive), the auction-house details list, the sales-history table and the image gallery. A lot the site does not know answers HTTP 410 and is `not_found`.
- [Makes models](https://firecrawl.dev/alexandria/agents/providers/bid-cars/vehicles/makes_models): The make/model taxonomy bid.cars uses for its search suggestions (`GET /app/search/tips`): every vehicle type / make / model with the number of lots currently at auction (edge-cached by the site for up to one hour). Filter by `vehicle_type` and/or `make` (case-insensitive); a make or type the site does not list is `not_found`.
- [Search lots](https://firecrawl.dev/alexandria/agents/providers/bid-cars/vehicles/search_lots): One page (50 lots) of bid.cars active-auction search over `GET /app/search/request`. Two modes: free text (`query`, the site's `search-type=typing`: VIN, lot number, make/model words) or structured filters (`search-type=filters`: vehicle type, make, model, year range, auction house, status, loss type, fuel type, body style, estimated value range) with the site's `order_by` sort. Every record carries the lot id (`{source}-{number}`: 0 = IAAI stock number, 1 = Copart lot), VIN, canonical URL, current pre-bid, Buy Now price, bid-closing time, estimated value range, odometer, damage, start code, sale document and images, as the site states them (USD, miles). Follow `next_page` / the continuation to paginate; a page past the end is a legitimate empty page. Sold/archived lots are account-gated on the site and are not returned here.
- [Similar sold lots](https://firecrawl.dev/alexandria/agents/providers/bid-cars/vehicles/similar_sold_lots): Sold comparables the site shows under a lot: recently sold lots of the same make/model with their public final prices, sale dates, sellers and thumbnails, from `GET /app/lot/{lot}/similar` (active lots) with a fallback to `GET /app/lot/{lot}/archived/similar` (the variant the archived lot page loads; `archived` tells which one answered). This is the only anonymous source of final prices on bid.cars (the archived search and archived lot pages mask them). An unknown lot id is `not_found`; a known lot with no comparables is an empty list.

## 1. Choose this provider when

bid.cars, a public aggregator of US salvage and insurance auction lots from Copart and IAAI: active-lot search with the site's filters, sort and 50-per-page pagination, one lot's detail page (vehicle data, damage, documents, bidding state, sales history), the public sold comparables for a lot (the only anonymous source of final prices), and the make/model taxonomy with active lot counts. Anonymous, read-only; no bidding.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "bid-cars",
  "capability": "vehicles/get_lot",
  "options": {
    "lot": "1-51374586"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `lot` (string): bid.cars lot id `{source}-{number}` as returned by `search_lots`. Pattern: ^[0-9]-[0-9]{1,12}$. Example: `{source}-{number}`
- `url` (string): A bid.cars lot page URL. Pattern: ^https?://(www\.)?bid\.cars/[a-z]{2}/lot/[0-9]-[0-9]{1,12}(/.*)?$. Example: `<url>`
- `vin` (string): Vehicle identification number; resolved to the lot through the site's VIN lookup. Pattern: ^[A-HJ-NPR-Za-hj-npr-z0-9]{11,17}$. Example: `<vin>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "bid-cars",
    capability: "vehicles/get_lot",
    options: {
      lot: "1-51374586",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "bid-cars",
  "capability": "vehicles/get_lot",
  "options": {
    "lot": "1-51374586"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "bid-cars",
    "capability": "vehicles/get_lot",
    "options": {
      "lot": "1-51374586"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'bid-cars/vehicles/get_lot' \
  --options '{"lot":"1-51374586"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "bid-cars",
  "capability": "vehicles/get_lot",
  "options": {
    "lot": "1-51374586"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "bid-cars",
  "capability": "vehicles/get_lot",
  "options": {
    "lot": "1-51374586"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "archived": true,
  "auction_ended_on": "Tuesday, June 16, 2026",
  "color": "Gray",
  "country": "US",
  "currency": "USD",
  "current_bid_usd": null,
  "estimated_max_usd": null,
  "estimated_min_usd": null,
  "final_bid_hidden": true,
  "final_bid_usd": null,
  "image": "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-1.jpg",
  "images": [
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-1.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-2.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-3.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-4.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-5.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-6.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-7.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-8.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-9.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-10.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-11.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-12.jpg"
  ],
  "images_large": [
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-1.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-2.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-3.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-4.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-5.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-6.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-7.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-8.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-9.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-10.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-11.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-12.jpg"
  ],
  "known_damages": "Front end",
  "live_auction_at": null,
  "location": "Hayward (CA)",
  "lot": "1-51374586",
  "make": "BMW",
  "model": "3 Series",
  "observed_at_ms": 1791615065428,
  "sale_date": "2026-06-16",
  "sale_document": "Salvage certificate (CA)",
  "sales_history": [
    {
      "auction": "Copart",
      "date": "2026-06-16",
      "final_bid_masked": true,
      "final_bid_usd": null,
      "lot": "1-51374586",
      "odometer_mi": 86213,
      "seller": "GEICO",
      "status": "Sold"
    }
  ],
  "seller": "Geico",
  "seller_trusted": true,
  "shipping_from": "Los Angeles (CA)",
  "source": "Copart",
  "source_details": [
    {
      "label": "Model",
      "value": "3 series"
    },
    {
      "label": "Body Style",
      "value": "Sedan"
    },
    {
      "label": "Engine",
      "value": "2.0L 4"
    },
    {
      "label": "Drive",
      "value": "Rear wheel drive"
    },
    {
      "label": "Transmission",
      "value": "Automatic"
    },
    {
      "label": "Sale Status",
      "value": "Pure sale"
    }
  ],
  "source_lot_number": "51374586",
  "source_url": "https://copart.com/lot/51374586",
  "time_left": null,
  "title": "2017 BMW 3 Series, 330 I",
  "transmission": "Automatic",
  "url": "https://bid.cars/en/lot/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874",
  "vehicle": {
    "acv_usd": 15140,
    "body_style": "Sedan",
    "drive_type": "All wheel drive",
    "engine": "2.0L, 4 cyl., 248HP",
    "erc_usd": 16987,
    "exterior_color": "Gray",
    "fuel_type": "Gasoline",
    "key": "Present",
    "loss_type": null,
    "odometer_km": 138746,
    "odometer_mi": 86213,
    "primary_damage": "Front end",
    "secondary_damage": "Roof",
    "start_code": null,
    "transmission": "Automatic"
  },
  "vin": "WBA8B9G33HNU55874",
  "year": 2017
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Get lot

- Capability: `vehicles/get_lot`
- Description: One bid.cars lot from its server-rendered detail page `GET /en/lot/{lot}/{tag}`, addressed by lot id (`0-46008811`, `1-51374586`), by VIN (resolved through the site's `/app/search/en/vin-lot/{vin}/false` lookup) or by a pasted lot URL. Returns the Vehicle JSON-LD identity (year, make, model, VIN, colour, transmission, damages, sale date), the header (title, location, shipping terminal, seller, sale document, estimated value range), the bidding box (current bid and time left for active lots; `archived: true` with `auction_ended_on` and a hidden final bid for sold lots: the site masks final bids for anonymous users), the vehicle information block (loss, damages, odometer, start code, key, ACV/ERC, body, colour, engine, transmission, fuel, drive), the auction-house details list, the sales-history table and the image gallery. A lot the site does not know answers HTTP 410 and is `not_found`.
- Instructions: Read one lot in full after `search_lots`, or from a VIN or a bid.cars lot URL.
- Cost: 5 credits per call
- Capability file: [Get lot](https://firecrawl.dev/alexandria/agents/providers/bid-cars/vehicles/get_lot)

Accepted options:
- `lot` (string): bid.cars lot id `{source}-{number}` as returned by `search_lots`. Pattern: ^[0-9]-[0-9]{1,12}$. Example: `{source}-{number}`
- `url` (string): A bid.cars lot page URL. Pattern: ^https?://(www\.)?bid\.cars/[a-z]{2}/lot/[0-9]-[0-9]{1,12}(/.*)?$. Example: `<url>`
- `vin` (string): Vehicle identification number; resolved to the lot through the site's VIN lookup. Pattern: ^[A-HJ-NPR-Za-hj-npr-z0-9]{11,17}$. Example: `<vin>`

Response schema example:
```json
{
  "archived": true,
  "auction_ended_on": "Tuesday, June 16, 2026",
  "color": "Gray",
  "country": "US",
  "currency": "USD",
  "current_bid_usd": null,
  "estimated_max_usd": null,
  "estimated_min_usd": null,
  "final_bid_hidden": true,
  "final_bid_usd": null,
  "image": "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-1.jpg",
  "images": [
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-1.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-2.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-3.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-4.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-5.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-6.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-7.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-8.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-9.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-10.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-11.jpg",
    "https://mercury.bid.cars/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-12.jpg"
  ],
  "images_large": [
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-1.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-2.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-3.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-4.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-5.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-6.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-7.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-8.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-9.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-10.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-11.jpg",
    "https://pluto.bid.car/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874-12.jpg"
  ],
  "known_damages": "Front end",
  "live_auction_at": null,
  "location": "Hayward (CA)",
  "lot": "1-51374586",
  "make": "BMW",
  "model": "3 Series",
  "observed_at_ms": 1791615065428,
  "sale_date": "2026-06-16",
  "sale_document": "Salvage certificate (CA)",
  "sales_history": [
    {
      "auction": "Copart",
      "date": "2026-06-16",
      "final_bid_masked": true,
      "final_bid_usd": null,
      "lot": "1-51374586",
      "odometer_mi": 86213,
      "seller": "GEICO",
      "status": "Sold"
    }
  ],
  "seller": "Geico",
  "seller_trusted": true,
  "shipping_from": "Los Angeles (CA)",
  "source": "Copart",
  "source_details": [
    {
      "label": "Model",
      "value": "3 series"
    },
    {
      "label": "Body Style",
      "value": "Sedan"
    },
    {
      "label": "Engine",
      "value": "2.0L 4"
    },
    {
      "label": "Drive",
      "value": "Rear wheel drive"
    },
    {
      "label": "Transmission",
      "value": "Automatic"
    },
    {
      "label": "Sale Status",
      "value": "Pure sale"
    }
  ],
  "source_lot_number": "51374586",
  "source_url": "https://copart.com/lot/51374586",
  "time_left": null,
  "title": "2017 BMW 3 Series, 330 I",
  "transmission": "Automatic",
  "url": "https://bid.cars/en/lot/1-51374586/2017-BMW-3-Series-WBA8B9G33HNU55874",
  "vehicle": {
    "acv_usd": 15140,
    "body_style": "Sedan",
    "drive_type": "All wheel drive",
    "engine": "2.0L, 4 cyl., 248HP",
    "erc_usd": 16987,
    "exterior_color": "Gray",
    "fuel_type": "Gasoline",
    "key": "Present",
    "loss_type": null,
    "odometer_km": 138746,
    "odometer_mi": 86213,
    "primary_damage": "Front end",
    "secondary_damage": "Roof",
    "start_code": null,
    "transmission": "Automatic"
  },
  "vin": "WBA8B9G33HNU55874",
  "year": 2017
}
```

### Makes models

- Capability: `vehicles/makes_models`
- Description: The make/model taxonomy bid.cars uses for its search suggestions (`GET /app/search/tips`): every vehicle type / make / model with the number of lots currently at auction (edge-cached by the site for up to one hour). Filter by `vehicle_type` and/or `make` (case-insensitive); a make or type the site does not list is `not_found`.
- Instructions: Discover valid `make` / `model` / `vehicle_type` values for `search_lots`, or count active lots per model.
- Cost: 5 credits per call
- Capability file: [Makes models](https://firecrawl.dev/alexandria/agents/providers/bid-cars/vehicles/makes_models)

Accepted options:
- `make` (string): Make to restrict to, e.g. `Ferrari`. Example: `<make>`
- `vehicle_type` (string): Vehicle type as the taxonomy spells it (Automobile, Motorcycle, ATV, Personal Watercraft, Snowmobile, ...). Example: `<vehicle_type>`

Response schema example:
```json
{
  "count": 53,
  "country": "US",
  "entries": [
    {
      "active_lots": 17,
      "make": "BMW",
      "model": "1 Series",
      "name": "BMW 1 Series",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 67,
      "make": "BMW",
      "model": "2 Series",
      "name": "BMW 2 Series",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 1,
      "make": "BMW",
      "model": "2002",
      "name": "BMW 2002",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 1,
      "make": "BMW",
      "model": "2800",
      "name": "BMW 2800",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 799,
      "make": "BMW",
      "model": "3 Series",
      "name": "BMW 3 Series",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 131,
      "make": "BMW",
      "model": "4 Series",
      "name": "BMW 4 Series",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 455,
      "make": "BMW",
      "model": "5 Series",
      "name": "BMW 5 Series",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 46,
      "make": "BMW",
      "model": "6 Series",
      "name": "BMW 6 Series",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 133,
      "make": "BMW",
      "model": "7 Series",
      "name": "BMW 7 Series",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 12,
      "make": "BMW",
      "model": "8 Series",
      "name": "BMW 8 Series",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 1,
      "make": "BMW",
      "model": "Activehybrid",
      "name": "BMW Activehybrid",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 7,
      "make": "BMW",
      "model": "Alpina",
      "name": "BMW Alpina",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 2,
      "make": "BMW",
      "model": "F650",
      "name": "BMW F650",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 1,
      "make": "BMW",
      "model": "F800",
      "name": "BMW F800",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 1,
      "make": "BMW",
      "model": "F900",
      "name": "BMW F900",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 5,
      "make": "BMW",
      "model": "G310",
      "name": "BMW G310",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 1,
      "make": "BMW",
      "model": "G650",
      "name": "BMW G650",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 25,
      "make": "BMW",
      "model": "I3",
      "name": "BMW I3",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 15,
      "make": "BMW",
      "model": "I4",
      "name": "BMW I4",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 3,
      "make": "BMW",
      "model": "I5",
      "name": "BMW I5",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 4,
      "make": "BMW",
      "model": "I7",
      "name": "BMW I7",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 4,
      "make": "BMW",
      "model": "I8",
      "name": "BMW I8",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 17,
      "make": "BMW",
      "model": "IX",
      "name": "BMW IX",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 1,
      "make": "BMW",
      "model": "K100",
      "name": "BMW K100",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 1,
      "make": "BMW",
      "model": "K1100",
      "name": "BMW K1100",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 4,
      "make": "BMW",
      "model": "K1200",
      "name": "BMW K1200",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 7,
      "make": "BMW",
      "model": "K1600",
      "name": "BMW K1600",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 2,
      "make": "BMW",
      "model": "K75",
      "name": "BMW K75",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 4,
      "make": "BMW",
      "model": "M",
      "name": "BMW M",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 10,
      "make": "BMW",
      "model": "M2",
      "name": "BMW M2",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 45,
      "make": "BMW",
      "model": "M3",
      "name": "BMW M3",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 34,
      "make": "BMW",
      "model": "M4",
      "name": "BMW M4",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 21,
      "make": "BMW",
      "model": "M5",
      "name": "BMW M5",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 14,
      "make": "BMW",
      "model": "M6",
      "name": "BMW M6",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 9,
      "make": "BMW",
      "model": "M8",
      "name": "BMW M8",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 1,
      "make": "BMW",
      "model": "Other",
      "name": "BMW Other",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 7,
      "make": "BMW",
      "model": "R",
      "name": "BMW R",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 4,
      "make": "BMW",
      "model": "R1100",
      "name": "BMW R1100",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 13,
      "make": "BMW",
      "model": "R1200",
      "name": "BMW R1200",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 1,
      "make": "BMW",
      "model": "R1250",
      "name": "BMW R1250",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 1,
      "make": "BMW",
      "model": "R18",
      "name": "BMW R18",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 4,
      "make": "BMW",
      "model": "S",
      "name": "BMW S",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 10,
      "make": "BMW",
      "model": "S1000",
      "name": "BMW S1000",
      "vehicle_type": "Motorcycle"
    },
    {
      "active_lots": 169,
      "make": "BMW",
      "model": "X1",
      "name": "BMW X1",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 32,
      "make": "BMW",
      "model": "X2",
      "name": "BMW X2",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 419,
      "make": "BMW",
      "model": "X3",
      "name": "BMW X3",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 45,
      "make": "BMW",
      "model": "X4",
      "name": "BMW X4",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 566,
      "make": "BMW",
      "model": "X5",
      "name": "BMW X5",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 103,
      "make": "BMW",
      "model": "X6",
      "name": "BMW X6",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 60,
      "make": "BMW",
      "model": "X7",
      "name": "BMW X7",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 2,
      "make": "BMW",
      "model": "XM",
      "name": "BMW XM",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 15,
      "make": "BMW",
      "model": "Z3",
      "name": "BMW Z3",
      "vehicle_type": "Automobile"
    },
    {
      "active_lots": 41,
      "make": "BMW",
      "model": "Z4",
      "name": "BMW Z4",
      "vehicle_type": "Automobile"
    }
  ],
  "make": "BMW",
  "observed_at_ms": 1791615056574,
  "vehicle_type": null,
  "vehicle_types": [
    "Motorcycle",
    "Automobile",
    "ATV",
    "Snowmobile",
    "Personal Watercraft"
  ]
}
```

### Search lots

- Capability: `vehicles/search_lots`
- Description: One page (50 lots) of bid.cars active-auction search over `GET /app/search/request`. Two modes: free text (`query`, the site's `search-type=typing`: VIN, lot number, make/model words) or structured filters (`search-type=filters`: vehicle type, make, model, year range, auction house, status, loss type, fuel type, body style, estimated value range) with the site's `order_by` sort. Every record carries the lot id (`{source}-{number}`: 0 = IAAI stock number, 1 = Copart lot), VIN, canonical URL, current pre-bid, Buy Now price, bid-closing time, estimated value range, odometer, damage, start code, sale document and images, as the site states them (USD, miles). Follow `next_page` / the continuation to paginate; a page past the end is a legitimate empty page. Sold/archived lots are account-gated on the site and are not returned here.
- Instructions: Browse or filter lots currently at auction; find the lot id or VIN for `get_lot` and `similar_sold_lots`.
- Cost: 5 credits per call
- Capability file: [Search lots](https://firecrawl.dev/alexandria/agents/providers/bid-cars/vehicles/search_lots)

Accepted options:
- `auction_type` (string): Source auction house (default All). Example: `All`
- `body_style` (string): Site body-style filter value (Sedan, SUV, Pickup, Hatchback, Coupe, Minivan, Crossover, Convertible, Cargo-Van, Van, Wagon). Example: `<body_style>`
- `continuation` (string): Continuation from a previous call (`next_cursor`): the next page number. Overrides `page`. Pattern: ^[0-9]{1,4}$. Example: `next_cursor`
- `estimated_max` (number): Upper bound of the site's estimated value (USD). Example: `10`
- `estimated_min` (number): Lower bound of the site's estimated value (USD). Example: `10`
- `fuel_type` (string): Site fuel-type filter value (Diesel, Electric, Hybrid). Example: `<fuel_type>`
- `limit` (number): Return at most this many lots from the page (the site always serves 50 per page; the rest of the page is dropped). Pagination is unaffected. Example: `10`
- `loss_type` (string): Site loss-type filter value (Biohazard, Fire, Hail, Mechanical, Repossession, Theft, Vandalized, Water). Example: `<loss_type>`
- `make` (string): Make as listed by `makes_models` (e.g. `BMW`); default `All`. Example: `makes_models`
- `model` (string): Model as listed by `makes_models` (e.g. `3 Series`); default `All`. Requires `make`. Example: `makes_models`
- `order_by` (string): Site sort key (filter mode); omitted means the site's default order (sale date). Example: `date`
- `page` (number): 1-based page of 50 lots (default 1). Example: `10`
- `query` (string): Free-text search (`search-type=typing`): make/model words, a VIN or a lot number. Mutually exclusive with the structured filters. Example: `search-type=typing`
- `status` (string): Site status filter: All (default), Active (pre-bid open), Live (auction in progress), Ended (finished today), Fast-buy (Buy Now lots). Example: `All`
- `vehicle_type` (string): Site vehicle type for filter mode, as the site spells it: Automobile (default), Motorcycle, Atv, Personal-watercraft, Snowmobile, Truck, Boat, ... Example: `<vehicle_type>`
- `year_from` (number): Model year lower bound (default 1900). Example: `1900`
- `year_to` (number): Model year upper bound (default 2027). Example: `1900`

Response schema example:
```json
{
  "country": "US",
  "currency": "USD",
  "filters": {
    "auction_type": "All",
    "make": "BMW",
    "model": "3 Series",
    "order_by": "estimatedDesc",
    "status": "All",
    "vehicle_type": "Automobile",
    "year_from": 2015,
    "year_to": 2027
  },
  "from": 1,
  "lots": [
    {
      "bid_closes": "Fri 16 Oct, 21:00 GMT+2",
      "buy_now_price_usd": 30000,
      "current_bid_usd": 0,
      "engine": "3.0L, 6 cyl., 386HP",
      "estimated_max_usd": 43510,
      "estimated_min_usd": 26110,
      "final_bid_usd": null,
      "has_360_view": false,
      "has_video": false,
      "image": "https://images.bid.cars/172243156_6ac65ecd34f3a/2026-BMW-3-Series-3MW59FT03T8G06586-1.jpg",
      "images": [
        "https://pluto.bid.car/1-72243156/2026-BMW-3-Series-3MW59FT03T8G06586-1.jpg",
        "https://pluto.bid.car/1-72243156/2026-BMW-3-Series-3MW59FT03T8G06586-2.jpg",
        "https://pluto.bid.car/1-72243156/2026-BMW-3-Series-3MW59FT03T8G06586-3.jpg",
        "https://pluto.bid.car/1-72243156/2026-BMW-3-Series-3MW59FT03T8G06586-4.jpg",
        "https://pluto.bid.car/1-72243156/2026-BMW-3-Series-3MW59FT03T8G06586-5.jpg",
        "https://pluto.bid.car/1-72243156/2026-BMW-3-Series-3MW59FT03T8G06586-6.jpg",
        "https://pluto.bid.car/1-72243156/2026-BMW-3-Series-3MW59FT03T8G06586-7.jpg",
        "https://pluto.bid.car/1-72243156/2026-BMW-3-Series-3MW59FT03T8G06586-8.jpg",
        "https://pluto.bid.car/1-72243156/2026-BMW-3-Series-3MW59FT03T8G06586-9.jpg",
        "https://pluto.bid.car/1-72243156/2026-BMW-3-Series-3MW59FT03T8G06586-10.jpg"
      ],
      "location": "San Diego (CA)",
      "loss_type": null,
      "lot": "1-72243156",
      "name": "2026 BMW 3 Series, M340I",
      "odometer_mi": 338,
      "primary_damage": "Front end",
      "sale_document": "DV (California)",
      "seller": null,
      "seller_trusted": false,
      "sold_before": false,
      "source": "Copart",
      "start_code": null,
      "status": "active",
      "tag": "2026-BMW-3-Series-3MW59FT03T8G06586",
      "time_left": "6 d 11 h 39 min",
      "time_left_seconds": 560390,
      "title_has_lien": false,
      "url": "https://bid.cars/en/lot/1-72243156/2026-BMW-3-Series-3MW59FT03T8G06586",
      "vehicle_type": "Automobile",
      "video_url": null,
      "vin": "3MW59FT03T8G06586"
    },
    {
      "bid_closes": "Mon 12 Oct, 19:00 GMT+2",
      "buy_now_price_usd": 23525,
      "current_bid_usd": 0,
      "engine": "2.0L, 4 cyl., 255HP",
      "estimated_max_usd": 35630,
      "estimated_min_usd": 21380,
      "final_bid_usd": null,
      "has_360_view": false,
      "has_video": false,
      "image": "https://images.bid.cars/045542035_6ac4126f61232/2026-BMW-3-Series-WBA23LA0XTFW52879-1.jpg",
      "images": [
        "https://pluto.bid.car/0-45542035/2026-BMW-3-Series-WBA23LA0XTFW52879-1.jpg",
        "https://pluto.bid.car/0-45542035/2026-BMW-3-Series-WBA23LA0XTFW52879-2.jpg",
        "https://pluto.bid.car/0-45542035/2026-BMW-3-Series-WBA23LA0XTFW52879-3.jpg",
        "https://pluto.bid.car/0-45542035/2026-BMW-3-Series-WBA23LA0XTFW52879-4.jpg",
        "https://pluto.bid.car/0-45542035/2026-BMW-3-Series-WBA23LA0XTFW52879-5.jpg",
        "https://pluto.bid.car/0-45542035/2026-BMW-3-Series-WBA23LA0XTFW52879-6.jpg",
        "https://pluto.bid.car/0-45542035/2026-BMW-3-Series-WBA23LA0XTFW52879-7.jpg",
        "https://pluto.bid.car/0-45542035/2026-BMW-3-Series-WBA23LA0XTFW52879-8.jpg",
        "https://pluto.bid.car/0-45542035/2026-BMW-3-Series-WBA23LA0XTFW52879-9.jpg",
        "https://pluto.bid.car/0-45542035/2026-BMW-3-Series-WBA23LA0XTFW52879-10.jpg",
        "https://pluto.bid.car/0-45542035/2026-BMW-3-Series-WBA23LA0XTFW52879-11.jpg",
        "https://pluto.bid.car/0-45542035/2026-BMW-3-Series-WBA23LA0XTFW52879-12.jpg",
        "https://pluto.bid.car/0-45542035/2026-BMW-3-Series-WBA23LA0XTFW52879-13.jpg",
        "https://pluto.bid.car/0-45542035/2026-BMW-3-Series-WBA23LA0XTFW52879-14.jpg",
        "https://pluto.bid.car/0-45542035/2026-BMW-3-Series-WBA23LA0XTFW52879-15.jpg",
        "https://pluto.bid.car/0-45542035/2026-BMW-3-Series-WBA23LA0XTFW52879-16.jpg"
      ],
      "location": "Avenel New... (NJ)",
      "loss_type": "Collision",
      "lot": "0-45542035",
      "name": "2026 BMW 3 Series, 330I Xdrive",
      "odometer_mi": 802,
      "primary_damage": "Front end",
      "sale_document": "Salvage (New Jersey)",
      "seller": "Progressive Casualty Insurance",
      "seller_trusted": true,
      "sold_before": false,
      "source": "IAAI",
      "start_code": "Stationary",
      "status": "active",
      "tag": "2026-BMW-3-Series-WBA23LA0XTFW52879",
      "time_left": "2 d 9 h 39 min",
      "time_left_seconds": 207590,
      "title_has_lien": false,
      "url": "https://bid.cars/en/lot/0-45542035/2026-BMW-3-Series-WBA23LA0XTFW52879",
      "vehicle_type": "Automobile",
      "video_url": null,
      "vin": "WBA23LA0XTFW52879"
    },
    {
      "bid_closes": "Mon 12 Oct, 19:00 GMT+2",
      "buy_now_price_usd": null,
      "current_bid_usd": 17100,
      "engine": "3.0L, 6 cyl., 382HP",
      "estimated_max_usd": 33690,
      "estimated_min_usd": 23590,
      "final_bid_usd": null,
      "has_360_view": false,
      "has_video": true,
      "image": "https://images.bid.cars/045939874_6abf058b1ec8c/2023-BMW-3-Series-3MW49FF05P8C79606-1.jpg",
      "images": [
        "https://pluto.bid.car/0-45939874/2023-BMW-3-Series-3MW49FF05P8C79606-1.jpg",
        "https://pluto.bid.car/0-45939874/2023-BMW-3-Series-3MW49FF05P8C79606-2.jpg",
        "https://pluto.bid.car/0-45939874/2023-BMW-3-Series-3MW49FF05P8C79606-3.jpg",
        "https://pluto.bid.car/0-45939874/2023-BMW-3-Series-3MW49FF05P8C79606-4.jpg",
        "https://pluto.bid.car/0-45939874/2023-BMW-3-Series-3MW49FF05P8C79606-5.jpg",
        "https://pluto.bid.car/0-45939874/2023-BMW-3-Series-3MW49FF05P8C79606-6.jpg",
        "https://pluto.bid.car/0-45939874/2023-BMW-3-Series-3MW49FF05P8C79606-7.jpg",
        "https://pluto.bid.car/0-45939874/2023-BMW-3-Series-3MW49FF05P8C79606-8.jpg",
        "https://pluto.bid.car/0-45939874/2023-BMW-3-Series-3MW49FF05P8C79606-9.jpg",
        "https://pluto.bid.car/0-45939874/2023-BMW-3-Series-3MW49FF05P8C79606-10.jpg",
        "https://pluto.bid.car/0-45939874/2023-BMW-3-Series-3MW49FF05P8C79606-11.jpg",
        "https://pluto.bid.car/0-45939874/2023-BMW-3-Series-3MW49FF05P8C79606-12.jpg",
        "https://pluto.bid.car/0-45939874/2023-BMW-3-Series-3MW49FF05P8C79606-13.jpg",
        "https://pluto.bid.car/0-45939874/2023-BMW-3-Series-3MW49FF05P8C79606-14.jpg",
        "https://pluto.bid.car/0-45939874/2023-BMW-3-Series-3MW49FF05P8C79606-15.jpg",
        "https://pluto.bid.car/0-45939874/2023-BMW-3-Series-3MW49FF05P8C79606-16.jpg"
      ],
      "location": "Des Moines (IA)",
      "loss_type": "Collision",
      "lot": "0-45939874",
      "name": "2023 BMW 3 Series, M340I M340I Xdrive",
      "odometer_mi": 31525,
      "primary_damage": "Left side",
      "sale_document": "Salvage (Iowa)",
      "seller": "Progressive Casualty Insurance",
      "seller_trusted": true,
      "sold_before": false,
      "source": "IAAI",
      "start_code": "Run / Drive",
      "status": "active",
      "tag": "2023-BMW-3-Series-3MW49FF05P8C79606",
      "time_left": "2 d 9 h 39 min",
      "time_left_seconds": 207590,
      "title_has_lien": false,
      "url": "https://bid.cars/en/lot/0-45939874/2023-BMW-3-Series-3MW49FF05P8C79606",
      "vehicle_type": "Automobile",
      "video_url": "https://mediastorageaccountprod.blob.core.windows.net/media/46439046_VES-100_1",
      "vin": "3MW49FF05P8C79606"
    },
    {
      "bid_closes": "Mon 12 Oct, 19:00 GMT+2",
      "buy_now_price_usd": 20250,
      "current_bid_usd": 25,
      "engine": "3.0L, 6 cyl., 386HP",
      "estimated_max_usd": 33510,
      "estimated_min_usd": 24300,
      "final_bid_usd": null,
      "has_360_view": false,
      "has_video": false,
      "image": "https://images.bid.cars/045688000_6ac4126f960f0/2025-BMW-3-Series-3MW69FT02S8F84549-1.jpg",
      "images": [
        "https://pluto.bid.car/0-45688000/2025-BMW-3-Series-3MW69FT02S8F84549-1.jpg",
        "https://pluto.bid.car/0-45688000/2025-BMW-3-Series-3MW69FT02S8F84549-2.jpg",
        "https://pluto.bid.car/0-45688000/2025-BMW-3-Series-3MW69FT02S8F84549-3.jpg",
        "https://pluto.bid.car/0-45688000/2025-BMW-3-Series-3MW69FT02S8F84549-4.jpg",
        "https://pluto.bid.car/0-45688000/2025-BMW-3-Series-3MW69FT02S8F84549-5.jpg",
        "https://pluto.bid.car/0-45688000/2025-BMW-3-Series-3MW69FT02S8F84549-6.jpg",
        "https://pluto.bid.car/0-45688000/2025-BMW-3-Series-3MW69FT02S8F84549-7.jpg",
        "https://pluto.bid.car/0-45688000/2025-BMW-3-Series-3MW69FT02S8F84549-8.jpg",
        "https://pluto.bid.car/0-45688000/2025-BMW-3-Series-3MW69FT02S8F84549-9.jpg",
        "https://pluto.bid.car/0-45688000/2025-BMW-3-Series-3MW69FT02S8F84549-10.jpg",
        "https://pluto.bid.car/0-45688000/2025-BMW-3-Series-3MW69FT02S8F84549-11.jpg",
        "https://pluto.bid.car/0-45688000/2025-BMW-3-Series-3MW69FT02S8F84549-12.jpg",
        "https://pluto.bid.car/0-45688000/2025-BMW-3-Series-3MW69FT02S8F84549-13.jpg",
        "https://pluto.bid.car/0-45688000/2025-BMW-3-Series-3MW69FT02S8F84549-14.jpg",
        "https://pluto.bid.car/0-45688000/2025-BMW-3-Series-3MW69FT02S8F84549-15.jpg"
      ],
      "location": "Fort Worth... (TX)",
      "loss_type": "Collision",
      "lot": "0-45688000",
      "name": "2025 BMW 3 Series, M340I Xdrive",
      "odometer_mi": 999999,
      "primary_damage": "Front end",
      "sale_document": "Salvage (Texas)",
      "seller": "Progressive Casualty Insurance",
      "seller_trusted": true,
      "sold_before": false,
      "source": "IAAI",
      "start_code": "Stationary",
      "status": "active",
      "tag": "2025-BMW-3-Series-3MW69FT02S8F84549",
      "time_left": "2 d 9 h 39 min",
      "time_left_seconds": 207590,
      "title_has_lien": false,
      "url": "https://bid.cars/en/lot/0-45688000/2025-BMW-3-Series-3MW69FT02S8F84549",
      "vehicle_type": "Automobile",
      "video_url": null,
      "vin": "3MW69FT02S8F84549"
    },
    {
      "bid_closes": "Wed 14 Oct, 16:00 GMT+2",
      "buy_now_price_usd": null,
      "current_bid_usd": 2050,
      "engine": "3.0L, 6 cyl., 382HP",
      "estimated_max_usd": 33270,
      "estimated_min_usd": 23300,
      "final_bid_usd": null,
      "has_360_view": false,
      "has_video": true,
      "image": "https://images.bid.cars/170303546_6ac5459c2c61b/2023-BMW-3-Series-3MW49FF06P8D17411-1.jpg",
      "images": [
        "https://pluto.bid.car/1-70303546/2023-BMW-3-Series-3MW49FF06P8D17411-1.jpg",
        "https://pluto.bid.car/1-70303546/2023-BMW-3-Series-3MW49FF06P8D17411-2.jpg",
        "https://pluto.bid.car/1-70303546/2023-BMW-3-Series-3MW49FF06P8D17411-3.jpg",
        "https://pluto.bid.car/1-70303546/2023-BMW-3-Series-3MW49FF06P8D17411-4.jpg",
        "https://pluto.bid.car/1-70303546/2023-BMW-3-Series-3MW49FF06P8D17411-5.jpg",
        "https://pluto.bid.car/1-70303546/2023-BMW-3-Series-3MW49FF06P8D17411-6.jpg",
        "https://pluto.bid.car/1-70303546/2023-BMW-3-Series-3MW49FF06P8D17411-7.jpg",
        "https://pluto.bid.car/1-70303546/2023-BMW-3-Series-3MW49FF06P8D17411-8.jpg",
        "https://pluto.bid.car/1-70303546/2023-BMW-3-Series-3MW49FF06P8D17411-9.jpg",
        "https://pluto.bid.car/1-70303546/2023-BMW-3-Series-3MW49FF06P8D17411-10.jpg",
        "https://pluto.bid.car/1-70303546/2023-BMW-3-Series-3MW49FF06P8D17411-11.jpg",
        "https://pluto.bid.car/1-70303546/2023-BMW-3-Series-3MW49FF06P8D17411-12.jpg"
      ],
      "location": "Gastonia (NC)",
      "loss_type": null,
      "lot": "1-70303546",
      "name": "2023 BMW 3 Series, M340XI",
      "odometer_mi": 33065,
      "primary_damage": "Rear end",
      "sale_document": "SC (North Carolina)",
      "seller": "Usaa",
      "seller_trusted": true,
      "sold_before": false,
      "source": "Copart",
      "start_code": "Run / Drive",
      "status": "active",
      "tag": "2023-BMW-3-Series-3MW49FF06P8D17411",
      "time_left": "4 d 6 h 39 min",
      "time_left_seconds": 369590,
      "title_has_lien": false,
      "url": "https://bid.cars/en/lot/1-70303546/2023-BMW-3-Series-3MW49FF06P8D17411",
      "vehicle_type": "Automobile",
      "video_url": "https://cs.copart.com/v1/AUTH_svc.pdoc00001/ids-c-prod-lpp/0926/0f9109eeabcb4b719de84687d97f7e5c_O.mp4",
      "vin": "3MW49FF06P8D17411"
    }
  ],
  "mode": "filters",
  "next_page": 2,
  "observed_at_ms": 1791615010499,
  "page": 1,
  "per_page": 50,
  "result_count": 5,
  "to": 50
}
```

### Similar sold lots

- Capability: `vehicles/similar_sold_lots`
- Description: Sold comparables the site shows under a lot: recently sold lots of the same make/model with their public final prices, sale dates, sellers and thumbnails, from `GET /app/lot/{lot}/similar` (active lots) with a fallback to `GET /app/lot/{lot}/archived/similar` (the variant the archived lot page loads; `archived` tells which one answered). This is the only anonymous source of final prices on bid.cars (the archived search and archived lot pages mask them). An unknown lot id is `not_found`; a known lot with no comparables is an empty list.
- Instructions: Price a lot against recent sales after `search_lots` or `get_lot`.
- Cost: 5 credits per call
- Capability file: [Similar sold lots](https://firecrawl.dev/alexandria/agents/providers/bid-cars/vehicles/similar_sold_lots)

Accepted options:
- `lot` (string, required): bid.cars lot id `{source}-{number}`. Pattern: ^[0-9]-[0-9]{1,12}$. Example: `{source}-{number}`

Response schema example:
```json
{
  "archived": true,
  "comparables": [
    {
      "final_price_formatted": "$1,975",
      "final_price_usd": 1975,
      "image": "https://mercury.bid.cars/0-45244127/1.jpg",
      "lot": "0-45244127",
      "name": "2016 BMW 3 Series, 328I Xdrive",
      "sale_date": "July 3, 2026",
      "seller": "Progressive Casualty Insurance",
      "source": "IAAI",
      "tag": "2016-BMW-3-Series-WBA8E3G59GNU03489",
      "url": "https://bid.cars/en/lot/0-45244127/2016-BMW-3-Series-WBA8E3G59GNU03489"
    },
    {
      "final_price_formatted": "$2,900",
      "final_price_usd": 2900,
      "image": "https://mercury.bid.cars/0-45703959/1.jpg",
      "lot": "0-45703959",
      "name": "2018 BMW 3 Series, 320I Xdrive",
      "sale_date": "August 25, 2026",
      "seller": "Non-insurance company",
      "source": "IAAI",
      "tag": "2018-BMW-3-Series-WBA8E5G59JNV02221",
      "url": "https://bid.cars/en/lot/0-45703959/2018-BMW-3-Series-WBA8E5G59JNV02221"
    },
    {
      "final_price_formatted": "$1,750",
      "final_price_usd": 1750,
      "image": "https://mercury.bid.cars/0-45001076/1.jpg",
      "lot": "0-45001076",
      "name": "2017 BMW 3 Series, 330I",
      "sale_date": "August 10, 2026",
      "seller": "Aaa So California",
      "source": "IAAI",
      "tag": "2017-BMW-3-Series-WBA8B9G34HNU52336",
      "url": "https://bid.cars/en/lot/0-45001076/2017-BMW-3-Series-WBA8B9G34HNU52336"
    },
    {
      "final_price_formatted": "$4,650",
      "final_price_usd": 4650,
      "image": "https://mercury.bid.cars/1-63608806/1.jpg",
      "lot": "1-63608806",
      "name": "2017 BMW 3 Series, 330 I",
      "sale_date": "August 7, 2026",
      "seller": "Farmers Insurance",
      "source": "Copart",
      "tag": "2017-BMW-3-Series-WBA8B9G3XHNU55032",
      "url": "https://bid.cars/en/lot/1-63608806/2017-BMW-3-Series-WBA8B9G3XHNU55032"
    },
    {
      "final_price_formatted": "$4,550",
      "final_price_usd": 4550,
      "image": "https://mercury.bid.cars/1-53932456/1.jpg",
      "lot": "1-53932456",
      "name": "2017 BMW 3 Series, 330 I",
      "sale_date": "August 31, 2026",
      "seller": "GEICO",
      "source": "Copart",
      "tag": "2017-BMW-3-Series-WBA8B9G53HNU50885",
      "url": "https://bid.cars/en/lot/1-53932456/2017-BMW-3-Series-WBA8B9G53HNU50885"
    },
    {
      "final_price_formatted": "$3,750",
      "final_price_usd": 3750,
      "image": "https://mercury.bid.cars/0-45506918/1.jpg",
      "lot": "0-45506918",
      "name": "2016 BMW 3 Series, 328I Xdrive",
      "sale_date": "July 30, 2026",
      "seller": "Mercury Insurance",
      "source": "IAAI",
      "tag": "2016-BMW-3-Series-WBA8E3G59GNT78500",
      "url": "https://bid.cars/en/lot/0-45506918/2016-BMW-3-Series-WBA8E3G59GNT78500"
    },
    {
      "final_price_formatted": "$1,800",
      "final_price_usd": 1800,
      "image": "https://mercury.bid.cars/1-51666346/1.jpg",
      "lot": "1-51666346",
      "name": "2018 BMW 3 Series, 320 I",
      "sale_date": "July 8, 2026",
      "seller": "Non-insurance company",
      "source": "Copart",
      "tag": "2018-BMW-3-Series-WBA8A9C50JAC99934",
      "url": "https://bid.cars/en/lot/1-51666346/2018-BMW-3-Series-WBA8A9C50JAC99934"
    },
    {
      "final_price_formatted": "$775",
      "final_price_usd": 775,
      "image": "https://mercury.bid.cars/0-45467409/1.jpg",
      "lot": "0-45467409",
      "name": "2017 BMW 3 Series, 320I",
      "sale_date": "August 20, 2026",
      "seller": "State Farm Group Insurance",
      "source": "IAAI",
      "tag": "2017-BMW-3-Series-WBA8A9C53HK620382",
      "url": "https://bid.cars/en/lot/0-45467409/2017-BMW-3-Series-WBA8A9C53HK620382"
    },
    {
      "final_price_formatted": "$2,300",
      "final_price_usd": 2300,
      "image": "https://mercury.bid.cars/1-56644816/1.jpg",
      "lot": "1-56644816",
      "name": "2018 BMW 3 Series, 320 I",
      "sale_date": "August 6, 2026",
      "seller": "Farmers Insurance",
      "source": "Copart",
      "tag": "2018-BMW-3-Series-WBA8A9C5XJAD27917",
      "url": "https://bid.cars/en/lot/1-56644816/2018-BMW-3-Series-WBA8A9C5XJAD27917"
    },
    {
      "final_price_formatted": "$675",
      "final_price_usd": 675,
      "image": "https://mercury.bid.cars/0-45095884/1.jpg",
      "lot": "0-45095884",
      "name": "2016 BMW 3 Series, 320I Xdrive",
      "sale_date": "June 24, 2026",
      "seller": "State Farm Group Insurance",
      "source": "IAAI",
      "tag": "2016-BMW-3-Series-WBA8E5G50GNT41962",
      "url": "https://bid.cars/en/lot/0-45095884/2016-BMW-3-Series-WBA8E5G50GNT41962"
    },
    {
      "final_price_formatted": "$14,200",
      "final_price_usd": 14200,
      "image": "https://mercury.bid.cars/0-45116232/1.jpg",
      "lot": "0-45116232",
      "name": "2018 BMW 3 Series, 340I",
      "sale_date": "June 11, 2026",
      "seller": "Mercury Insurance",
      "source": "IAAI",
      "tag": "2018-BMW-3-Series-WBA8B3G54JNV01099",
      "url": "https://bid.cars/en/lot/0-45116232/2018-BMW-3-Series-WBA8B3G54JNV01099"
    }
  ],
  "count": 11,
  "country": "US",
  "currency": "USD",
  "lot": "1-51374586",
  "observed_at_ms": 1791615221696
}
```
