Whiskystats Data API
Data Concepts

Whisky IDs

The Whisky IDs uniquely identify a whisky in our database. They serve as the linking pins to all whisky-related information, including ratings, auction results, and shop prices. There are two different types of Whisky IDs: "Whiskybase IDs" (prefix "WB") and "Bottle Group IDs" (prefix "BG").

You can use the Whisky IDs in the Whiskystats Search to directly find a specific whisky.

Whiskybase IDs ("WB*")

Whiskystats builds on the Whiskybase bottle database. Each whisky in the Whiskybase database is identified by the "Whiskybase ID". To distinguish the Whiskybase ID from other IDs, "WB" is used as the prefix. If you don't provide a prefix but just a number, the Whiskystats Data API endpoints will interpret the number as a Whiskybase ID.

Bottle Group IDs ("BG*)

Sometimes, the exact Whiskybase bottle cannot be identified due to missing information, such as bottle codes or barcodes. For those cases, Whiskystats groups together Whiskybase bottles which only differ in marginal details. Those "Bottle Groups" are identified by the Bottle Group ID, for which "BG" is used as the prefix.

Each bottle group has a "leading" Whiskybase ID. If certain information was mapped to a bottle group, but the specific context requires a Whiskybase ID (e.g. for linking back to Whiskybase), the leading Whiskybase ID is used for that purpose.

Last modified on