{"id":"130132d2-01e5-433e-a941-995805be2e41","slug":"bringatrailer-com-api","name":"bringatrailer.com API","description":"API for Bring a Trailer (bringatrailer.com). Retrieve live and completed auction listings, search makes and models, fetch per-model pricing statistics and year-over-year trend comparisons, and pull full detail pages for individual listings.","front_facing_description":"Search live and historical Bring a Trailer auctions to find pricing trends, model comparisons, and detailed listing information for classic and collectible vehicles. Track auction results, compare price trends across models, and browse the complete directory of makes and models available on the platform.","source_url":"https://bringatrailer.com","is_authenticated":false,"canonical_scraper_id":"0ea2dbf8-cbae-4a6b-90d3-149278f4a294","apis":[{"method":"GET","endpoint_name":"get_current_auctions","description":"Retrieves all currently live auctions on Bring a Trailer. Each auction item includes the current bid amount, title, URL, end timestamp, location, and whether the listing has no reserve. The locations array provides geographic filter options.","input_params":{},"return_schema":{"type":"object","fields":{"items":"array of active auction listing objects","locations":"array of location filter groups with country listings"},"sample":{"data":{"items":[{"id":114965214,"url":"https://bringatrailer.com/listing/2007-lamborghini-murcielago-lp640-roadster-6/","year":"2007","title":"2007 Lamborghini Murcielago LP640 Roadster 6-Speed Conversion","country":"United States","excerpt":"This 2007 Lamborghini...","currency":"USD","noreserve":true,"current_bid":379000,"country_code":"US","timestamp_end":1781110800,"current_bid_formatted":"USD $379,000"}],"locations":[{"id":"NA","title":"North America","countries":[{"id":"CA","title":"Canada"},{"id":"US","title":"United States"}]}]},"status":"success"}},"initiates_session":false,"price":5,"verification":{"assertions":[{"path":"$.data.items","op":"array_min_len","value":1},{"path":"$.data.locations","op":"exists"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_auction_results","description":"Retrieves completed auction results with sale prices. Returns paginated listings sorted by most recently completed. Each item includes final bid amount, sold text with date, and listing metadata. Only page 1 is reliably supported; higher pages may time out.","input_params":{"page":{"type":"integer","required":false,"description":"Page number for pagination. Only page 1 is reliably supported.","default":1,"domain":{"kind":"open","example":1,"pattern":"^\\d+$","generator":{"type":"static","value":1}}}},"return_schema":{"type":"object","fields":{"items":"array of completed auction listing objects with sale prices","items_total":"integer total number of completed auctions","pages_total":"integer total number of pages","page_current":"integer current page number"},"sample":{"data":{"items":[{"id":115269664,"url":"https://bringatrailer.com/listing/2013-rolls-royce-phantom-drophead-coupe-5/","title":"13k-Mile 2013 Rolls-Royce Phantom Drophead Coupe","currency":"USD","noreserve":false,"sold_text":"Bid to USD $244,000 <span> on 6/11/2026 </span>","current_bid":244000,"country_code":"US","timestamp_end":1781214680,"current_bid_formatted":"USD $244,000"}],"items_total":247322,"pages_total":6871,"page_current":1},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.data.items","op":"array_min_len","value":1},{"path":"$.data.items_total","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"search_listings","description":"Searches for makes, models, or listings by keyword using autocomplete. Returns matching model pages and listing categories with URLs and destination IDs.","input_params":{"query":{"type":"string","required":true,"description":"Search keyword (e.g. 'Porsche 911', 'Ferrari', 'BMW M3').","domain":{"kind":"open","example":"Porsche 911","pattern":"^.+$","generator":{"type":"static","value":"Porsche 911"}}}},"return_schema":{"type":"object","fields":{"query":"string echoing the search query","results":"array of matching items with url, title, destination, and result_type"},"sample":{"data":{"query":"Porsche 911","results":[{"url":"https://bringatrailer.com/porsche/911-carrera-1974-1977/","title":"Porsche 911 1974-1977","destination":"47454972","result_type":"item"}]},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.data.query","op":"not_null"},{"path":"$.data.results","op":"array_min_len","value":1}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_model_auction_results","description":"Retrieves completed auctions for a specific make/model combination with optional time period filtering. Returns paginated auction results with pricing statistics including sold and unsold data points. Use search_listings or get_makes_and_models_directory to discover valid make/model slugs.","input_params":{"make":{"type":"string","required":true,"description":"Make slug in lowercase (e.g. 'porsche', 'ferrari', 'bmw').","domain":{"kind":"open","example":"porsche","pattern":"^[a-z][a-z0-9-]*$","generator":{"type":"static","value":"porsche"}}},"page":{"type":"integer","required":false,"description":"Page number for pagination.","default":1,"domain":{"kind":"open","example":1,"pattern":"^\\d+$","generator":{"type":"static","value":1}}},"model":{"type":"string","required":true,"description":"Model slug in lowercase (e.g. '911', '488', 'm3'). Use search_listings or get_makes_and_models_directory to find valid slugs.","domain":{"kind":"open","example":"911","pattern":"^[a-z0-9][a-z0-9-]*$","generator":{"type":"static","value":"911"}}},"recency":{"type":"string","required":false,"description":"Time period filter. Accepted values: '1Y', '2Y', '3Y', '5Y'.","enum":"Recency","domain":{"kind":"enum","values":["1Y","2Y","3Y","5Y"],"generator":{"type":"enum_pick","strategy":"first"}}}},"return_schema":{"type":"object","fields":{"items":"array of completed auction listings","stats":"object containing sold and unsold arrays with price/timestamp data points","items_total":"integer total matching auctions","pages_total":"integer total pages available","page_current":"integer current page number"},"sample":{"data":{"items":[{"id":114346727,"url":"https://bringatrailer.com/listing/1974-porsche-911-targa-29/","title":"Turbo-Look 1974 Porsche 911 Targa","excerpt":"This RoW 1974 Porsche...","currency":"USD","noreserve":false,"sold_text":"Sold for USD $75,000 on 6/4/2026","current_bid":75000,"country_code":"US","current_bid_formatted":"USD $75,000"}],"stats":{"sold":[{"title":"Turbo-Look...","amount":75000,"timestamp":1780598630}],"unsold":[{"amount":98000,"timestamp":1779993618}]},"items_total":743,"pages_total":31,"page_current":1},"status":"success"}},"initiates_session":false,"price":2,"verification":{"assertions":[{"path":"$.data.items_total","op":"not_null"},{"path":"$.data.pages_total","op":"not_null"}],"empty_is_valid":true,"recipe_version":1}},{"method":"GET","endpoint_name":"get_price_trends","description":"Computes pricing statistics for a specific make/model over a time period. Returns count, min, max, average, and median sale prices derived from completed auctions. Returns zeros when no sales data is available for the specified period.","input_params":{"make":{"type":"string","required":true,"description":"Make slug in lowercase (e.g. 'porsche', 'ferrari', 'bmw').","domain":{"kind":"open","example":"porsche","pattern":"^[a-z][a-z0-9-]*$","generator":{"type":"static","value":"porsche"}}},"model":{"type":"string","required":true,"description":"Model slug in lowercase (e.g. '911', '488', 'm3').","domain":{"kind":"open","example":"911","pattern":"^[a-z0-9][a-z0-9-]*$","generator":{"type":"static","value":"911"}}},"recency":{"type":"string","required":false,"description":"Time period for statistics. Accepted values: '1Y', '2Y', '3Y', '5Y'.","default":"1Y","enum":"Recency","domain":{"kind":"enum","values":["1Y","2Y","3Y","5Y"],"generator":{"type":"enum_pick","strategy":"first"}}}},"return_schema":{"type":"object","fields":{"avg":"number average sale price","max":"number highest sale price","min":"number lowest sale price","make":"string make slug","count":"integer number of sales in period","model":"string model slug","median":"number median sale price"},"sample":{"data":{"avg":56877.53,"max":321911,"min":350,"make":"porsche","count":566,"model":"911","median":46000},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.data.make","op":"not_null"},{"path":"$.data.count","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_price_trend_comparison","description":"Compares average sale prices between the most recent 12 months and the previous 12 months for a specific make/model. Useful for identifying whether a model is appreciating or depreciating. Returns zeros when no sales data is available.","input_params":{"make":{"type":"string","required":true,"description":"Make slug in lowercase (e.g. 'porsche', 'ferrari', 'bmw').","domain":{"kind":"open","example":"porsche","pattern":"^[a-z][a-z0-9-]*$","generator":{"type":"static","value":"porsche"}}},"model":{"type":"string","required":true,"description":"Model slug in lowercase (e.g. '911', '488', 'm3').","domain":{"kind":"open","example":"911","pattern":"^[a-z0-9][a-z0-9-]*$","generator":{"type":"static","value":"911"}}}},"return_schema":{"type":"object","fields":{"make":"string make slug","model":"string model slug","older_avg":"number average price in previous 12 months","recent_avg":"number average price in most recent 12 months","older_count":"integer number of sales in older 12 months","recent_count":"integer number of sales in recent 12 months","percent_change":"number percentage change from older to recent period"},"sample":{"data":{"make":"porsche","model":"911","older_avg":56556.94,"recent_avg":58107.83,"older_count":449,"recent_count":117,"percent_change":2.74},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.data.make","op":"not_null"},{"path":"$.data.recent_count","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_listing_detail","description":"Retrieves full details for a specific auction listing page including JSON-LD structured data (with Product offers/pricing when available), extracted listing essentials, and page metadata. Accepts either a full URL or a listing slug.","input_params":{"url":{"type":"string","required":true,"description":"Full listing URL (e.g. 'https://bringatrailer.com/listing/1977-porsche-911s-targa-77/') or listing slug (e.g. '1977-porsche-911s-targa-77').","domain":{"kind":"open","example":"https://bringatrailer.com/listing/2019-ferrari-488-pista-22/","pattern":"^https?://.+|^[a-z0-9-]+$","generator":{"type":"static","value":"https://bringatrailer.com/listing/2019-ferrari-488-pista-22/"}}}},"return_schema":{"type":"object","fields":{"url":"string full listing URL","stats":"object containing extracted listing essentials and details","title":"string listing title","json_ld":"array of JSON-LD structured data objects from the page","theme_data":"object containing BaT theme configuration including post ID"},"sample":{"data":{"url":"https://bringatrailer.com/listing/2019-ferrari-488-pista-22/","stats":{"listing_details":[]},"title":"3k-Mile 2019 Ferrari 488 Pista","json_ld":[{"name":"3k-Mile 2019 Ferrari 488 Pista","@type":"Product","offers":{"@type":"Offer","price":860000,"priceCurrency":"USD"},"@context":"http://schema.org"}],"theme_data":{"post":"114304529"}},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.data.title","op":"not_null"},{"path":"$.data.url","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}},{"method":"GET","endpoint_name":"get_makes_and_models_directory","description":"Retrieves the complete directory of all makes and their associated models available on Bring a Trailer. Each make includes an array of models with name, URL, and slug. Use slugs with get_model_auction_results, get_price_trends, and get_price_trend_comparison.","input_params":{},"return_schema":{"type":"object","fields":{"makes":"array of make objects each containing a make name and models array"},"sample":{"data":{"makes":[{"make":"Abarth","models":[{"url":"https://bringatrailer.com/abarth/750-850/","name":"Abarth 750 & 850","slug":"750-850"}]}]},"status":"success"}},"initiates_session":false,"price":10,"verification":{"assertions":[{"path":"$.data.makes","op":"array_min_len","value":1}],"empty_is_valid":false,"recipe_version":1}}],"sample_inputs":{"search_listings":{"query":"Porsche 911"},"get_price_trends":{"make":"porsche","model":"911","recency":"1Y"},"get_listing_detail":{"url":"https://bringatrailer.com/listing/2019-ferrari-488-pista-22/"},"get_auction_results":{"page":"1"},"get_model_auction_results":{"make":"porsche","page":"1","model":"911","recency":"1Y"},"get_price_trend_comparison":{"make":"porsche","model":"911"}},"prefill_inputs":{"get_auction_results":{"page":"1"},"search_listings":{"query":"Porsche 911"},"get_model_auction_results":{"make":"porsche","page":"1","model":"911","recency":"1Y"},"get_price_trends":{"make":"porsche","model":"911","recency":"1Y"},"get_price_trend_comparison":{"make":"porsche","model":"911"},"get_listing_detail":{"url":"https://bringatrailer.com/listing/2019-ferrari-488-pista-22/"}},"last_verified_at":"2026-10-27T23:04:25.294756+00:00","endpoint_health":[{"endpoint_name":"get_price_trend_comparison","status":"healthy","last_checked_at":"2026-10-27T23:04:25.294756+00:00","last_verified_at":"2026-10-27T23:04:25.294756+00:00","recent_runs":[{"at":"2026-10-27T23:04:25.294756+00:00","status":"healthy"},{"at":"2026-10-20T23:00:25.426476+00:00","status":"healthy"},{"at":"2026-10-13T22:04:25.212547+00:00","status":"healthy"},{"at":"2026-10-06T22:01:52.899466+00:00","status":"healthy"},{"at":"2026-09-29T21:04:52.916727+00:00","status":"healthy"}]},{"endpoint_name":"get_current_auctions","status":"healthy","last_checked_at":"2026-10-27T23:04:25.294756+00:00","last_verified_at":"2026-10-27T23:04:25.294756+00:00","recent_runs":[{"at":"2026-10-27T23:04:25.294756+00:00","status":"healthy"},{"at":"2026-10-20T23:00:25.426476+00:00","status":"healthy"},{"at":"2026-10-13T22:04:25.212547+00:00","status":"healthy"},{"at":"2026-10-06T22:01:52.899466+00:00","status":"healthy"},{"at":"2026-09-29T21:04:52.916727+00:00","status":"healthy"}]},{"endpoint_name":"get_auction_results","status":"healthy","last_checked_at":"2026-10-27T23:04:25.294756+00:00","last_verified_at":"2026-10-27T23:04:25.294756+00:00","recent_runs":[{"at":"2026-10-27T23:04:25.294756+00:00","status":"healthy"},{"at":"2026-10-20T23:00:25.426476+00:00","status":"healthy"},{"at":"2026-10-13T22:04:25.212547+00:00","status":"healthy"},{"at":"2026-10-06T22:01:52.899466+00:00","status":"healthy"},{"at":"2026-09-29T21:04:52.916727+00:00","status":"healthy"}]},{"endpoint_name":"search_listings","status":"healthy","last_checked_at":"2026-10-27T23:04:25.294756+00:00","last_verified_at":"2026-10-27T23:04:25.294756+00:00","recent_runs":[{"at":"2026-10-27T23:04:25.294756+00:00","status":"healthy"},{"at":"2026-10-20T23:00:25.426476+00:00","status":"healthy"},{"at":"2026-10-13T22:04:25.212547+00:00","status":"healthy"},{"at":"2026-10-06T22:01:52.899466+00:00","status":"healthy"},{"at":"2026-09-29T21:04:52.916727+00:00","status":"healthy"}]},{"endpoint_name":"get_model_auction_results","status":"healthy","last_checked_at":"2026-10-27T23:04:25.294756+00:00","last_verified_at":"2026-10-27T23:04:25.294756+00:00","recent_runs":[{"at":"2026-10-27T23:04:25.294756+00:00","status":"healthy"},{"at":"2026-10-20T23:00:25.426476+00:00","status":"healthy"},{"at":"2026-10-13T22:04:25.212547+00:00","status":"healthy"},{"at":"2026-10-06T22:01:52.899466+00:00","status":"healthy"},{"at":"2026-09-29T21:04:52.916727+00:00","status":"healthy"}]},{"endpoint_name":"get_listing_detail","status":"healthy","last_checked_at":"2026-10-27T23:04:25.294756+00:00","last_verified_at":"2026-10-27T23:04:25.294756+00:00","recent_runs":[{"at":"2026-10-27T23:04:25.294756+00:00","status":"healthy"},{"at":"2026-10-20T23:00:25.426476+00:00","status":"healthy"},{"at":"2026-10-13T22:04:25.212547+00:00","status":"healthy"},{"at":"2026-10-06T22:01:52.899466+00:00","status":"healthy"},{"at":"2026-09-29T21:04:52.916727+00:00","status":"healthy"}]},{"endpoint_name":"get_price_trends","status":"healthy","last_checked_at":"2026-10-27T23:04:25.294756+00:00","last_verified_at":"2026-10-27T23:04:25.294756+00:00","recent_runs":[{"at":"2026-10-27T23:04:25.294756+00:00","status":"healthy"},{"at":"2026-10-20T23:00:25.426476+00:00","status":"healthy"},{"at":"2026-10-13T22:04:25.212547+00:00","status":"healthy"},{"at":"2026-10-06T22:01:52.899466+00:00","status":"healthy"},{"at":"2026-09-29T21:04:52.916727+00:00","status":"healthy"}]},{"endpoint_name":"get_makes_and_models_directory","status":"healthy","last_checked_at":"2026-10-27T23:04:25.294756+00:00","last_verified_at":"2026-10-27T23:04:25.294756+00:00","recent_runs":[{"at":"2026-10-27T23:04:25.294756+00:00","status":"healthy"},{"at":"2026-10-20T23:00:25.426476+00:00","status":"healthy"},{"at":"2026-10-13T22:04:25.212547+00:00","status":"healthy"},{"at":"2026-10-06T22:01:52.899466+00:00","status":"healthy"},{"at":"2026-09-29T21:04:52.916727+00:00","status":"healthy"}]}],"sdk_usage_example":{"code":"\"\"\"Walkthrough: Bring a Trailer SDK — browse auctions, search, check pricing.\"\"\"\nfrom parse_apis.bring_a_trailer_api import BringATrailer, Recency, ModelNotFound\n\nbat = BringATrailer()\n\n# Browse currently live auctions (single-page, cap total items)\nfor auction in bat.auctions.current(limit=3):\n    print(auction.title, auction.current_bid, auction.url)\n\n# Search for models by keyword\nmatch = bat.modelmatches.search(query=\"Ferrari\", limit=1).first()\nif match:\n    print(match.title, match.url, match.destination)\n\n# Construct a VehicleModel and get price trends for the last year\nporsche_911 = bat.vehiclemodel(slug=\"911\")\ntrends = porsche_911.price_trends(make=\"porsche\", recency=Recency.ONE_YEAR)\nprint(trends.count, trends.avg, trends.median, trends.min, trends.max)\n\n# Compare year-over-year pricing\ncomparison = porsche_911.price_comparison(make=\"porsche\")\nprint(comparison.recent_avg, comparison.older_avg, comparison.percent_change)\n\n# Typed error handling for an invalid model\ntry:\n    bad_model = bat.vehiclemodel(slug=\"nonexistent-xyz-999\")\n    bad_model.price_trends(make=\"fakemake\")\nexcept ModelNotFound as exc:\n    print(f\"Model not found: {exc}\")\n\nprint(\"exercised: auctions.current / modelmatches.search / price_trends / price_comparison + ModelNotFound\")\n","shape":"parse_sdk","endpoints":["get_current_auctions","get_auction_results","search_listings","get_model_auction_results","get_price_trends","get_price_trend_comparison","get_listing_detail","get_makes_and_models_directory"],"has_session":false,"hover_map":[{"line":7,"col":4,"len":7,"label":"auction: Auction","kind":"variable"},{"line":11,"col":0,"len":5,"label":"match: ModelMatch","kind":"variable"},{"line":12,"col":3,"len":5,"label":"match: ModelMatch","kind":"variable"},{"line":17,"col":0,"len":6,"label":"trends: PriceTrend","kind":"variable"},{"line":21,"col":0,"len":10,"label":"comparison: PriceTrendComparison","kind":"variable"},{"line":4,"col":6,"len":13,"label":"BringATrailer — API client","kind":"class"},{"line":7,"col":28,"len":7,"label":"current() → List[Auction]","kind":"method"},{"line":17,"col":21,"len":12,"label":"price_trends() → PriceTrend","kind":"method"},{"line":18,"col":13,"len":5,"label":"count: int","kind":"field"},{"line":18,"col":27,"len":3,"label":"avg: float","kind":"field"},{"line":18,"col":39,"len":6,"label":"median: float","kind":"field"},{"line":18,"col":54,"len":3,"label":"min: float","kind":"field"},{"line":18,"col":66,"len":3,"label":"max: float","kind":"field"},{"line":21,"col":25,"len":16,"label":"price_comparison() → PriceTrendComparison","kind":"method"},{"line":22,"col":17,"len":10,"label":"recent_avg: float","kind":"field"},{"line":22,"col":40,"len":9,"label":"older_avg: float","kind":"field"},{"line":22,"col":62,"len":14,"label":"percent_change: float","kind":"field"},{"line":28,"col":7,"len":13,"label":"ModelNotFound — error: The make/model combination could not be resolved to a valid keyword ID","kind":"error"},{"line":8,"col":18,"len":5,"label":"title: str","kind":"field"},{"line":8,"col":33,"len":11,"label":"current_bid: int","kind":"field"},{"line":8,"col":54,"len":3,"label":"url: url","kind":"field"},{"line":13,"col":16,"len":5,"label":"title: str","kind":"field"},{"line":13,"col":29,"len":3,"label":"url: url","kind":"field"},{"line":13,"col":40,"len":11,"label":"destination: str","kind":"field"},{"line":17,"col":66,"len":8,"label":"Recency.ONE_YEAR","kind":"enum-member"},{"line":18,"col":6,"len":6,"label":"trends: PriceTrend","kind":"variable"},{"line":18,"col":20,"len":6,"label":"trends: PriceTrend","kind":"variable"},{"line":18,"col":32,"len":6,"label":"trends: PriceTrend","kind":"variable"},{"line":18,"col":47,"len":6,"label":"trends: PriceTrend","kind":"variable"},{"line":18,"col":59,"len":6,"label":"trends: PriceTrend","kind":"variable"},{"line":22,"col":6,"len":10,"label":"comparison: PriceTrendComparison","kind":"variable"},{"line":22,"col":29,"len":10,"label":"comparison: PriceTrendComparison","kind":"variable"},{"line":22,"col":51,"len":10,"label":"comparison: PriceTrendComparison","kind":"variable"},{"line":27,"col":14,"len":12,"label":"price_trends() → PriceTrend","kind":"method"},{"line":8,"col":10,"len":7,"label":"auction: Auction","kind":"variable"},{"line":8,"col":25,"len":7,"label":"auction: Auction","kind":"variable"},{"line":8,"col":46,"len":7,"label":"auction: Auction","kind":"variable"},{"line":11,"col":25,"len":6,"label":"search() → List[ModelMatch]","kind":"method"},{"line":13,"col":10,"len":5,"label":"match: ModelMatch","kind":"variable"},{"line":13,"col":23,"len":5,"label":"match: ModelMatch","kind":"variable"},{"line":13,"col":34,"len":5,"label":"match: ModelMatch","kind":"variable"},{"line":17,"col":58,"len":7,"label":"Recency — enum: FIVE_YEARS, ONE_YEAR, THREE_YEARS, TWO_YEARS","kind":"enum"},{"line":29,"col":30,"len":3,"label":"exc: ModelNotFound","kind":"variable"}]},"sdk_delivery_state":"legacy","summary":"Search and monitor Bring a Trailer vehicle auctions, view detailed listing information, pricing trends, and historical auction results.","updated_at":"2026-07-23T02:22:42.893127+00:00","user_variants":[],"latest_version":9,"user_status":null,"user_scraper_id":null,"contributes_to_marketplace":true,"pinned_version":null,"seo_content":{"faqs":[{"a":"Bring a Trailer does not publish an official public developer API. The data accessible here is not available through any documented first-party endpoint from BaT.","q":"Does Bring a Trailer have an official developer API?"},{"a":"It returns the listing title, full URL, a stats object with extracted listing essentials, a json_ld array of JSON-LD structured data objects (which may include Product/Offer pricing schema when available), and a theme_data object containing BaT's post ID and configuration. It accepts either a full URL or a short slug.","q":"What does get_listing_detail return beyond the sale price?"},{"a":"Not currently. The API covers listing metadata, bid amounts, sale prices, pricing statistics, and JSON-LD structured data. It does not expose comment threads, narrative descriptions, or photo gallery URLs. You can fork this API on Parse and revise it to add an endpoint targeting that content.","q":"Are auction comments, seller descriptions, or photo galleries exposed?"},{"a":"Yes. get_auction_results accepts a page integer, but only page 1 is reliably supported — requests for higher page numbers may time out. For deep historical data by make and model, get_model_auction_results with its page parameter is the more stable path.","q":"Is there a limitation on paginating through completed auction results?"},{"a":"get_current_auctions returns all active listings at once without server-side filters for make, model, or bid range. The response includes a locations array for geographic grouping, but filtering by vehicle type or price must be done client-side. You can fork this API on Parse and revise it to add filtered query parameters.","q":"Can I filter live auctions by make, model, or price range?"}],"keywords":["bring a trailer API","BaT auction results API","classic car auction prices API","collector car valuation API","bringatrailer.com scraper API","vehicle auction price trends API","BaT completed sales data","classic car median sale price API","bring a trailer listing detail API","collector car price comparison API","BaT make model auction history","no reserve auction API","vintage car auction data API","automobile auction price statistics"],"use_cases":["Track real-time bidding activity and reserve status across all live BaT auctions for a watchlist app","Calculate fair-market value ranges for a specific vehicle using median and average sale prices from get_price_trends","Identify models that have appreciated year-over-year using the percent_change field from get_price_trend_comparison","Build a historical price chart for a make/model using the sold data points array in get_model_auction_results","Resolve user-typed vehicle names to valid make/model slugs via search_listings before querying pricing endpoints","Pull structured listing metadata including JSON-LD product data for a specific auction via get_listing_detail","Enumerate the complete BaT make/model catalog with get_makes_and_models_directory for a vehicle valuation database"],"meta_title":"Bring a Trailer API – Auction & Pricing Data","generated_at":"2026-06-10T09:18:53.525461+00:00","lead_paragraph":"The Bring a Trailer API covers 8 endpoints that expose live auction listings, completed sale results, make/model price statistics, and full listing detail pages from bringatrailer.com. The `get_price_trends` endpoint returns count, min, max, average, and median sale prices for any make/model combination filtered by 1, 2, 3, or 5-year windows, while `get_current_auctions` surfaces every active listing with its current bid, reserve status, and end timestamp.","schema_version":2,"meta_description":"Access live auctions, completed sale prices, price trends, and full listing details from Bring a Trailer via a structured JSON API.","primary_category":"automotive","long_description_md":"## Live Auctions and Completed Results\n\n`get_current_auctions` returns all active listings with fields including current bid amount, listing title, URL, end timestamp, location, and a no-reserve flag. A `locations` array provides geographic groupings you can use for client-side filtering. `get_auction_results` returns paginated completed auctions sorted by most-recently-closed, including final sale price and sold date text. Note that only page 1 is reliably supported — higher pages may time out, so designs that depend on deep pagination should account for that constraint.\n\n## Model-Level Pricing and Comparisons\n\n`get_price_trends` accepts `make`, `model`, and an optional `recency` parameter (`1Y`, `2Y`, `3Y`, or `5Y`) and returns `avg`, `median`, `min`, `max`, and `count` across closed sales in that window. When no sales exist for a period, all numeric fields return zero rather than an error. `get_price_trend_comparison` narrows to a fixed two-period view: `recent_avg` vs `older_avg` for the most recent 12 months versus the prior 12, plus `recent_count`, `older_count`, and a `percent_change` field useful for spotting appreciation or depreciation trends. `get_model_auction_results` returns both the paginated listing objects and a `stats` object containing `sold` and `unsold` arrays of price/timestamp data points, suitable for charting a model's auction history.\n\n## Listing Detail and Discovery\n\n`get_listing_detail` accepts either a full URL or a listing slug and returns `title`, `url`, a `stats` object with extracted listing essentials, a `json_ld` array of structured data objects, and a `theme_data` object carrying the BaT post ID and configuration. `search_listings` takes a `query` string and returns matching make/model pages and listing categories with URL, title, destination, and result type — useful for resolving user input to valid slugs. `get_makes_and_models_directory` returns the complete list of makes and their associated models with name, URL, and slug fields needed by the pricing endpoints.\n\n## Finding Valid Slugs\n\nAll pricing and results endpoints require lowercase `make` and `model` slug parameters (e.g. `porsche`, `911`). The recommended resolution path is `search_listings` for keyword-to-slug lookups or `get_makes_and_models_directory` for a full enumeration of every supported make-model pair, which returns each model's slug directly.","generated_with_model":"global.anthropic.claude-sonnet-4-6","secondary_categories":["marketplace","finance"]},"primary_category":"automotive","secondary_categories":["marketplace","finance"],"access_requirements":[]}