---
type: "firecrawl-provider"
description: "Cars & Bids (carsandbids.com) online car auctions: search live and past auctions, one auction's full listing with bids, photos and seller, its comments and bid history, search suggestions, member profiles with auction and bid histories, and similar auctions. Read-only, anonymous, via the site's own signed JSON API."
use_when: "Cars & Bids (carsandbids.com) online car auctions: search live and past auctions, one auction's full listing with bids, photos and seller, its comments and bid history, search suggestions, member profiles with auction and bid histories, and similar auctions. Read-only, anonymous, via the site's own signed JSON API."
categories: "Retail"
capabilities: 6
credits_per_call: 5
---
# Cars & Bids on Firecrawl Alexandria

Cars & Bids (carsandbids.com) online car auctions: search live and past auctions, one auction's full listing with bids, photos and seller, its comments and bid history, search suggestions, member profiles with auction and bid histories, and similar auctions. Read-only, anonymous, via the site's own signed JSON API.

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

## More

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

## Capabilities

- [Auction](https://firecrawl.dev/alexandria/agents/providers/carsandbids-com/car-auctions/auction): One Cars & Bids auction by id or listing URL: title, year/make/model, VIN, mileage, drivetrain, colors, title status, location, seller, the written listing sections (highlights, equipment, modifications, known flaws, service history, ownership history, seller notes, other items), videos, history report link, bid/comment/watcher/view counts, start and end time, current high bid, sale price and buyer when the site publishes them. Photos (often 100-200) are returned only with `include_photos: true`.
- [Auction comments](https://firecrawl.dev/alexandria/agents/providers/carsandbids-com/car-auctions/auction_comments): Comments and bids on one Cars & Bids auction, newest first, with the site's filters: everything interleaved (default), most upvoted, seller comments only, or bid history only. Each item carries the author's username, seller/bidder/staff flags and reputation, the text or bid amount in USD, upvotes, reply target, attachments and timestamp. Cursor pagination with `after_id`.
- [Search auctions](https://firecrawl.dev/alexandria/agents/providers/carsandbids-com/car-auctions/search_auctions): Search Cars & Bids auctions: live auctions (default) or closed past auctions, by free text, model-year range, transmission and featured flag, with the site's sort modes and offset pagination (up to 100 per page). Each result is a listing card: id, title, location, mileage, current bid or sale price in USD, end time, status, seller and main photo.
- [Similar auctions](https://firecrawl.dev/alexandria/agents/providers/carsandbids-com/car-auctions/similar_auctions): Auctions Cars & Bids lists as similar to one auction (same listing-card shape as `search_auctions`: id, title, location, mileage, current bid or sale price in USD, end time, status, seller, main photo).
- [Suggest](https://firecrawl.dev/alexandria/agents/providers/carsandbids-com/car-auctions/suggest): Search-box suggestions from Cars & Bids for a partial make/model text, e.g. `bmw m3` -> `BMW E46 M3`, `BMW E36 M3`, ... Each suggestion is a query string for `search_auctions`.
- [User profile](https://firecrawl.dev/alexandria/agents/providers/carsandbids-com/car-auctions/user_profile): A Cars & Bids member profile by username: id, reputation, verification and certified-seller flags, bio, join date, follower counts; optionally one history section: the cars they auctioned (`auction_history`), the auctions they bid on with their bid counts and wins (`bid_history`), or their recent comments (`comments`).

## 1. Choose this provider when

Cars & Bids (carsandbids.com) online car auctions: search live and past auctions, one auction's full listing with bids, photos and seller, its comments and bid history, search suggestions, member profiles with auction and bid histories, and similar auctions. Read-only, anonymous, via the site's own signed JSON API.

## 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": "carsandbids-com",
  "capability": "car-auctions/auction",
  "options": {
    "auction_id": "rbG4LbL9"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `auction_id` (string): 8-character Cars & Bids auction id, e.g. `K1N4Qwxx` (the segment after /auctions/ in a listing URL, and `id` in search results). Pattern: ^[A-Za-z0-9]{8}$. Example: `K1N4Qwxx`
- `include_photos` (boolean): Include the full photo gallery (exterior, interior, mechanical, docs, other) with rendered URLs. Example: `false`
- `url` (string): Listing URL https://carsandbids.com/auctions/{id}/{slug}; alternative to `auction_id`. Example: `auction_id`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "carsandbids-com",
    capability: "car-auctions/auction",
    options: {
      auction_id: "rbG4LbL9",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "carsandbids-com",
  "capability": "car-auctions/auction",
  "options": {
    "auction_id": "rbG4LbL9"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "carsandbids-com",
    "capability": "car-auctions/auction",
    "options": {
      "auction_id": "rbG4LbL9"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'carsandbids-com/car-auctions/auction' \
  --options '{"auction_id":"rbG4LbL9"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "carsandbids-com",
  "capability": "car-auctions/auction",
  "options": {
    "auction_id": "rbG4LbL9"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "carsandbids-com",
  "capability": "car-auctions/auction",
  "options": {
    "auction_id": "rbG4LbL9"
  }
}
```

## 6. Response data

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

```json
{
  "body_style_code": 1,
  "canceled_message": null,
  "currency": "USD",
  "drive_train_code": 2,
  "engine": "4.0L Flat-6",
  "exterior_color": "Paint-to-Sample Maritime Blue",
  "featured": true,
  "highlighted_points": [
    "Clean Carfax history report",
    "Sport Chrono Package",
    "Porsche Ceramic Composite Brakes (PCCB)"
  ],
  "history_report": {
    "expiry": "2027-02-06T23:12:40.000+00:00",
    "url": "https://www.carfax.com/vehiclehistory/ar20/2siCobYvThBME9t_8jfgvBsS2bgYvQRvaGbEu-WAaLKQAgqHzPkBGKxopZf0_YpiV9cDZFiJXrb7ik0FpHeu1o08-4cLpl4So9tUc8wg",
    "vendor": "carfax"
  },
  "id": "rbG4LbL9",
  "inspection_report_url": null,
  "interior_color": "Black/Blue",
  "is_notable": false,
  "location": "Corvallis, OR 97330",
  "main_photo_url": "https://media.carsandbids.com/cdn-cgi/image/width=768,quality=70/c51905b0000b639a185eeb080dd879bf007f5604/photos/application/s-siHPVGi/edit/PvU-w.jpg?t=178904233970",
  "make": "Porsche",
  "make_slug": "porsche",
  "mileage": 6500,
  "mileage_text": null,
  "model": "718 Cayman",
  "model_slug": "718-cayman",
  "no_reserve": false,
  "observed_at_ms": 1791589666733,
  "photo_count": 100,
  "sections": {
    "doug": null,
    "equipment": "A partial list of notable equipment reported by the seller includes:\n- Weissach Package\n- Sport Chrono Package\n- Front-axle lift system\n- Porsche Ceramic Composite Brakes (PCCB)\n- 20-inch center-locking forged magnesium wheels\n- Bose sound system",
    "highlights": "THIS... is a 2023 Porsche 718 Cayman GT4 RS Weissach Package, finished in paint-to-sample Maritime Blue with a black and blue interior.\n- The odometer on this Cayman GT4 RS currently displays approximately 6,500 miles.\n- This Porsche is offered with a clean `Carfax` vehicle history report.\n- A partial list of notable equipment reported by the seller includes the Weissach and Sport Chrono packages, a front-axle lift system, Porsche Ceramic Composite Brakes (PCCB), and a Bose sound system. The seller reports no notable modifications.\n- Introduced in 2022, the Porsche 718 Cayman GT4 RS boasts a naturally aspirated 4.0-liter flat-6 engine derived from the 911 GT3, featuring a 9,000-rpm redline, six individual throttle bodies, and a carbon fiber airbox mounted directly behind the driver and passenger. The sole transmission choice is a 7-speed PDK with shortened gear ratios compared to the standard GT4.\n- Power comes from a 4.0-liter flat-6, rated at 493 horsepower and 331 lb-ft of torque. Output is sent to the rear wheels via a 7-speed PDK dual-clutch automatic transmission.",
    "known_flaws": null,
    "modifications": null,
    "other_items": "- 2 keys\n- Owner's manual",
    "ownership_history": "The seller reportedly purchased this Porsche in April 2025 and has added about 3,000 miles since.",
    "recent_service_history": "The attached `Carfax` history report shows that the following services have been performed:\n- April 2025 (3,599 miles): Four-wheel alignment performed\n- June 2024 (2,932 miles): Engine oil and filter changed\n- June 2023 (1,533 miles): Engine oil and filter changed",
    "seller_notes": null
  },
  "seller": {
    "id": "9eYPvG5g",
    "is_certified_seller": false,
    "username": "RadicalCarReview"
  },
  "seller_type_code": 1,
  "stats": {
    "auction_end": "2026-10-08T19:59:42.158+00:00",
    "auction_start": "2026-10-01T21:54:00.000+00:00",
    "bids": 18,
    "buyer_username": null,
    "comments": 49,
    "current_bid": 190500,
    "current_bidder_username": "jdgambleEB",
    "questions": 0,
    "sale_amount": null,
    "views": 12707,
    "watchers": 952
  },
  "status": "reserve_not_met",
  "sub_title": "493-hp Naturally-Aspirated Flat-6, Paint-To-Sample Maritime Blue, ~6,500 Miles",
  "title": "2023 Porsche 718 Cayman GT4 RS Weissach Package",
  "title_status": "Clean (OR)",
  "transmission": "automatic",
  "transmission_code": 1,
  "transmission_details": "7-Speed",
  "url": "https://carsandbids.com/auctions/rbG4LbL9/2023-porsche-718-cayman-gt4-rs-weissach-package",
  "videos": [
    {
      "duration_s": 103.8,
      "id": "3y2Lzj5L",
      "provider": "cloudflare_stream",
      "title": "Walkaround",
      "url": "https://customer-cuf69xprmkaqooxd.cloudflarestream.com/4f2c65664bd5a13dca88db949d5cfe7d/iframe"
    }
  ],
  "vin": "WP0AE2A87PS280214",
  "year": 2023
}
```

## API reference-derived contract

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

### Auction

- Capability: `car-auctions/auction`
- Description: One Cars & Bids auction by id or listing URL: title, year/make/model, VIN, mileage, drivetrain, colors, title status, location, seller, the written listing sections (highlights, equipment, modifications, known flaws, service history, ownership history, seller notes, other items), videos, history report link, bid/comment/watcher/view counts, start and end time, current high bid, sale price and buyer when the site publishes them. Photos (often 100-200) are returned only with `include_photos: true`.
- Instructions: Full detail for an auction id from `search_auctions`, a sitemap or a pasted https://carsandbids.com/auctions/{id}/{slug} URL.
- Cost: 5 credits per call
- Capability file: [Auction](https://firecrawl.dev/alexandria/agents/providers/carsandbids-com/car-auctions/auction)

Accepted options:
- `auction_id` (string): 8-character Cars & Bids auction id, e.g. `K1N4Qwxx` (the segment after /auctions/ in a listing URL, and `id` in search results). Pattern: ^[A-Za-z0-9]{8}$. Example: `K1N4Qwxx`
- `include_photos` (boolean): Include the full photo gallery (exterior, interior, mechanical, docs, other) with rendered URLs. Example: `false`
- `url` (string): Listing URL https://carsandbids.com/auctions/{id}/{slug}; alternative to `auction_id`. Example: `auction_id`

Response schema example:
```json
{
  "body_style_code": 1,
  "canceled_message": null,
  "currency": "USD",
  "drive_train_code": 2,
  "engine": "4.0L Flat-6",
  "exterior_color": "Paint-to-Sample Maritime Blue",
  "featured": true,
  "highlighted_points": [
    "Clean Carfax history report",
    "Sport Chrono Package",
    "Porsche Ceramic Composite Brakes (PCCB)"
  ],
  "history_report": {
    "expiry": "2027-02-06T23:12:40.000+00:00",
    "url": "https://www.carfax.com/vehiclehistory/ar20/2siCobYvThBME9t_8jfgvBsS2bgYvQRvaGbEu-WAaLKQAgqHzPkBGKxopZf0_YpiV9cDZFiJXrb7ik0FpHeu1o08-4cLpl4So9tUc8wg",
    "vendor": "carfax"
  },
  "id": "rbG4LbL9",
  "inspection_report_url": null,
  "interior_color": "Black/Blue",
  "is_notable": false,
  "location": "Corvallis, OR 97330",
  "main_photo_url": "https://media.carsandbids.com/cdn-cgi/image/width=768,quality=70/c51905b0000b639a185eeb080dd879bf007f5604/photos/application/s-siHPVGi/edit/PvU-w.jpg?t=178904233970",
  "make": "Porsche",
  "make_slug": "porsche",
  "mileage": 6500,
  "mileage_text": null,
  "model": "718 Cayman",
  "model_slug": "718-cayman",
  "no_reserve": false,
  "observed_at_ms": 1791589666733,
  "photo_count": 100,
  "sections": {
    "doug": null,
    "equipment": "A partial list of notable equipment reported by the seller includes:\n- Weissach Package\n- Sport Chrono Package\n- Front-axle lift system\n- Porsche Ceramic Composite Brakes (PCCB)\n- 20-inch center-locking forged magnesium wheels\n- Bose sound system",
    "highlights": "THIS... is a 2023 Porsche 718 Cayman GT4 RS Weissach Package, finished in paint-to-sample Maritime Blue with a black and blue interior.\n- The odometer on this Cayman GT4 RS currently displays approximately 6,500 miles.\n- This Porsche is offered with a clean `Carfax` vehicle history report.\n- A partial list of notable equipment reported by the seller includes the Weissach and Sport Chrono packages, a front-axle lift system, Porsche Ceramic Composite Brakes (PCCB), and a Bose sound system. The seller reports no notable modifications.\n- Introduced in 2022, the Porsche 718 Cayman GT4 RS boasts a naturally aspirated 4.0-liter flat-6 engine derived from the 911 GT3, featuring a 9,000-rpm redline, six individual throttle bodies, and a carbon fiber airbox mounted directly behind the driver and passenger. The sole transmission choice is a 7-speed PDK with shortened gear ratios compared to the standard GT4.\n- Power comes from a 4.0-liter flat-6, rated at 493 horsepower and 331 lb-ft of torque. Output is sent to the rear wheels via a 7-speed PDK dual-clutch automatic transmission.",
    "known_flaws": null,
    "modifications": null,
    "other_items": "- 2 keys\n- Owner's manual",
    "ownership_history": "The seller reportedly purchased this Porsche in April 2025 and has added about 3,000 miles since.",
    "recent_service_history": "The attached `Carfax` history report shows that the following services have been performed:\n- April 2025 (3,599 miles): Four-wheel alignment performed\n- June 2024 (2,932 miles): Engine oil and filter changed\n- June 2023 (1,533 miles): Engine oil and filter changed",
    "seller_notes": null
  },
  "seller": {
    "id": "9eYPvG5g",
    "is_certified_seller": false,
    "username": "RadicalCarReview"
  },
  "seller_type_code": 1,
  "stats": {
    "auction_end": "2026-10-08T19:59:42.158+00:00",
    "auction_start": "2026-10-01T21:54:00.000+00:00",
    "bids": 18,
    "buyer_username": null,
    "comments": 49,
    "current_bid": 190500,
    "current_bidder_username": "jdgambleEB",
    "questions": 0,
    "sale_amount": null,
    "views": 12707,
    "watchers": 952
  },
  "status": "reserve_not_met",
  "sub_title": "493-hp Naturally-Aspirated Flat-6, Paint-To-Sample Maritime Blue, ~6,500 Miles",
  "title": "2023 Porsche 718 Cayman GT4 RS Weissach Package",
  "title_status": "Clean (OR)",
  "transmission": "automatic",
  "transmission_code": 1,
  "transmission_details": "7-Speed",
  "url": "https://carsandbids.com/auctions/rbG4LbL9/2023-porsche-718-cayman-gt4-rs-weissach-package",
  "videos": [
    {
      "duration_s": 103.8,
      "id": "3y2Lzj5L",
      "provider": "cloudflare_stream",
      "title": "Walkaround",
      "url": "https://customer-cuf69xprmkaqooxd.cloudflarestream.com/4f2c65664bd5a13dca88db949d5cfe7d/iframe"
    }
  ],
  "vin": "WP0AE2A87PS280214",
  "year": 2023
}
```

### Auction comments

- Capability: `car-auctions/auction_comments`
- Description: Comments and bids on one Cars & Bids auction, newest first, with the site's filters: everything interleaved (default), most upvoted, seller comments only, or bid history only. Each item carries the author's username, seller/bidder/staff flags and reputation, the text or bid amount in USD, upvotes, reply target, attachments and timestamp. Cursor pagination with `after_id`.
- Instructions: Bid history (`filter: bids`) or the discussion for an auction id from `search_auctions` or `auction`.
- Cost: 5 credits per call
- Capability file: [Auction comments](https://firecrawl.dev/alexandria/agents/providers/carsandbids-com/car-auctions/auction_comments)

Accepted options:
- `after_id` (string): Cursor: `next_after_id` from the previous page (the id of its last item). Pattern: ^[A-Za-z0-9]{8}$. Example: `next_after_id`
- `auction_id` (string, required): 8-character Cars & Bids auction id, e.g. `K1N4Qwxx` (the segment after /auctions/ in a listing URL, and `id` in search results). Pattern: ^[A-Za-z0-9]{8}$. Example: `K1N4Qwxx`
- `filter` (string): all = comments and bids newest first (site filter 1), top = most upvoted (2), seller = seller comments (3), bids = bid history only (4). Example: `all`
- `limit` (number): Items per page. Example: `20`

Response schema example:
```json
{
  "auction_id": "K1N4Qwxx",
  "count": 16,
  "currency": "USD",
  "filter": "bids",
  "items": [
    {
      "amount": 81500,
      "attachments": [],
      "deleted_at": null,
      "edited_at": null,
      "flags": null,
      "id": "KVVakXVz",
      "is_bidder": null,
      "is_seller": null,
      "is_staff": false,
      "pinned": false,
      "reply_to": null,
      "reputation": 0,
      "text": null,
      "timestamp": "2026-10-07T16:58:53.283+00:00",
      "type": "bid",
      "upvotes": 0,
      "user_id": "3oQewGEg",
      "username": "dl502",
      "verified": true
    },
    {
      "amount": 79991,
      "attachments": [],
      "deleted_at": null,
      "edited_at": null,
      "flags": null,
      "id": "3Re0opBX",
      "is_bidder": null,
      "is_seller": null,
      "is_staff": false,
      "pinned": false,
      "reply_to": null,
      "reputation": 7,
      "text": null,
      "timestamp": "2026-10-07T04:57:09.785+00:00",
      "type": "bid",
      "upvotes": 0,
      "user_id": "3oxbggxa",
      "username": "dm_dm_dm",
      "verified": true
    },
    {
      "amount": 78000,
      "attachments": [],
      "deleted_at": null,
      "edited_at": null,
      "flags": null,
      "id": "3veGXNJj",
      "is_bidder": null,
      "is_seller": null,
      "is_staff": false,
      "pinned": false,
      "reply_to": null,
      "reputation": 0,
      "text": null,
      "timestamp": "2026-10-07T03:25:38.272+00:00",
      "type": "bid",
      "upvotes": 0,
      "user_id": "3oQewGEg",
      "username": "dl502",
      "verified": true
    },
    {
      "amount": 77500,
      "attachments": [],
      "deleted_at": null,
      "edited_at": null,
      "flags": null,
      "id": "KPQG6g17",
      "is_bidder": null,
      "is_seller": null,
      "is_staff": false,
      "pinned": false,
      "reply_to": null,
      "reputation": 30,
      "text": null,
      "timestamp": "2026-10-07T02:06:07.499+00:00",
      "type": "bid",
      "upvotes": 0,
      "user_id": "9aZQ7l6l",
      "username": "MT911",
      "verified": true
    },
    {
      "amount": 77000,
      "attachments": [],
      "deleted_at": null,
      "edited_at": null,
      "flags": null,
      "id": "rxBdNq0B",
      "is_bidder": null,
      "is_seller": null,
      "is_staff": false,
      "pinned": false,
      "reply_to": null,
      "reputation": 0,
      "text": null,
      "timestamp": "2026-10-06T22:56:55.543+00:00",
      "type": "bid",
      "upvotes": 0,
      "user_id": "3oQewGEg",
      "username": "dl502",
      "verified": true
    },
    {
      "amount": 76000,
      "attachments": [],
      "deleted_at": null,
      "edited_at": null,
      "flags": null,
      "id": "9nGNq2zN",
      "is_bidder": null,
      "is_seller": null,
      "is_staff": false,
      "pinned": false,
      "reply_to": null,
      "reputation": 30,
      "text": null,
      "timestamp": "2026-10-06T22:49:18.691+00:00",
      "type": "bid",
      "upvotes": 0,
      "user_id": "9aZQ7l6l",
      "username": "MT911",
      "verified": true
    },
    {
      "amount": 75000,
      "attachments": [],
      "deleted_at": null,
      "edited_at": null,
      "flags": null,
      "id": "rNbMvvE7",
      "is_bidder": null,
      "is_seller": null,
      "is_staff": false,
      "pinned": false,
      "reply_to": null,
      "reputation": 7,
      "text": null,
      "timestamp": "2026-10-06T22:43:34.762+00:00",
      "type": "bid",
      "upvotes": 0,
      "user_id": "3oxbggxa",
      "username": "dm_dm_dm",
      "verified": true
    },
    {
      "amount": 70000,
      "attachments": [],
      "deleted_at": null,
      "edited_at": null,
      "flags": null,
      "id": "rNJyvJP7",
      "is_bidder": null,
      "is_seller": null,
      "is_staff": false,
      "pinned": false,
      "reply_to": null,
      "reputation": 0,
      "text": null,
      "timestamp": "2026-10-06T18:34:19.485+00:00",
      "type": "bid",
      "upvotes": 0,
      "user_id": "3oQewGEg",
      "username": "dl502",
      "verified": true
    },
    {
      "amount": 69420,
      "attachments": [],
      "deleted_at": null,
      "edited_at": null,
      "flags": null,
      "id": "KD4W7X2v",
      "is_bidder": null,
      "is_seller": null,
      "is_staff": false,
      "pinned": false,
      "reply_to": null,
      "reputation": 24,
      "text": null,
      "timestamp": "2026-10-06T14:33:46.999+00:00",
      "type": "bid",
      "upvotes": 0,
      "user_id": "KPAL2yoZ",
      "username": "SlickWilly616",
      "verified": true
    },
    {
      "amount": 62000,
      "attachments": [],
      "deleted_at": null,
      "edited_at": null,
      "flags": null,
      "id": "3gyZeeEo",
      "is_bidder": null,
      "is_seller": null,
      "is_staff": false,
      "pinned": false,
      "reply_to": null,
      "reputation": 31,
      "text": null,
      "timestamp": "2026-10-06T01:46:23.117+00:00",
      "type": "bid",
      "upvotes": 0,
      "user_id": "3yGDYLoa",
      "username": "mav911",
      "verified": true
    },
    {
      "amount": 58500,
      "attachments": [],
      "deleted_at": null,
      "edited_at": null,
      "flags": null,
      "id": "KDnRzpp9",
      "is_bidder": null,
      "is_seller": null,
      "is_staff": false,
      "pinned": false,
      "reply_to": null,
      "reputation": 34,
      "text": null,
      "timestamp": "2026-10-05T19:28:35.086+00:00",
      "type": "bid",
      "upvotes": 0,
      "user_id": "9WkebYP1",
      "username": "Oberland",
      "verified": true
    },
    {
      "amount": 58000,
      "attachments": [],
      "deleted_at": null,
      "edited_at": null,
      "flags": null,
      "id": "K1dqq7jG",
      "is_bidder": null,
      "is_seller": null,
      "is_staff": false,
      "pinned": false,
      "reply_to": null,
      "reputation": 4,
      "text": null,
      "timestamp": "2026-10-05T19:15:49.224+00:00",
      "type": "bid",
      "upvotes": 0,
      "user_id": "374m4vkp",
      "username": "andrewgl",
      "verified": true
    },
    {
      "amount": 51500,
      "attachments": [],
      "deleted_at": null,
      "edited_at": null,
      "flags": null,
      "id": "9llLVey2",
      "is_bidder": null,
      "is_seller": null,
      "is_staff": false,
      "pinned": false,
      "reply_to": null,
      "reputation": 1,
      "text": null,
      "timestamp": "2026-10-05T17:50:09.442+00:00",
      "type": "bid",
      "upvotes": 0,
      "user_id": "9lX6G5mE",
      "username": "76cpgc",
      "verified": true
    },
    {
      "amount": 50500,
      "attachments": [],
      "deleted_at": null,
      "edited_at": null,
      "flags": null,
      "id": "3OVPGa0k",
      "is_bidder": null,
      "is_seller": null,
      "is_staff": false,
      "pinned": false,
      "reply_to": null,
      "reputation": 34,
      "text": null,
      "timestamp": "2026-10-05T17:20:51.132+00:00",
      "type": "bid",
      "upvotes": 0,
      "user_id": "9WkebYP1",
      "username": "Oberland",
      "verified": true
    },
    {
      "amount": 50000,
      "attachments": [],
      "deleted_at": null,
      "edited_at": null,
      "flags": null,
      "id": "9QBRvwnD",
      "is_bidder": null,
      "is_seller": null,
      "is_staff": false,
      "pinned": false,
      "reply_to": null,
      "reputation": 49,
      "text": null,
      "timestamp": "2026-10-05T17:01:36.463+00:00",
      "type": "bid",
      "upvotes": 0,
      "user_id": "KPZPv4MQ",
      "username": "n2disco",
      "verified": true
    },
    {
      "amount": 100,
      "attachments": [],
      "deleted_at": null,
      "edited_at": null,
      "flags": null,
      "id": "3OWPvDAg",
      "is_bidder": null,
      "is_seller": null,
      "is_staff": false,
      "pinned": false,
      "reply_to": null,
      "reputation": 13,
      "text": null,
      "timestamp": "2026-10-05T17:01:05.680+00:00",
      "type": "bid",
      "upvotes": 0,
      "user_id": "KmzWbgbr",
      "username": "mdarda",
      "verified": true
    }
  ],
  "next_after_id": null,
  "observed_at_ms": 1791589676072
}
```

### Search auctions

- Capability: `car-auctions/search_auctions`
- Description: Search Cars & Bids auctions: live auctions (default) or closed past auctions, by free text, model-year range, transmission and featured flag, with the site's sort modes and offset pagination (up to 100 per page). Each result is a listing card: id, title, location, mileage, current bid or sale price in USD, end time, status, seller and main photo.
- Instructions: Find auctions or past results; take `auctions[].id` into `auction` and `auction_comments`, `seller_username` into `user_profile`.
- Cost: 5 credits per call
- Capability file: [Search auctions](https://firecrawl.dev/alexandria/agents/providers/carsandbids-com/car-auctions/search_auctions)

Accepted options:
- `end_year` (number): Latest model year. Example: `1900`
- `featured` (boolean): Only featured listings when true. Example: `false`
- `limit` (number): Results per page; the site caps at 100. Example: `50`
- `offset` (number): Zero-based offset for the next page; use `next_offset` from the previous result. Example: `0`
- `query` (string): Free-text search (make, model, trim, keywords), e.g. `Porsche 991 911`. Example: `Porsche 991 911`
- `sort` (string): Site sort mode. Live: ending_soon (default), newly_listed, no_reserve, lowest_mileage, random. Closed: recently_ended (default), lowest_mileage, highest_mileage, lowest_price, highest_price. ending_soon and recently_ended are the same site code (1). Example: `ending_soon`
- `start_year` (number): Earliest model year. Example: `1900`
- `status` (string): `live` = auctions open now (site default), `closed` = past auctions (sold, sold after, reserve not met). Example: `live`
- `transmission` (string): transmission Example: `automatic`

Response schema example:
```json
{
  "auctions": [
    {
      "auction_end": "2025-09-11T17:20:44.027+00:00",
      "current_bid": 122513,
      "featured": true,
      "featured_sub_title": "81 Miles, 1 Owner",
      "has_inspection": false,
      "id": "KYz8jGpM",
      "is_notable": false,
      "location": "Rockville, MD 20850",
      "main_photo_url": "https://media.carsandbids.com/cdn-cgi/image/width=768,quality=70/4822e9034b0b6b357b3f73fabdfc10e586c36f68/photos/rJYdDE8w-DrM1hF1esS/edit/A2sK2.jpg?t=175638751986",
      "mileage": "81 Miles",
      "no_reserve": false,
      "sale_amount": null,
      "seller_username": "vagalex",
      "status": "reserve_not_met",
      "sub_title": "81 Miles, 1 Owner, V8 Power, Competition Package, Fire Orange, Unmodified",
      "title": "2013 BMW M3 Coupe Lime Rock Park Edition",
      "transmission": "automatic",
      "transmission_code": 1,
      "url": "https://carsandbids.com/auctions/KYz8jGpM/2013-bmw-m3-coupe-lime-rock-park-edition"
    },
    {
      "auction_end": "2026-09-23T17:51:44.229+00:00",
      "current_bid": 120000,
      "featured": true,
      "featured_sub_title": "51k Miles, 1 Owner",
      "has_inspection": false,
      "id": "9nBvZwjp",
      "is_notable": true,
      "location": "Lake City, FL 32025",
      "main_photo_url": "https://media.carsandbids.com/cdn-cgi/image/width=768,quality=70/9004500a220bf3a3d455d15ee052cf8c332606f8/photos/KZnQ5lgG-IgK78gl/edit/wGdhL.jpg?t=178898054017",
      "mileage": "51,100 Miles",
      "no_reserve": false,
      "sale_amount": 120000,
      "seller_username": "DelSchier",
      "status": "sold",
      "sub_title": "One Owner Since New, 51k Miles, Mostly Unmodified",
      "title": "1988 BMW M3",
      "transmission": "manual",
      "transmission_code": 2,
      "url": "https://carsandbids.com/auctions/9nBvZwjp/1988-bmw-m3"
    },
    {
      "auction_end": "2026-02-10T20:59:54.985+00:00",
      "current_bid": 111500,
      "featured": true,
      "featured_sub_title": "~6,300 Miles, M Carbon Ceramic Brakes",
      "has_inspection": false,
      "id": "9aqMYa0Q",
      "is_notable": false,
      "location": "La Jolla, CA 92037",
      "main_photo_url": "https://media.carsandbids.com/cdn-cgi/image/width=768,quality=70/8e6341e27a680ffab7d98e42bef83b0dd1b0fb94/photos/KPXG66VK-GD4lZLl/edit/pviy2.jpg?t=176990537112",
      "mileage": "6,300 Miles",
      "no_reserve": false,
      "sale_amount": null,
      "seller_username": "Carlos_M3_CS",
      "status": "reserve_not_met",
      "sub_title": "~6,300 Miles, Twin-Turbo 6-Cylinder, M Carbon Ceramic Brakes, Brooklyn Grey",
      "title": "2024 BMW M3 CS",
      "transmission": "automatic",
      "transmission_code": 1,
      "url": "https://carsandbids.com/auctions/9aqMYa0Q/2024-bmw-m3-cs"
    }
  ],
  "count": 3,
  "currency": "USD",
  "next_offset": 3,
  "observed_at_ms": 1791589661180,
  "offset": 0,
  "query": "bmw m3",
  "sort": "highest_price",
  "status": "closed",
  "total": 1205
}
```

### Similar auctions

- Capability: `car-auctions/similar_auctions`
- Description: Auctions Cars & Bids lists as similar to one auction (same listing-card shape as `search_auctions`: id, title, location, mileage, current bid or sale price in USD, end time, status, seller, main photo).
- Instructions: Comparable listings and recent results for an auction id.
- Cost: 5 credits per call
- Capability file: [Similar auctions](https://firecrawl.dev/alexandria/agents/providers/carsandbids-com/car-auctions/similar_auctions)

Accepted options:
- `auction_id` (string, required): 8-character Cars & Bids auction id, e.g. `K1N4Qwxx` (the segment after /auctions/ in a listing URL, and `id` in search results). Pattern: ^[A-Za-z0-9]{8}$. Example: `K1N4Qwxx`

Response schema example:
```json
{
  "auction_id": "K1N4Qwxx",
  "auctions": [
    {
      "auction_end": "2026-10-13T17:30:00.000+00:00",
      "current_bid": 80000,
      "featured": false,
      "featured_sub_title": null,
      "has_inspection": false,
      "id": "9QXNM1E7",
      "is_notable": false,
      "location": "Corpus Christi, TX 78415",
      "main_photo_url": "https://media.carsandbids.com/cdn-cgi/image/width=768,quality=70/39ba75f9b610a05237adc3ca976891cd48f5832c/photos/exterior/350eeB5j-Pa_2O6y/edit/lkN7A.jpg?t=179122008758",
      "mileage": "17,700 Miles",
      "no_reserve": false,
      "sale_amount": null,
      "seller_username": "jfmbass5",
      "status": "live",
      "sub_title": "18k Miles, 7-Speed Manual, Twin-Turbo Flat-6, Carmine Red, Texas-Owned",
      "title": "2018 Porsche 911 Carrera GTS Coupe",
      "transmission": "manual",
      "transmission_code": 2,
      "url": "https://carsandbids.com/auctions/9QXNM1E7/2018-porsche-911-carrera-gts-coupe"
    },
    {
      "auction_end": "2026-10-15T17:36:00.000+00:00",
      "current_bid": 29119,
      "featured": false,
      "featured_sub_title": null,
      "has_inspection": false,
      "id": "3vNAGz1O",
      "is_notable": false,
      "location": "Houston, TX 77098",
      "main_photo_url": "https://media.carsandbids.com/cdn-cgi/image/width=768,quality=70/44ee25cc89a69990193170a468c8ac4d6b8e8fcf/photos/Porsche911CarreraSCoupe2014008.jpg?t=178949908339",
      "mileage": "60,400 Miles",
      "no_reserve": true,
      "sale_amount": null,
      "seller_username": "orlandwright",
      "status": "live",
      "sub_title": "3.8L Flat-6, 60k Miles, Sport Chrono Package, Unmodified",
      "title": "2014 Porsche 911 Carrera S Coupe",
      "transmission": "automatic",
      "transmission_code": 1,
      "url": "https://carsandbids.com/auctions/3vNAGz1O/2014-porsche-911-carrera-s-coupe"
    },
    {
      "auction_end": "2026-10-16T17:39:00.000+00:00",
      "current_bid": 75000,
      "featured": false,
      "featured_sub_title": null,
      "has_inspection": false,
      "id": "9WnlGLoR",
      "is_notable": false,
      "location": "Arvada, CO 80003",
      "main_photo_url": "https://media.carsandbids.com/cdn-cgi/image/width=768,quality=70/9004500a220bf3a3d455d15ee052cf8c332606f8/photos/exterior/Km2X7b6d-h3ekrT3/edit/K_LgI.jpg?t=179138734040",
      "mileage": "93,200 Miles",
      "no_reserve": false,
      "sale_amount": null,
      "seller_username": "cwp0",
      "status": "live",
      "sub_title": "540-hp Twin-Turbo Flat-6, AWD, Kline Innovation Exhaust",
      "title": "2017 Porsche 911 Turbo Cabriolet",
      "transmission": "automatic",
      "transmission_code": 1,
      "url": "https://carsandbids.com/auctions/9WnlGLoR/2017-porsche-911-turbo-cabriolet"
    },
    {
      "auction_end": "2026-10-15T17:51:00.000+00:00",
      "current_bid": 27800,
      "featured": false,
      "featured_sub_title": null,
      "has_inspection": false,
      "id": "KYdkBQO0",
      "is_notable": false,
      "location": "Buckeye, AZ 85396",
      "main_photo_url": "https://media.carsandbids.com/cdn-cgi/image/width=768,quality=70/82c107f1e2403b82d1eed3a5c9dfc1991b9284ce/photos/PorscheBoxsterGTS2015008.jpg?t=179122071306",
      "mileage": "49,600 Miles",
      "no_reserve": false,
      "sale_amount": null,
      "seller_username": "Patrick44567",
      "status": "live",
      "sub_title": "330-hp 3.4L Flat-6, 7-Speed PDK, 50k Miles, GTS Premium Package Plus, Unmodified",
      "title": "2015 Porsche Boxster GTS",
      "transmission": "automatic",
      "transmission_code": 1,
      "url": "https://carsandbids.com/auctions/KYdkBQO0/2015-porsche-boxster-gts"
    },
    {
      "auction_end": "2026-10-17T18:12:00.000+00:00",
      "current_bid": 102000,
      "featured": true,
      "featured_sub_title": "7-Speed Manual, $13k+ in Options",
      "has_inspection": false,
      "id": "9QLNq1Mx",
      "is_notable": false,
      "location": "Rosamond, CA 93560",
      "main_photo_url": "https://media.carsandbids.com/cdn-cgi/image/width=768,quality=70/438ad923cef6d8239e95d61e7d6849486bae11d9/photos/3vYBWem9-v6sUb2mpEB.jpg?t=179106379956",
      "mileage": "15,300 Miles",
      "no_reserve": true,
      "sale_amount": null,
      "seller_username": "DanHarman",
      "status": "live",
      "sub_title": "Lightweight 992 Variant, 7-Speed Manual, $13K+ in Options",
      "title": "2023 Porsche 911 Carrera T Coupe",
      "transmission": "manual",
      "transmission_code": 2,
      "url": "https://carsandbids.com/auctions/9QLNq1Mx/2023-porsche-911-carrera-t-coupe"
    },
    {
      "auction_end": "2026-10-17T18:36:00.000+00:00",
      "current_bid": 68000,
      "featured": true,
      "featured_sub_title": "Rare Lightweight Model, 3k Miles",
      "has_inspection": false,
      "id": "9nLvNDJD",
      "is_notable": false,
      "location": "Rosamond, CA 93560",
      "main_photo_url": "https://media.carsandbids.com/cdn-cgi/image/width=768,quality=70/438ad923cef6d8239e95d61e7d6849486bae11d9/photos/9QZj1QL7-nwyGFanst2.jpg?t=179121040465",
      "mileage": "3,100 Miles",
      "no_reserve": true,
      "sale_amount": null,
      "seller_username": "KennanR",
      "status": "live",
      "sub_title": "Rare Lightweight 987.2 Cayman, 3k Miles, 6-Speed Manual, Sport Chrono Package",
      "title": "2012 Porsche Cayman R",
      "transmission": "manual",
      "transmission_code": 2,
      "url": "https://carsandbids.com/auctions/9nLvNDJD/2012-porsche-cayman-r"
    },
    {
      "auction_end": "2026-10-13T17:51:00.000+00:00",
      "current_bid": 50000,
      "featured": false,
      "featured_sub_title": null,
      "has_inspection": false,
      "id": "KdlQpwZp",
      "is_notable": false,
      "location": "Los Angeles, CA 90026",
      "main_photo_url": "https://media.carsandbids.com/cdn-cgi/image/width=768,quality=70/ee7f173e46ec801a48d1673c50f9cebaa1bf2854/photos/exterior/3qmmv6z3-H1CXaZj/edit/96aBO.jpg?t=179096744180",
      "mileage": "22,500 Miles",
      "no_reserve": false,
      "sale_amount": null,
      "seller_username": "alexeev",
      "status": "live",
      "sub_title": "434-hp Turbo V6, AWD, Bordeaux Red Interior, Premium Package Plus",
      "title": "2022 Porsche Macan GTS",
      "transmission": "automatic",
      "transmission_code": 1,
      "url": "https://carsandbids.com/auctions/KdlQpwZp/2022-porsche-macan-gts"
    },
    {
      "auction_end": "2026-10-14T19:03:00.000+00:00",
      "current_bid": 31250,
      "featured": false,
      "featured_sub_title": null,
      "has_inspection": false,
      "id": "rkE24A2l",
      "is_notable": false,
      "location": "Sarasota, FL 34234",
      "main_photo_url": "https://media.carsandbids.com/cdn-cgi/image/width=768,quality=70/39ba75f9b610a05237adc3ca976891cd48f5832c/photos/rMVyeeLZ-7vdhahe/edit/GxJAx.jpg?t=179105675890",
      "mileage": "7,500 Miles",
      "no_reserve": false,
      "sale_amount": null,
      "seller_username": "AlexRusso",
      "status": "live",
      "sub_title": "Rare Sport Model, #544 of 700 Produced, 7k Miles, 1 Owner, 6-Speed Manual",
      "title": "2008 Porsche Cayman S Sport",
      "transmission": "manual",
      "transmission_code": 2,
      "url": "https://carsandbids.com/auctions/rkE24A2l/2008-porsche-cayman-s-sport"
    },
    {
      "auction_end": "2026-10-14T19:54:00.000+00:00",
      "current_bid": 47500,
      "featured": false,
      "featured_sub_title": null,
      "has_inspection": false,
      "id": "rwgyj00l",
      "is_notable": false,
      "location": "San Diego, CA 92130",
      "main_photo_url": "https://media.carsandbids.com/cdn-cgi/image/width=768,quality=70/d32c8dde23a1411d0ef2e05bea168897e96c369b/photos/rGoJvEmd-hS5PpqY/edit/QWq4f.jpg?t=179063498495",
      "mileage": "29,100 Miles",
      "no_reserve": false,
      "sale_amount": null,
      "seller_username": "PorschePanameraCali",
      "status": "live",
      "sub_title": "1 Owner, 443-hp Twin-Turbo V6, AWD, California-Owned, Unmodified",
      "title": "2022 Porsche Panamera 4S",
      "transmission": "automatic",
      "transmission_code": 1,
      "url": "https://carsandbids.com/auctions/rwgyj00l/2022-porsche-panamera-4s"
    },
    {
      "auction_end": "2026-10-16T18:54:00.000+00:00",
      "current_bid": 200,
      "featured": false,
      "featured_sub_title": null,
      "has_inspection": false,
      "id": "rk641ael",
      "is_notable": false,
      "location": "Toronto, ON, Canada",
      "main_photo_url": "https://media.carsandbids.com/cdn-cgi/image/width=768,quality=70/9004500a220bf3a3d455d15ee052cf8c332606f8/photos/3OAPbdRm-ifKo3lA/edit/RhZCS.jpg?t=179147144609",
      "mileage": "48,300 Miles",
      "no_reserve": false,
      "sale_amount": null,
      "seller_username": "rahls7",
      "status": "live",
      "sub_title": "Twin-Turbo V6, AWD, Highly Equipped, Aventurine Green Metallic",
      "title": "2023 Porsche Panamera 4 Sport Turismo",
      "transmission": "automatic",
      "transmission_code": 1,
      "url": "https://carsandbids.com/auctions/rk641ael/2023-porsche-panamera-4-sport-turismo"
    }
  ],
  "count": 10,
  "currency": "USD",
  "observed_at_ms": 1791589687543
}
```

### Suggest

- Capability: `car-auctions/suggest`
- Description: Search-box suggestions from Cars & Bids for a partial make/model text, e.g. `bmw m3` -> `BMW E46 M3`, `BMW E36 M3`, ... Each suggestion is a query string for `search_auctions`.
- Instructions: Resolve a loose car name to the search phrases the site itself proposes before calling `search_auctions`.
- Cost: 5 credits per call
- Capability file: [Suggest](https://firecrawl.dev/alexandria/agents/providers/carsandbids-com/car-auctions/suggest)

Accepted options:
- `text` (string, required): Partial search text. Example: `<text>`

Response schema example:
```json
{
  "count": 6,
  "observed_at_ms": 1791589654146,
  "predictions": [
    "BMW E46 M3",
    "BMW E36 M3",
    "BMW F80 M3",
    "BMW E30 M3",
    "BMW G80 M3",
    "BMW E9X M3"
  ],
  "text": "bmw m3"
}
```

### User profile

- Capability: `car-auctions/user_profile`
- Description: A Cars & Bids member profile by username: id, reputation, verification and certified-seller flags, bio, join date, follower counts; optionally one history section: the cars they auctioned (`auction_history`), the auctions they bid on with their bid counts and wins (`bid_history`), or their recent comments (`comments`).
- Instructions: Seller or bidder background for a `seller_username` from `search_auctions` / `auction` or a `username` from `auction_comments`.
- Cost: 5 credits per call
- Capability file: [User profile](https://firecrawl.dev/alexandria/agents/providers/carsandbids-com/car-auctions/user_profile)

Accepted options:
- `section` (string): Optional history section to fetch in the same call. Example: `auction_history`
- `url` (string): Profile URL https://carsandbids.com/user/{username}; alternative to `username`. Example: `<url>`
- `username` (string): Member username as shown on the site (case as displayed), e.g. `E39silverm5`. Pattern: ^[A-Za-z0-9_.-]+$. Example: `E39silverm5`

Response schema example:
```json
{
  "currency": "USD",
  "observed_at_ms": 1791589681950,
  "profile": {
    "bio": "",
    "created_at": "2020-12-10T23:42:35.560775+00:00",
    "followers_count": 0,
    "following_count": 0,
    "id": "3z8xjXLN",
    "is_certified_seller": false,
    "is_verified": true,
    "region": null,
    "reputation": 33,
    "url": "https://carsandbids.com/user/E39silverm5",
    "username": "E39silverm5"
  }
}
```
