Auction and sale-calendar research
Usa los endpoints de Bonhams para convertir auction and sale-calendar research en solicitudes API repetibles con inputs documentados y respuestas JSON.
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.
Familias de endpoints
2
Parámetros documentados
29
Ejemplos
5
Snapshot en vivo del catálogo
Endpoints activos
5
Métodos
GET
Parámetros obligatorios
9
Referencias de esquema
5
{
"platform": "Bonhams",
"endpoint": "bonhams-lot-search",
"method": "GET",
"path": "/bonhams/lots/search",
"auth": "apiKey"
}Casos de uso
Search Bonhams auctions and lots across current and historical sales, and get normalized auction and lot facts including realized prices as JSON.
Usa los endpoints de Bonhams para convertir auction and sale-calendar research en solicitudes API repetibles con inputs documentados y respuestas JSON.
Usa los endpoints de Bonhams para convertir realized-price and estimate analysis en solicitudes API repetibles con inputs documentados y respuestas JSON.
Usa los endpoints de Bonhams para convertir art and collectibles market monitoring en solicitudes API repetibles con inputs documentados y respuestas JSON.
Ejecución gestionada
Cada cifra de abajo se lee directamente del catálogo de endpoints en vivo de Bonhams — 5 endpoints, 29 parámetros de solicitud documentados y 5 esquemas de respuesta publicados — el mismo catálogo contra el que corren Docs y Playground.
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.
Mapa de cobertura
/bonhams/auctions/search
/bonhams/lots/search
Catálogo de endpoints
/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.
Herramienta MCP 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.
Herramienta MCP 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.
Herramienta MCP 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.
Herramienta MCP bonhams_auction_detail
/bonhams/auctions/{id}/lotsReturns the lot listing for one Bonhams auction, optionally filtered by department and/or a free-text query.
Herramienta MCP bonhams_auction_lots
APIs relacionadas
Marketplaces & Retail
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.
Marketplaces & Retail
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
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.
Cómo hacer scraping de 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.
On 2026-10-30 auction 32778 (Fine Native American Baskets and Pottery, online, finished) reported 163 lots over 9 pages of 20, and a search for the Asian Art category returned 19 auctions on 1 page.
Agent Skills
Instala un agent skill de Crawlora y tu agente obtiene datos de Bonhams como JSON mediante la API documentada, sin escribir un scraper. Estos skills cubren Bonhams:
Researches Bonhams auctions and lots via the Crawlora API — upcoming and past sales, lot search, estimates, realized prices, departments, and…
npx skills add github.com/Crawlora-org/crawlora-skills --skill auction-researchPreguntas frecuentes
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.