Collector vehicle auction research
Mit Bring a Trailer-Endpunkten verwandelst du collector vehicle auction research in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Übersetzung in Arbeit. Diese Seite wird vorübergehend auf Englisch angezeigt, während die deutsche Übersetzung vorbereitet wird.
Marktplätze & Handel6 aktive EndpunkteapiKey
Bring a Trailer auction research API
Separate an auction that is still open from a completed sale, and use BaT's own make and model directory to carry valid IDs into search and price-history requests.
Track Bring a Trailer live auctions and completed collector-vehicle sales with make and model discovery, filters, listing details, and price history.
Endpunkt-Familien
6
Dokumentierte Parameter
38
Beispiele
6
Live-Katalog-Snapshot
Bring a Trailer-Abdeckung
Aktive Endpunkte
6
Methoden
GET
Pflichtparameter
8
Schema-Referenzen
6
Filters1
Listing1
Live1
Makes1
{
"platform": "Bring a Trailer",
"endpoint": "bringatrailer-live",
"method": "GET",
"path": "/bringatrailer/live",
"auth": "apiKey"
}Use Cases
Workflows, die zu Bring a Trailer passen
Track Bring a Trailer live auctions and completed collector-vehicle sales with make and model discovery, filters, listing details, and price history.
Completed sale and reserve analysis
Mit Bring a Trailer-Endpunkten verwandelst du completed sale and reserve analysis in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Live auction monitoring
Mit Bring a Trailer-Endpunkten verwandelst du live auction monitoring in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Managed Execution
So verarbeitet Crawlora diese Plattform
Jede Zahl unten stammt direkt aus dem Live-Bring a Trailer-Endpunktkatalog — 6 Endpunkte, 38 dokumentierte Request-Parameter und 6 veröffentlichte Response-Schemas — demselben Katalog, gegen den auch Docs und Playground laufen.
Documented endpoint coverage
6 documented Bring a Trailer endpoints, grouped into 6 request families — Filters, Listing and Live, plus 3 more.
Published request surface
38 request parameters are documented across those Bring a Trailer endpoints, 8 of them required — the full input contract is public before you write any integration code.
Known response shape
6 of the 6 Bring a Trailer endpoints ship a recorded example response, and 6 carry a documented response schema — you can code against the real JSON before the first request.
Documented failure modes
Bring a Trailer endpoints document their error responses (400, 404, 429 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
Agent-callable MCP tools
6 hosted MCP tools back the Bring a Trailer endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Abdeckungskarte
Wissen, was die API sammeln kann, bevor du integrierst
1 Endpunkte
Filters
/bringatrailer/filters
GETapiKey
1 Endpunkte
Listing
/bringatrailer/listing
GETapiKey
1 Endpunkte
Live
/bringatrailer/live
GETapiKey
1 Endpunkte
Makes
/bringatrailer/makes
GETapiKey
1 Endpunkte
Results
/bringatrailer/results
GETapiKey
1 Endpunkte
Suggest
/bringatrailer/suggest
GETapiKey
Endpunktkatalog
Bring a Trailer-API-Endpunkte
GETapiKeyexample
/bringatrailer/liveList live Bring a Trailer auctions
Returns the auctions currently open on Bring a Trailer (about 1,300) with current bid, end time and attributes. Filter by title text, category, decade, country, ending window, maximum current bid and the premium and no-reserve flags; sort by ending soon, highest bid or lowest bid.
Hinweise zur Response
- `live_total` is the number of open auctions before filtering and `total` the number after. - `status` is always `live`; `price` is the current bid and `ends_at` the scheduled close in UTC. A few auctions with no bids yet have `price: 0`. - Unlike the archive, live rows carry `year`, `era`, `categories` (category ids), `country` and `country_code`. - The live toolbar also offers an origin filter, but live rows carry no origin field, so it is not offered here. - Filtering that matches nothing returns `total: 0` and `auctions: []`.
MCP-Tool bringatrailer_live
q:querycategory:queryera:query+9 weitere
GETapiKeyexample
/bringatrailer/makesBring a Trailer makes and models
Returns Bring a Trailer's Makes and Models Directory: every make with its model pages and the numeric model_id that bringatrailer_results accepts. Narrow with q (matches make or model names) or make (exact slug).
Hinweise zur Response
- `makes[].name` is the value the `make` parameter of `bringatrailer-results` expects; `makes[].slug` is the value this endpoint's own `make` parameter expects. - `models[].model_id` is the value the `model_id` parameter expects. It is read from the directory's notification links, so a model without one is skipped rather than guessed. - Some makes have no model pages and return `models: []`. - `total_makes` and `total_models` count the returned makes after filtering.
MCP-Tool bringatrailer_makes
q:querymake:queryx-api-key:header
GETapiKeyexample
/bringatrailer/filtersList Bring a Trailer filter values
Returns the complete value space of every bringatrailer_results filter: vehicle categories, decades, origins, regions with their countries, sort orders, results, auction types, recency windows, maximum-bid presets and the per_page range.
MCP-Tool bringatrailer_filters
x-api-key:header
GETapiKeyexample
/bringatrailer/resultsBring a Trailer completed auctions
Pages through Bring a Trailer's archive of completed collector-vehicle auctions with final bids and sold or reserve-not-met results. Filter by make or model (ids from bringatrailer_makes), keyword, category, decade, origin, country, result, premium or no-reserve type, recency, model-year range, maximum bid and sort order. Every filter value is listed by bringatrailer_filters.
Hinweise zur Response
- `status` is `sold`, `reserve_not_met`, `withdrawn` (BaT pulled the auction) or `ended` (an old auction with no sale record, for example `Auction closed on 8/13/2014`); `result_text` is the site's own wording (for example `Sold for USD $127,000 on 11/1/2026`) and `ends_at` is the close time in UTC. - Archive rows do not carry `year`, `era`, `categories` or `country`; those fields appear only on live auctions (`bringatrailer-live`) and are omitted here. Use `bringatrailer-listing` for full detail. - `model_ids` are the keyword-page ids the listing is tagged with and can be passed back as `model_id`. - Zero matches return `total: 0` and `auctions: []`, not an error. Requesting a page past the last one also returns `total: 0` (the upstream reports no total there), so use `total_pages` from an earlier page to know where the archive ends. - `price` is `0` when no bid is recorded (old auctions, withdrawn auctions). - The upstream asks crawlers to wait one second between requests (robots.txt `Crawl-delay: 1`); callers paging in a loop should pace themselves.
MCP-Tool bringatrailer_results
make:querymodel_id:queryq:query+15 weitere
GETapiKeyexample
/bringatrailer/listingGet one Bring a Trailer auction
Returns one auction's detail: status, sold or high bid, end time, bid count, comments, views, watchers, seller, location, chassis, listing details, description and lead image. Pass the slug from /listing/{slug}/ or the full listing URL returned by the other endpoints.
Hinweise zur Response
- `status` is `sold`, `reserve_not_met`, `withdrawn`, `live` or `ended`. A withdrawn auction has no price or bids and carries the withdrawal date in `ends_at`; `ended` is an old auction with no recorded sale (its `price` is `0` when no high bid was recorded). `price` is the winning or high bid (a live auction's current bid) with `currency`, which can be USD, GBP, EUR, CAD, AUD and others (`Sold for GBP £2,100` is `2100` `GBP`); `result_text` is the site's wording. - `ends_at` is the close (or scheduled close) in UTC. For a live auction `result_text` is `Current bid …`. `bids`, `comments`, `views` and `watchers` are the page's counters at fetch time. - `seller`, `seller_url` and `location` come from the BaT Essentials box; `chassis` and `details` come from its Listing Details list (mileage, engine, transmission, colour and equipment as written by the seller). - `mileage`, `mileage_unit` (`miles` or `kilometers`), `mileage_text`, `mileage_rounded` and `mileage_unknown` are read from the mileage line. `mileage` is the number in the unit the seller stated (`187000` kilometers for `187k Kilometers (~116k Miles) Shown`); `mileage_rounded` is true when the seller wrote a `k` figure such as `24k`; `mileage_unknown` is true for a `TMU` (true mileage unknown) line, or when the mileage line itself ends in `, TMU` (a shown figure the seller says is not the true mileage). `mileage_text` is the seller's wording, including `Shown` qualifiers. - `engine`, `transmission`, `exterior_color` and `interior` are the seller's own list items, copied verbatim, when one clearly matches (for example `3.6-Liter V8`, `Six-Speed Manual Transaxle`, `Seal Grey Metallic Paint`, `Black Leather Upholstery`). They are best-effort: a line worded another way is left out of these fields but is always still in `details`. Treat an empty value as unknown, not as none. - `description` is the page's own summary paragraph and `image_url` the lead photo. The full photo gallery, comments and bid history are not returned. - Fields the page does not show are omitted rather than returned empty.
MCP-Tool bringatrailer_listing
slug:queryx-api-key:header
GETapiKeyexample
/bringatrailer/suggestBring a Trailer search suggestions
Returns Bring a Trailer's search-box completions for a term: make pages, model and generation pages, decades and categories. Era rows carry the decade id and category rows the category id that bringatrailer_results accepts as era and category; make rows can be passed by title as make. Use bringatrailer_makes for a model's numeric model_id.
Hinweise zur Response
- `type` is `make`, `model`, `era` or `category`. A `model` row covers both model pages and generation pages (a two-part `path` such as `porsche/911-turbo`). - `era` rows carry `id`, the decade id that the `era` parameter of `bringatrailer-results` and `bringatrailer-live` accepts. `category` rows carry `id`, the category id for `category`. Both were confirmed against the filter endpoints. - `make` rows have no `id`; pass the row's `title` as the `make` parameter of `bringatrailer-results`. `model` rows have no `id` either: the autocomplete id of a model or generation page is not reliably the numeric `model_id` (a generation page returned zero results when used as one), so look the model up in `bringatrailer-makes` instead. - A term with no matches returns `total: 0` and `suggestions: []`. The upstream returns at most about 10 rows.
MCP-Tool bringatrailer_suggest
term:queryx-api-key:header
Verwandte APIs
Weitere Abdeckung im Bereich marktplätze & handel
Marketplaces & Retail
Glovo
Treat Glovo as a local marketplace: discover the supported city first, then follow that city's category, store, menu, and collection identifiers through the catalog.
Marketplaces & Retail
PetSmart
Use PetSmart's hierarchical paths to scope product searches, then keep product SKU, price range, online availability, pickup eligibility, and store inventory as separate fields.
Marketplaces & Retail
Reverb
Research new, used, and vintage instruments across Reverb listings, seller shops, and the Price Guide. Keep current asking prices separate from historical sales, and preserve model, finish, year, condition, and currency when comparing gear.
So scrapst du Bring a Trailer
Bring a Trailer-Daten in 5 Schritten extrahieren
Bring a Trailer is an online vehicle-auction marketplace with enthusiast discussion around listings, rather than a fixed-price inventory catalog. Its buying and selling policies say the winning bid must be highest at auction close and exceed any seller reserve; BaT introduces buyer and seller, who handle the sale directly. On 2026-11-05, the live-auction route reported 1,367 open auctions overall; a 24-hour filter returned 228 matching entries, with Porsche lots among the first results. These are volatile auction snapshots, not valuations or verified condition reports.
- Schritt 1
Discover valid makes and models
Call bringatrailer-makes first. The live exact Porsche lookup returned one make and 187 model entries, each carrying a numeric model_id. Use the returned make name for completed-auction results and the model_id for model-specific results; do not guess numeric IDs from listing titles.
- Schritt 2
Separate open auctions from the archive
Use bringatrailer-live for active lots with current bid and end time. Its ending_within filter accepts only 1, 4, 24, 120, or 168 hours. Use bringatrailer-results for completed auctions and specify sold or unsold when reserve status matters.
- Schritt 3
Take filter values from the directory
bringatrailer-filters supplies category, decade, origin, and country values. On 2026-11-05 the live list returned a 1958 Porsche 356A Speedster with a current bid and a UTC end time; preserve those source fields and the capture timestamp when comparing auctions.
- Schritt 4
Resolve and summarize a listing
Use the listing slug from a live or completed result with bringatrailer-listing. Results are 1-based pages of 10–50 cards (36 by default); continue with page/per_page, not a cursor. The listing detail gives auction context, while completed results carry sold or reserve-not-met status; neither is an appraisal for a different vehicle.
- Schritt 5
Respect what the marketplace does not certify
BaT's policy places vehicle assessment, title, liens, registration, and transaction terms on buyers and sellers. A listing page and its comments are source material, not an independent inspection, title guarantee, or binding sales record.
FAQ
Bring a Trailer scrapen: häufige Fragen
How do I track active Bring a Trailer auctions?
Use bringatrailer-live, optionally narrowing by supported time windows, title, category, country, or maximum bid. Store the end time and current bid with each timestamped snapshot because both change during the auction.
How do I search completed Porsche auctions?
Get the exact make or model_id from bringatrailer-makes, then pass one of them to bringatrailer-results. That route searches completed auctions; use bringatrailer-live for open listings.
What can completed-auction results tell me?
They distinguish sold from reserve-not-met listings and return historical auction fields for the selected make, model, and filters. Condition, title, options, reserve, and market timing still require listing-level review and independent assessment.
Are listing details a verified inspection?
No. BaT's policies describe a marketplace that facilitates buyer-seller transactions and encourage buyers to make their own assessment. Structured listing fields and comments should not be represented as a title or mechanical guarantee.
Does this API include journalist or seller profiles?
No. The documented routes cover auctions, makes/models, listings, suggestions, filters, and price history; there is no author/byline route. A seller mentioned on a vehicle listing is not an editorial author profile.