Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Whisky Hunter Auctions API
description: The Whisky Hunter API provides free, public access to historical whisky auction data collected from 28 online whisky auction sites.
version: v1
contact:
name: Whisky Hunter
url: https://whiskyhunter.net
license:
name: Public Data - No Authentication Required
servers:
- url: https://whiskyhunter.net/api
description: Whisky Hunter API
tags:
- name: Auctions
paths:
/auctions_data/:
get:
operationId: getAuctionsData
summary: Get Auctions Data
description: Returns aggregated auction data across all tracked whisky auction platforms. Includes trading volume, winning bid statistics, and lot counts per auction per date period. All monetary values are in GBP (£).
tags:
- Auctions
parameters:
- name: format
in: query
required: false
description: Response format.
schema:
type: string
enum:
- json
default: json
responses:
'200':
description: Aggregated auction data across all tracked platforms.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/AuctionDataPoint'
components:
schemas:
AuctionDataPoint:
type: object
description: A data point representing aggregated auction statistics for one auction platform at a specific time.
properties:
dt:
type: string
format: date
description: Date of the auction data point (YYYY-MM-DD).
auction_name:
type: string
description: Name of the whisky auction platform.
example: Scotch Whisky Auctions
auction_slug:
type: string
description: URL-safe identifier for the auction platform.
example: scotch-whisky-auctions
auction_trading_volume:
type: number
description: Total trading volume (sum of winning bids) for this auction in GBP (£).
minimum: 0
auction_lots_count:
type: integer
description: Number of lots sold in this auction.
minimum: 0
all_auctions_lots_count:
type: integer
description: Total number of lots sold across all tracked auctions for this period.
minimum: 0
winning_bid_max:
type: number
description: Maximum winning bid in this auction in GBP (£).
minimum: 0
winning_bid_min:
type: number
description: Minimum winning bid in this auction in GBP (£).
minimum: 0
winning_bid_mean:
type: number
description: Mean (average) winning bid in this auction in GBP (£).
minimum: 0