Endpoint Playground
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.
14 Oct 2026: 20 results; 22 fields had a value in every checked item and 1 varied between items.
Sample value profiles: auction_type: PUBLIC (13), ONLINE (7); lot_count: 0 to 460, median 2; title: “Selected Works of Art from the Yang Ming Shan Fang Collecti…” and 19 other values.
curl 'https://api.crawlora.net/api/v1/bonhams/auctions/search?auction_type=ONLINE&status=upcoming' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | No | Free-text search across auction title and department names | |
| country | string | No | Comma-separated country names (not a fixed enum -- live facet) | |
| category | string | No | 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. | |
| month | string | No | Comma-separated month-and-year values, e.g. \ | |
| auction_type | string | No | ONLINE | Comma-separated auction types |
| status | string | No | upcoming | Filters by bidding/completion status, default upcoming |
| page | integer | No | 1-based page number, default 1 | |
| per_page | integer | No | Results per page, default 24, max 100 |
{
"code": 200,
"msg": "OK",
"data": {
"page": 1,
"per_page": 24,
"total": 1,
"total_pages": 1,
"results": [
{
"id": "32001",
"title": "Home & Interiors: including the Linton Collection",
"slug": "home-and-interiors-including-the-linton-collection",
"url": "https://www.bonhams.com/auction/32001/home-and-interiors-including-the-linton-collection/",
"brand": "bonhams",
"auction_type": "ONLINE",
"auction_status": "READY",
"bidding_status": "IP",
"categories": [
{
"code": "CAT-DEC",
"name": "Decorative Arts & Furniture"
}
],
"departments": [
{
"code": "SIL",
"name": "Silver"
}
],
"country": {
"code": "AU",
"name": "Australia"
},
"region": {
"code": "ASIA_PACIFIC",
"name": "Asia Pacific"
},
"currency": {
"iso_code": "AUD",
"bonhams_code": "AU$"
},
"start_date": {
"datetime": "2026-08-20T00:00:00+00:00",
"timestamp": 1787270400
},
"end_date": {
"datetime": "2026-09-03T04:00:00+00:00",
"timestamp": 1788408000
},
"hammer_time": {
"datetime": "2026-09-03T04:01:00+00:00",
"timestamp": 1788408060
},
"month": "September",
"month_and_year": "September 2026",
"year": "2026",
"lot_count": 58,
"image_url": "https://images3.bonhams.com/image?src=Images/live/2026-08/01/x.jpg",
"is_auction_ended": false,
"is_exhibition": false
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.