Auction and sale-calendar research
Bonhamsエンドポイントを使えば、「Auction and sale-calendar research」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
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.
エンドポイントファミリー
2
ドキュメント化されたパラメータ
29
サンプル数
5
ライブカタログスナップショット
稼働エンドポイント
5
メソッド
GET
必須パラメータ
9
スキーマ参照
5
{
"platform": "Bonhams",
"endpoint": "bonhams-lot-search",
"method": "GET",
"path": "/bonhams/lots/search",
"auth": "apiKey"
}ユースケース
Search Bonhams auctions and lots across current and historical sales, and get normalized auction and lot facts including realized prices as JSON.
Bonhamsエンドポイントを使えば、「Auction and sale-calendar research」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Bonhamsエンドポイントを使えば、「Realized-price and estimate analysis」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Bonhamsエンドポイントを使えば、「Art and collectibles market monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
以下の数値はすべて、稼働中のBonhamsエンドポイントカタログから取得しています(エンドポイント5件、ドキュメント化されたリクエストパラメータ29個、公開レスポンススキーマ5件)。DocsとPlaygroundが参照しているカタログと同じものです。
Bonhamsのエンドポイントは5件、2つのリクエストファミリーに分類されています(Auctions、Lots)。
これらのBonhamsエンドポイントには29個のリクエストパラメータがドキュメント化されており、うち9個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
5件のBonhamsエンドポイントのうち5件が実際のサンプルレスポンスを、5件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
Bonhamsのエンドポイントは成功時のスキーマに加えてエラーレスポンス(400、404、500、503)もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
Bonhamsのエンドポイントは5個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
/bonhams/auctions/search
/bonhams/lots/search
エンドポイントカタログ
/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ツール 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ツール 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ツール 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ツール 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ツール bonhams_auction_lots
関連API
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.
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.