Bonhams API endpoint
Returns the lot listing for one Bonhams auction, optionally filtered by department and/or a free-text query.
/bonhams/auctions/{id}/lotsPath parameters:
id (required) — Bonhams auction id, e.g. 32001.Query parameters:
q (optional) — free-text search across lot title, catalog description, and footnotes. Omit to browse the whole auction.department (optional) — comma-separated department names, matched against this auction's own live department facet (e.g. Silver, Jewellery, Chinese Ceramics & Works of Art). Not a fixed enum — departments vary per auction; the department name returned on each lot in an unfiltered call is the authoritative list for that auction.page (optional, default 1).per_page (optional, default 48, max 100).Response includes auction_id, page, per_page, total (matching lots across all pages), total_pages, and results[]. A department filter with no matching lots, or an auction with no lots at all, returns a valid total: 0, results: [] response rather than an error. Each lot uses the same shape as Bonhams Lot Detail.
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| id | 20 | |
| auction_id | 20 | |
| lot_number | 20 | 501 to 520, median 510 |
| title | 20 | “An Attu polychrome lidded basket” and 16 other values |
| status | 20 | SOLD in all 20 |
| department | 20 | |
| country | 20 | |
| currency | 20 | |
| estimate_low | 20 | 800 to 2,000, median 1,200 |
| estimate_high | 20 | 1,200 to 3,000, median 1,800 |
| estimate_low_gbp | 20 | 553.99 to 5,170.55, median 1,477.3 |
| estimate_high_gbp | 20 | 553.99 to 5,170.55, median 1,477.3 |
| starting_bid_amount | 20 | 400 to 1,500, median 600 |
| hammer_price | 20 | 750 to 7,000, median 2,000 |
| hammer_premium | 20 | 960 to 8,960, median 2,560 |
| sale_date | 20 | |
| auction_type | 20 | ONLINE in all 20 |
| auction_status | 20 | FINISHED in all 20 |
| auction_bidding_status | 20 | EN in all 20 |
| image_url | 20 | images2.bonhams.com |
| slug | 20 | |
| url | 20 | bonhams.com |
| without_reserve | 20 | true in 0 of 20 |
| condition_report_available | 20 | true in 12 of 20 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | Bonhams auction id | 32001 | |
| q | string | No | Free-text search across lot title, catalog description, and footnotes | candelabra | |
| department | string | No | Comma-separated department names (not a fixed enum -- varies per auction) | Silver | |
| page | integer | No | 1-based page number, default 1 | ||
| per_page | integer | No | Results per page, default 48, max 100 | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/bonhams/auctions/32001/lots?q=coffee&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"auction_id": "32001",
"page": 1,
"per_page": 48,
"total": 1,
"total_pages": 1,
"results": [
{
"id": "32001-2",
"auction_id": "32001",
"lot_number": "2",
"title": "A pair of Scandanavian silver three-branch candelabra",
"status": "NEW",
"department": {
"code": "ORI-CHI",
"name": "Chinese Ceramics & Works of Art"
},
"country": {
"code": "AU",
"name": "Australia"
},
"currency": {
"iso_code": "AUD",
"bonhams_code": "AU$",
"symbol": "AU$"
},
"estimate_low": 800,
"estimate_high": 1200,
"starting_bid_amount": 800,
"sale_date": {
"datetime": "2026-09-03T04:01:00+00:00",
"timestamp": 1788408060,
"timezone": "Australia/Sydney"
},
"auction_type": "ONLINE",
"auction_status": "READY",
"auction_bidding_status": "IP",
"slug": "a-pair-of-scandanavian-silver-three-branch-candelabra",
"url": "https://www.bonhams.com/auction/32001/lot/2/a-pair-of-scandanavian-silver-three-branch-candelabra/",
"without_reserve": false,
"condition_report_available": false
}
]
}
}Request schema
No body schema
Response schema
#/definitions/bonhams.auctionLotsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | bonhams.AuctionLotsResponse | No | ||||
| data.auction_id | string | No | ||||
| data.page | integer | No | ||||
| data.per_page | integer | No | ||||
| data.query | string | No | ||||
| data.results | array | No | Lot record, 38 fields: auction_bidding_status, auction_id, auction_status, auction_type, categories, condition_report_available, country, currency, department, estimate_high, estimate_high_gbp, estimate_low and 14 more. Described under Bonhams Lot Detail API. | |||
| data.total | integer | No | ||||
| data.total_pages | integer | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/bonhams/auctions/32001/lots?q=coffee&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"