Bonhams

Search Bonhams lots across every auction

Searches 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.

get/bonhams/lots/search

Request

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

Query parameters

qstring

Free-text search across lot title, catalog description, and footnotes

departmentstring

Comma-separated department names (not a fixed enum -- large, changes over time)

countrystring

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

min_price_gbpnumber

Minimum estimate, in GBP (converted from each lot's own sale currency), inclusive. Omit or 0 for no minimum.

max_price_gbpnumber

Maximum estimate, in GBP (converted from each lot's own sale currency), inclusive. Omit or 0 for no maximum.

sort'relevance' | 'recency' | 'price_high' | 'price_low' | 'lot_number'

Result order. Default: Typesense relevance ranking when q is set, otherwise recency (most recently active sale date first).

pageinteger

1-based page number, default 1

per_pageinteger

Results per page, default 48, 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 3 revisions of this API.