Skip to the documentation
DIVELUX Open the explorer

Sauna Traditions API

28 sauna and bathing traditions and 12 kinds of bath headwear as plain JSON files. No key, no sign-up, no rate limit.

This is a static API: a folder of JSON files on GitHub Pages. There is no server behind it, so there are no query parameters. You fetch a whole table, or one record by its slug, and filter in your own code. The files change only when a new version of the dataset is published.

Base address: https://divelux.github.io/sauna-traditions-explorer/api/

Endpoints

AddressReturns
index.jsonVersion, license, and a list of every record with its slug and address.
traditions.jsonAll 28 traditions as one array.
headwear.jsonAll 12 kinds of bath headwear as one array.
traditions/{slug}.jsonOne tradition, with slug, url and a headwear array of the headwear rows that belong to it.
headwear/{slug}.jsonOne kind of headwear, with slug, url, tradition_slug and tradition_url.

A slug is the English name in lower case with accents removed and everything else turned into hyphens: "Estonian smoke sauna (Võromaa)" becomes estonian-smoke-sauna-voromaa. A slug that does not exist returns a 404 page, not JSON.

Examples

Command line

curl https://divelux.github.io/sauna-traditions-explorer/api/traditions/russian-banya.json
{
  "slug": "russian-banya",
  "url": "https://divelux.github.io/sauna-traditions-explorer/api/traditions/russian-banya.json",
  "name": "Russian banya",
  "local_name": "баня (banya); лазня (laznia) in Ukrainian",
  "country_or_region": "Russia, Ukraine, Belarus and neighboring countries",
  "category": "steam sauna",
  "typical_air_temp_c_min": 60,
  "typical_air_temp_c_max": 90,
  "water_on_stones": "yes",
  "headwear_traditionally_worn": "yes",
  "...": "the other fields of the record",
  "headwear": [
    { "slug": "banya-hat", "headwear_name": "Banya hat", "...": "..." }
  ]
}

JavaScript

const base = 'https://divelux.github.io/sauna-traditions-explorer/api/';
const traditions = await (await fetch(base + 'traditions.json')).json();

// Traditions where water goes on the stones, hottest first
const hot = traditions
  .filter((t) => t.water_on_stones === 'yes' && t.typical_air_temp_c_max != null)
  .sort((a, b) => b.typical_air_temp_c_max - a.typical_air_temp_c_max);
console.log(hot.map((t) => t.name));

Python

import json, urllib.request

base = "https://divelux.github.io/sauna-traditions-explorer/api/"
with urllib.request.urlopen(base + "headwear.json") as r:
    headwear = json.load(r)
print([h["headwear_name"] for h in headwear if h["material"].startswith("Wool felt")])

GitHub Pages sends Access-Control-Allow-Origin: *, so fetch works from a page on any other site.

Fields of a tradition

FieldTypeMeaning
namestringEnglish name of the tradition or room type. Unique.
local_namestring or nullName in the local language, with transliteration where useful.
country_or_regionstringWhere the tradition comes from or is mainly practiced.
categorystringBroad type: dry sauna, steam sauna, smoke sauna, steam bath, hot-water bath and so on.
heat_sourcestringHow the room or water is heated.
typical_air_temp_c_min, typical_air_temp_c_maxinteger or nullCommonly quoted air temperature range, °C.
typical_air_temp_f_min, typical_air_temp_f_maxinteger or nullThe same range in °F, rounded to the nearest degree.
typical_water_temp_c_min, typical_water_temp_c_maxinteger or nullTypical bathing-water temperature, °C. Only for hot-water baths.
typical_water_temp_f_min, typical_water_temp_f_maxinteger or nullThe same range in °F.
typical_relative_humiditystring or nulllow, medium or high.
typical_relative_humidity_pct_min, typical_relative_humidity_pct_maxinteger or nullRough relative humidity range in percent, only where one is commonly quoted.
typical_round_minutes_min, typical_round_minutes_maxinteger or nullTypical length of one stay in the hot room, in minutes. A habit, not a recommendation.
water_on_stonesstring or nullyes, no, sometimes, or n-a (no stones in this type of room).
whisk_or_ritualstring or nullWhisks, scrubs, infusions and other customary practices.
headwear_traditionally_wornstring or nullyes, sometimes or no.
headwear_notestring or nullShort note on what is worn on the head, if anything.
cooling_practicestring or nullHow bathers cool down between or after rounds.
unesco_statusstring or nullUNESCO Intangible Cultural Heritage inscription, if any.
notesstring or nullContext and caveats, including why a value was left empty.

Fields of a headwear record

FieldTypeMeaning
headwear_namestringEnglish name of the headwear type.
local_namestring or nullLocal-language name, where one is in common use.
traditionstring or nullThe name of a tradition, or null for general types.
regionstringWhere it is used.
materialstringUsual material.
shapestringUsual shape.
worn_dry_or_wetstringdry, varies or n-a. Wool felt hats are worn dry.
purposestringWhat it is for.
notesstring or nullExtra context.

Read this before you use the numbers. They are compiled reference ranges from general published descriptions, not measurements. null means "not stated": where published figures disagree, the dataset leaves the value empty on purpose, so always check for null before you compare. Session lengths are typical habits, not recommendations. Nothing here is medical advice.

Every record

Traditions

Headwear

Version and stability

License and credit

The data is licensed CC BY 4.0. Use it for anything, including commercial work, and give credit like this:

Sauna Traditions of the World, DIVELUX, CC BY 4.0
https://diveluxsaunahat.com/pages/sauna-tools

The full dataset with CSV files, a data dictionary and a validation script is on Hugging Face and archived on Zenodo at doi.org/10.5281/zenodo.24382690. To browse the same records with filters and a temperature scale, open the explorer.