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契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
これらのカードは稼働中のエンドポイントカタログから生成されるため、このページはDocsとPlaygroundが使うAPIサーフェスをそのまま反映します。
/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. Credential-free public data from bonhams.com's own search API.
MCPツール 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ツール 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ツール 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ツール 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ツール bonhams_auction_lots
関連API
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.
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.