bringatrailer.com APIbringatrailer.com ↗
Access live auctions, completed sale results, price trends, and vehicle details from Bring a Trailer via a structured JSON API with 8 endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/0ea2dbf8-cbae-4a6b-90d3-149278f4a294/get_current_auctions' \ -H 'X-API-Key: $PARSE_API_KEY'
Get currently live auctions on Bring a Trailer. Returns all active auction listings with bid amounts, titles, URLs, and metadata.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of active auction listing objects with title, url, current_bid, timestamp_end, and other metadata",
"locations": "array of location filter options with country groupings"
},
"sample": {
"data": {
"items": [
{
"id": 109807664,
"url": "https://bringatrailer.com/listing/superformance-gt40-mk-i/",
"year": "1965",
"title": "Fuel-Injected, Shelby 496 FE-Powered Superformance GT40 Mk I",
"active": true,
"premium": true,
"noreserve": false,
"current_bid": 210000,
"country_code": "US",
"timestamp_end": 1778778000,
"current_bid_formatted": "USD $210,000"
}
],
"locations": [
{
"id": "NA",
"title": "North America",
"countries": [
{
"id": "US",
"title": "United States"
}
]
}
]
},
"status": "success"
}
}About the bringatrailer.com API
The Bring a Trailer API covers 8 endpoints that expose live auction listings, completed sale results, and per-model pricing statistics from bringatrailer.com. The get_price_trends endpoint returns count, min, max, average, and median sale prices for any make/model combination, while get_current_auctions surfaces every active listing with real-time bid amounts and end timestamps — no account or manual site browsing required.
Live Auctions and Completed Results
The get_current_auctions endpoint returns all active BaT listings as an array of objects, each with title, url, current_bid, timestamp_end, and location metadata. The get_auction_results endpoint returns recently completed auctions including sold_text, current_bid, items_total, and pages_total. Note that only page 1 of completed results is reliably supported — higher pages may time out due to upstream server limitations.
Model-Level Search and Directory
Use search_listings with any query string (e.g. 'Porsche 911') to get back matching model pages and listing categories, each with url, title, destination, and result_type. When you need valid make/model slugs for other endpoints, get_makes_and_models_directory returns the full catalog with each model's name, url, and slug — no guessing at slug formatting.
Pricing Statistics and Trend Comparison
get_model_auction_results accepts make, model, optional page, and an optional recency filter ('1Y', '2Y', '3Y', or '5Y') and returns paginated completed listings plus a stats object with sold and unsold arrays containing price and timestamp data. For lighter-weight pricing queries, get_price_trends returns avg, median, min, max, and count in a single object. The get_price_trend_comparison endpoint computes year-over-year shift: it returns recent_avg, older_avg, recent_count, older_count, and percent_change for the trailing 12 months versus the preceding 12 months.
Individual Listing Detail
get_listing_detail accepts a full listing URL or slug and returns the title, a stats object with structured listing essentials, json_ld structured data objects, and a theme_data object with post-level configuration. This is the endpoint to use when you need the complete picture on a single vehicle.
- Track real-time bid activity on live BaT auctions using
current_bidandtimestamp_endfromget_current_auctions. - Build a collector car valuation tool using
avg,median,min, andmaxfromget_price_trendsfor a given make/model. - Detect rising or falling market demand by comparing
recent_avgvsolder_avgfromget_price_trend_comparison. - Populate a historical auction database by paginating
get_model_auction_resultswithrecencyset to'5Y'. - Resolve valid make/model slugs before querying pricing endpoints using
get_makes_and_models_directory. - Display full vehicle provenance and structured metadata for a listing using
json_ldandstatsfromget_listing_detail. - Autocomplete make/model search in a car research app using
resultsfromsearch_listings.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Bring a Trailer offer an official developer API?+
What does the `recency` parameter control in `get_model_auction_results` and `get_price_trends`?+
recency parameter filters results to a trailing time window. Accepted values are '1Y' (12 months), '2Y', '3Y', and '5Y'. Omitting it returns results across all available history. Both get_model_auction_results and get_price_trends support this parameter.Are there pagination limitations on `get_auction_results`?+
get_model_auction_results supports full pagination.Does the API return bidder history or individual bid events for a listing?+
Can I filter live auctions by make, model, or location?+
get_current_auctions returns all active listings at once along with a locations array of location filter options, but does not accept make, model, or keyword filter inputs directly. You can fork this API on Parse and revise the endpoint to add server-side filtering by those parameters.