Auction and sale-calendar research
Mit Bonhams-Endpunkten verwandelst du auction and sale-calendar research in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Turn Bonhams' public auction data into structured JSON — auction search across upcoming, past, or all sales, one auction's normalized facts and its full lot listing, and lot search across every auction with department, country, and GBP-normalized estimate-range filters, each lot carrying its estimate, hammer/realized price once sold, and sale date. Credential-free.
Search Bonhams auctions and lots across current and historical sales, and get normalized auction and lot facts including realized prices as JSON.
Endpunkt-Familien
2
Dokumentierte Parameter
29
Beispiele
5
Live-Katalog-Snapshot
Aktive Endpunkte
5
Methoden
GET
Pflichtparameter
9
Schema-Referenzen
5
{
"platform": "Bonhams",
"endpoint": "bonhams-lot-search",
"method": "GET",
"path": "/bonhams/lots/search",
"auth": "apiKey"
}Use Cases
Search Bonhams auctions and lots across current and historical sales, and get normalized auction and lot facts including realized prices as JSON.
Mit Bonhams-Endpunkten verwandelst du auction and sale-calendar research in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit Bonhams-Endpunkten verwandelst du realized-price and estimate analysis in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit Bonhams-Endpunkten verwandelst du art and collectibles market monitoring in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Managed Execution
Jede Zahl unten stammt direkt aus dem Live-Bonhams-Endpunktkatalog — 5 Endpunkte, 29 dokumentierte Request-Parameter und 5 veröffentlichte Response-Schemas — demselben Katalog, gegen den auch Docs und Playground laufen.
5 documented Bonhams endpoints, grouped into 2 request families — Auctions and Lots.
29 request parameters are documented across those Bonhams endpoints, 9 of them required — the full input contract is public before you write any integration code.
5 of the 5 Bonhams endpoints ship a recorded example response, and 5 carry a documented response schema — you can code against the real JSON before the first request.
Bonhams endpoints document their error responses (400, 404, 500 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.
5 hosted MCP tools back the Bonhams endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Abdeckungskarte
/bonhams/auctions/search
/bonhams/lots/search
Endpunktkatalog
/bonhams/lots/searchSearches Bonhams lots across every auction, current and historical -- including sold/prices-realized lots -- optionally filtered by department, country, a GBP-normalized estimate price range, and/or a free-text query, in a caller-selected sort order. Without a query and without an explicit sort, results are ordered by most recently active sale date first.
MCP-Tool bonhams_lot_search
/bonhams/lots/{auctionId}/{lotNumber}Returns one Bonhams lot's facts: title, estimate range, hammer/realized price (once sold), sale date, category, department, and lot number. Full lot description prose, condition-report text, and additional images are not reproduced -- see the response fields.
MCP-Tool bonhams_lot_detail
/bonhams/auctions/searchSearches and filters Bonhams' auctions. Default status "upcoming" excludes ended auctions, matching bonhams.com's own default; "past" browses Bonhams' full historical auction archive instead.
MCP-Tool bonhams_auction_search
/bonhams/auctions/{id}Returns one Bonhams auction's facts by id: title, category, department, country, currency, sale dates, and lot count. Unlike the search endpoint, this is not restricted to upcoming/live auctions -- a historical/ended auction id resolves too.
MCP-Tool bonhams_auction_detail
/bonhams/auctions/{id}/lotsReturns the lot listing for one Bonhams auction, optionally filtered by department and/or a free-text query.
MCP-Tool bonhams_auction_lots
Verwandte APIs
Marketplaces & Retail
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.
Marketplaces & Retail
Collect marketplace product signals from Amazon without building brittle storefront scrapers.
Marketplaces & Retail
Build resale, pricing, and marketplace workflows from structured eBay data.
So scrapst du Bonhams
Crawlora's Bonhams endpoints return normalized public Bonhams data as JSON with one API key — no Bonhams account required. Full lot description prose, condition reports, and extra images are deliberately not reproduced; this family returns structured facts.
Call /bonhams/auctions/search with an optional free-text q across auction title and department names. status defaults to upcoming, matching bonhams.com's own Upcoming Auctions page — pass past to browse the historical archive (the site's separate Auction results view) or all for both.
Pass an auction id to /bonhams/auctions/{id} for its title, category, department, country, currency, sale dates, and lot count — historical and ended auctions resolve too, not just live ones. Then call /bonhams/auctions/{id}/lots for that auction's normalized lot listing, optionally narrowed by department or a free-text query.
Call /bonhams/lots/search when you don't already know an auction id — it spans every auction, current and historical, including sold/prices-realized lots, filterable by department, country, and a GBP-normalized estimate price range, in a sort order you choose.
Call /bonhams/lots/{auctionId}/{lotNumber} for that lot's title, estimate range, hammer/realized price once sold, sale date, category, department, and lot number, plus one representative thumbnail.
FAQ
Call /bonhams/lots/search to search lots across every auction, /bonhams/auctions/search for auctions, then /bonhams/auctions/{id}, /bonhams/auctions/{id}/lots, or /bonhams/lots/{auctionId}/{lotNumber} for one record's normalized facts — all return structured JSON with one API key.
Yes — /bonhams/lots/search spans current and historical auctions including sold lots, /bonhams/lots/{auctionId}/{lotNumber} returns the hammer/realized price once a lot has sold, and /bonhams/auctions/search accepts status=past (or status=all). Only the auction-search default is restricted to upcoming sales, matching bonhams.com's own page default.
No — full description prose, condition-report text, and additional images are deliberately not reproduced. This family returns structured facts (title, estimate, realized price, dates, department, lot number) plus one representative thumbnail URL.
Yes — /bonhams/lots/search takes a GBP-normalized estimate price range, so lots from sales in different currencies compare on one scale, alongside department, country, and free-text filters.