Service metadata

Code snippets

curl "https://api.oanor.com/whisky-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/whisky-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/whisky-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/whisky-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "regions": {
            "Islay": 7,
            "Islands": 6,
            "Lowlands": 3,
            "Speyside": 43,
            "Highlands": 25,
            "Campbelltown": 2
        },
        "service": "whisky-api",
        "endpoints": {
            "GET /v1/list": "List all distilleries (limit, offset).",
            "GET /v1/meta": "This document.",
            "GET /v1/rank": "Rank distilleries by a flavour axis (by=smoky|body|…, order, limit).",
            "GET /v1/region": "Distilleries in a whisky region (region=, e.g. Islay).",
            "GET /v1/search": "Search distilleries by name or region (q=).",
            "GET /v1/similar": "Distilleries most similar in flavour to one (name=, limit).",
            "GET /v1/distillery": "Distillery profile by name (name=, e.g. Lagavulin)."
        },
        "description": "Scotch whisky flavour profiles for 86 Scottish single-malt distilleries (Wishart dataset): twelve flavour axes scored 0–4 plus region. Look up a distillery, find the most similar by flavour, rank by any flavour, list a region, or search. Distinct from cocktails-api. No key.",
        "flavour_axes": [
            "body",
            "sweetness",
            "smoky",
            "medicinal",
            "tobacco",
            "honey",
            "spicy",
            "winey",
            "nutty",
            "malty",
            "fruity",
            "floral"
        ],
        "total_distilleries": 86
    },
    "meta": {
        "timestamp": "2026-06-09T03:03:49.111Z",
        "request_id": "2225a2b1-0ec9-4c4a-b572-3b322b3dd113"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}