Auction and sale-calendar research
Use Bonhams endpoints to turn auction and sale-calendar research into repeatable API requests with documented inputs and JSON responses.
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.
Endpoint families
2
Documented params
29
Examples
5
Live catalog snapshot
Active endpoints
5
Methods
GET
Required params
9
Schema refs
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.
Use Bonhams endpoints to turn auction and sale-calendar research into repeatable API requests with documented inputs and JSON responses.
Use Bonhams endpoints to turn realized-price and estimate analysis into repeatable API requests with documented inputs and JSON responses.
Use Bonhams endpoints to turn art and collectibles market monitoring into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live Bonhams endpoint catalog — 5 endpoints, 29 documented request parameters, and 5 published response schemas — the same catalog Docs and Playground run against.
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.
Coverage map
These cards are generated from the active endpoint catalog, so the landing page reflects the same API surface used by Docs and Playground.
/bonhams/auctions/search
/bonhams/lots/search
Endpoint catalog
/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. Credential-free public data from bonhams.com's own search API.
MCP tool bonhams_lot_search
/bonhams/lots/{auctionId}/{lotNumber}Returns one Bonhams lot's normalized 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. Credential-free public data from bonhams.com's own search API.
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. Credential-free public data from bonhams.com's own search API.
MCP tool bonhams_auction_search
/bonhams/auctions/{id}Returns one Bonhams auction's normalized 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. Credential-free public data from bonhams.com's own search API.
MCP tool bonhams_auction_detail
/bonhams/auctions/{id}/lotsReturns the normalized lot listing for one Bonhams auction, optionally filtered by department and/or a free-text query. Credential-free public data from bonhams.com's own search API.
MCP tool bonhams_auction_lots
Related APIs
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.
Marketplaces & Retail
Turn public Shop.app product and merchant pages into structured JSON for e-commerce product intelligence, price research, shop monitoring, and marketplace discovery workflows.
How to scrape 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.