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
| Address | Returns |
|---|---|
index.json | Version, license, and a list of every record with its slug and address. |
traditions.json | All 28 traditions as one array. |
headwear.json | All 12 kinds of bath headwear as one array. |
traditions/{slug}.json | One tradition, with slug, url and a headwear array of the headwear rows that belong to it. |
headwear/{slug}.json | One 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
| Field | Type | Meaning |
|---|---|---|
name | string | English name of the tradition or room type. Unique. |
local_name | string or null | Name in the local language, with transliteration where useful. |
country_or_region | string | Where the tradition comes from or is mainly practiced. |
category | string | Broad type: dry sauna, steam sauna, smoke sauna, steam bath, hot-water bath and so on. |
heat_source | string | How the room or water is heated. |
typical_air_temp_c_min, typical_air_temp_c_max | integer or null | Commonly quoted air temperature range, °C. |
typical_air_temp_f_min, typical_air_temp_f_max | integer or null | The same range in °F, rounded to the nearest degree. |
typical_water_temp_c_min, typical_water_temp_c_max | integer or null | Typical bathing-water temperature, °C. Only for hot-water baths. |
typical_water_temp_f_min, typical_water_temp_f_max | integer or null | The same range in °F. |
typical_relative_humidity | string or null | low, medium or high. |
typical_relative_humidity_pct_min, typical_relative_humidity_pct_max | integer or null | Rough relative humidity range in percent, only where one is commonly quoted. |
typical_round_minutes_min, typical_round_minutes_max | integer or null | Typical length of one stay in the hot room, in minutes. A habit, not a recommendation. |
water_on_stones | string or null | yes, no, sometimes, or n-a (no stones in this type of room). |
whisk_or_ritual | string or null | Whisks, scrubs, infusions and other customary practices. |
headwear_traditionally_worn | string or null | yes, sometimes or no. |
headwear_note | string or null | Short note on what is worn on the head, if anything. |
cooling_practice | string or null | How bathers cool down between or after rounds. |
unesco_status | string or null | UNESCO Intangible Cultural Heritage inscription, if any. |
notes | string or null | Context and caveats, including why a value was left empty. |
Fields of a headwear record
| Field | Type | Meaning |
|---|---|---|
headwear_name | string | English name of the headwear type. |
local_name | string or null | Local-language name, where one is in common use. |
tradition | string or null | The name of a tradition, or null for general types. |
region | string | Where it is used. |
material | string | Usual material. |
shape | string | Usual shape. |
worn_dry_or_wet | string | dry, varies or n-a. Wool felt hats are worn dry. |
purpose | string | What it is for. |
notes | string or null | Extra 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
- finnish-sauna
- finnish-smoke-sauna
- estonian-sauna
- estonian-smoke-sauna-voromaa
- swedish-bastu
- norwegian-badstue
- russian-banya
- russian-black-banya
- lithuanian-pirtis
- latvian-pirts
- german-aufguss-sauna
- bio-sauna-soft-sauna
- infrared-sauna
- steam-room
- north-american-gym-or-club-sauna
- turkish-hammam
- moroccan-hammam
- georgian-sulfur-bath
- roman-baths-historical
- irish-sweat-house-historical
- japanese-sento
- japanese-onsen
- japanese-sauna
- korean-jjimjilbang
- korean-hanjeungmak
- native-american-sweat-lodge
- temazcal
- icelandic-geothermal-pool-and-hot-tub
Headwear
- banya-hat
- finnish-sauna-hat
- estonian-sauna-hat
- latvian-pirts-hat
- lithuanian-pirtis-hat
- german-sauna-hat
- japanese-sauna-hat
- bucket-style-felt-sauna-hat
- linen-or-cotton-sauna-cap
- sheep-head-towel
- hammam-head-towel
- folded-head-towel
Version and stability
- Dataset version 1.0 (2026-11).
index.jsoncarries the version asdataset_version. - Field names and slugs stay the same within version 1. New records and new fields may be added, so ignore fields you do not know.
- The API is a free service with no guarantee of uptime. For anything that must not break, download the files and host your own copy; the license allows it.
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.
Open the explorer