# Bring a Trailer Bids API Documentation

Retrieve the live Bring a Trailer bid feed: the count of active listings and the current highest bids with the amount in USD, the end time as ISO 8601 UTC, the listing ID, the title and the listing URL.

- **Documentation:** [https://scrappa.co/docs/bring-a-trailer-api/bring_a_trailer_bids](https://scrappa.co/docs/bring-a-trailer-api/bring_a_trailer_bids)
- **API group:** Bring a Trailer API
- **Endpoint:** `GET https://scrappa.co/api/bring-a-trailer/v1/bids`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/bring-a-trailer/v1/bids"
```

## Example response

```json
{
    "success": true,
    "data": {
        "active_listings_count": 1285,
        "bids": [
            {
                "amount": 115000,
                "ends_at": "2026-10-12T19:27:00+00:00",
                "listing": 124039509,
                "title": "14k-Mile 2017 Mercedes-AMG S65 Cabriolet",
                "url": "https://bringatrailer.com/listing/2017-mercedes-amg-s65-cabriolet-7/"
            }
        ]
    },
    "meta": {
        "endpoint_family": "bids"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | A public parameter is invalid. This response is not billable. |  |
|  | Bring a Trailer returned an unexpected response. This response is not billable. |  |
|  | Bring a Trailer did not return usable data for this request. This response is not billable. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)