Marketplace
Bonhams logo

Bonhams API

bonhams.com

Browse Bonhams auctions, departments, and lots with estimates, hammer prices, and sale details.

Actions
6
Category
Marketplace
Login
Not required
Output
JSON

Call the Bonhams API

Submit a task, then poll the job until it settles. This example runs act_bonhams_auction_detail_ssr.

curl -X POST https://api.anakin.io/v1/wire/task \
  -H "X-API-Key: $ANAKIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action_id": "act_bonhams_auction_detail_ssr",
    "params": {
      "auction_id": "31978",
      "auction_slug": "london-watches"
    }
  }'

6 actions on bonhams.com

Read

  • Auction Details

    act_bonhams_auction_detail_ssrread1 credit / call

    Returns an auction's detail with sale metadata and its lots, prices, and estimates.

    auction_id
    string · required
    auction_slug
    string · required
  • Department Navigation

    act_bonhams_department_navigationread1 credit / call

    Returns department codes, display names, and interest images for collecting departments.

    department_codes
    string · required
  • Department Page

    act_bonhams_department_page_ssrread1 credit / call

    Returns a department's featured and upcoming auctions with venues and sale dates.

    department_code
    string · required
    department_slug
    string · required

Write

Write actions change state on bonhams.com and run as the account you connect.

  • Auction Lot Listing

    act_bonhams_auction_lot_listingwrite2 credits / call

    Returns paginated lots for an auction with lot IDs, titles, estimate ranges, hammer prices, and status.

    auction_id
    string · required
    page
    integer · required
    search_query
    string
    per_page
    integer
  • Ended Auction Listing

    act_bonhams_ended_auction_listingwrite2 credits / call

    Returns ended auctions with facet metadata including auction IDs, slugs, titles, and category facets.

    page
    integer · required
    category_name
    string
  • Regional Auction Listing

    act_bonhams_regional_auction_listingwrite2 credits / call

    Returns upcoming auctions filtered by region with auction IDs, titles, sale dates, and month facets.

    region_code
    string · required
    page
    integer · required

Bonhams API questions

Is there an API for Bonhams?
Bonhams does not offer a public data API for this, but Anakin Wire provides 6 maintained endpoints for bonhams.com. You call Anakin's REST API with an action ID and parameters and get structured JSON back; Anakin handles the browser, proxies, anti-bot, and parsing.
How do I scrape Bonhams data?
POST to https://api.anakin.io/v1/wire/task with your API key, the action ID, and its parameters, then poll GET /v1/wire/jobs/{id} until the job settles. There is nothing to install and no scraper to maintain — when bonhams.com changes its markup, Anakin updates the action.
Do I need a Bonhams account?
No. Every Bonhams action listed here runs anonymously — no account and no credentials required.
What does the Bonhams API cost?
Usage-based credits, charged per call and refunded automatically when a job fails. New accounts start with 300 free credits and no card. See anakin.io/pricing for the current rates.

More Marketplace APIs

All Marketplace sites