Bonhams

Search Bonhams auctions

Searches and filters Bonhams' auctions. Default status "upcoming" excludes ended auctions, matching bonhams.com's own default; "past" browses Bonhams' full historical auction archive instead.

get/bonhams/auctions/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/bonhams/auctions/search
  • Auth: API key in header x-api-key

Query parameters

qstring

Free-text search across auction title and department names

countrystring

Comma-separated country names (not a fixed enum -- live facet)

categorystring

Comma-separated categories. Allowed values: 20th & 21st Century Art, Asian Art, Books, History & Science, Classic Art, Decorative Arts & Furniture, Handbags, Jewels & Watches, Motoring, Popular Culture, Wine & Whisky.

monthstring

Comma-separated month-and-year values, e.g. \

auction_type'ONLINE' | 'PUBLIC' | 'EXHIBITION' | 'OTHER'

Comma-separated auction types

status'upcoming' | 'past' | 'all'

Filters by bidding/completion status, default upcoming

pageinteger

1-based page number, default 1

per_pageinteger

Results per page, default 24, max 100

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.