Whisky Bottle Identification

Searches whiskies based on a free-text query.

Returns a list of the most likely matching whiskies sorted by relevance.

Intended for scenarios where you only know a part of the whisky name (e.g. brand and release name), but not all whisky details. This is utilizing the Whiskystats Search, so you can test your queries on our website first.

Searches whiskies based on a full text description.

Returns a list of the most likely matching whiskies sorted by the similarity score which ranges from 0 to 1 where 1 indicates a perfect match.

Intended for scenarios where you have the complete text description of a whisky bottle, not just a short name.

If you already hold structured whisky data on your side, you can provide those key-value pairs in the description text field. That helps our algorithms pick up the correct attributes.

For best performance, align field names with our conventions:

• brand: The distillery or brand name.
• bottler: The name of the independent bottler.
• bottle_for: For whom (company/occasion) the whisky was bottled for.
• name: The bottling series/product name/edition.
• name_addition: Additional name information.
• vintage_year (four-digit integer): The year of distillation.
• bottle_year (four-digit integer): The year of bottling.
• age (integer): The age of the whisky in years.
• strength (numeric): The alcohol strength.
• strength_unit (string): Either '%vol', 'gradi' or 'proof'.
• cask_number (string): Identifier or number of the cask(s).
• batch_number (string): Identifier or number of the batch.
• bottle_size (integer): The size of the bottle in millilitres.
• bottle_count (integer): The number of released bottles.

Searches whiskies based on the provided bottle image.

Returns a list of the most likely matching whiskies sorted by the similarity score which ranges from 0 to 1.

Provide either a base64-encoded image or a publicly accessible image_url. Exactly one of these parameters is required.