Endpoint Playground
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.
14 Oct 2026: 20 results; 20 fields had a value in every checked item and 5 varied between items.
Sample value profiles: title: Silver: (12), Silver (4), [SILVER.] (1) and 3 more; lot_number: 96 to 9,282, median 730; image_url: images2.bonhams.com and 1 other host.
curl 'https://api.crawlora.net/api/v1/bonhams/lots/search?sort=relevance' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | No | Free-text search across lot title, catalog description, and footnotes | |
| department | string | No | Comma-separated department names (not a fixed enum -- large, changes over time) | |
| country | string | No | Comma-separated country names (not a fixed enum -- live facet) | |
| min_price_gbp | number | No | Minimum estimate, in GBP (converted from each lot's own sale currency), inclusive. Omit or 0 for no minimum. | |
| max_price_gbp | number | No | Maximum estimate, in GBP (converted from each lot's own sale currency), inclusive. Omit or 0 for no maximum. | |
| sort | string | No | relevance | Result order. Default: Typesense relevance ranking when q is set, otherwise recency (most recently active sale date first). |
| page | integer | No | 1-based page number, default 1 | |
| per_page | integer | No | Results per page, default 48, max 100 |
{
"code": 200,
"msg": "OK",
"data": {
"query": "Rolex Submariner",
"page": 1,
"per_page": 48,
"total": 725,
"total_pages": 16,
"results": [
{
"id": "31165-1001",
"auction_id": "31165",
"lot_number": "1001",
"title": "ROLEX | SUBMARINER, REF.116659SABR, A RARE LIMITED PRODUCTION 18K WHITE GOLD, DIAMOND, AND SAPPHIRE-SET WRISTWATCH WITH SWEEP CENTRE SECONDS, DATE, AND BRACELET",
"status": "SOLD",
"department": {
"code": "WAT",
"name": "Watches"
},
"country": {
"code": "US",
"name": "United States"
},
"currency": {
"iso_code": "USD",
"bonhams_code": "US$",
"symbol": "US$"
},
"estimate_low": 650000,
"estimate_high": 950000,
"estimate_low_gbp": 514500,
"estimate_high_gbp": 751500,
"hammer_price": 850000,
"sale_date": {
"datetime": "2026-06-10T18:00:00+00:00",
"timestamp": 1749578400
},
"auction_type": "ONLINE",
"auction_status": "CLOSED",
"url": "https://www.bonhams.com/auction/31165/lot/1001/rolex-submariner-ref116659sabr-a-rare-limited-production-18k-white-gold-diamond-and-sapphire-set-wristwatch-with-sweep-centre-seconds-date-and-bracelet/",
"without_reserve": false,
"condition_report_available": false
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.