Seasonality
GET
/v1/seasonalityThe average shape of a year for a series, peak and low months, and how strong the swing is.
Developer plan and upKey requiredJSON or CSVCached until the next release
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string path | Series id from /v1/series e.g. jp.arrivals.total.m |
| fromoptional | period query | First period to return e.g. 2025-01 |
| tooptional | period query | Last period to return e.g. 2026-08 |
Request
# Seasonal profile and peak months for a series
curl "https://api.tourismapi.com/v1/seasonality?id=jp.arrivals.total.m&from=2025-01&to=2026-08" \
-H "X-API-Key: $TOURISM_API_KEY"const res = await fetch("https://api.tourismapi.com/v1/seasonality?id=jp.arrivals.total.m&from=2025-01&to=2026-08", {
headers: { "X-API-Key": process.env.TOURISM_API_KEY }
});
if (!res.ok) throw new Error(`Tourism API ${res.status}`);
const { meta, data } = await res.json();
console.log(meta.data_as_of, data);import os, requests
r = requests.get(
"https://api.tourismapi.com/v1/seasonality?id=jp.arrivals.total.m&from=2025-01&to=2026-08",
headers={"X-API-Key": os.environ["TOURISM_API_KEY"]},
timeout=10,
)
r.raise_for_status()
body = r.json()
print(body["meta"]["data_as_of"], body["data"])$ch = curl_init("https://api.tourismapi.com/v1/seasonality?id=jp.arrivals.total.m&from=2025-01&to=2026-08");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["X-API-Key: " . getenv("TOURISM_API_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
print_r($body["data"]);
Example response
{
"meta": {
"request_id": "req_95d5ab4a86",
"data_as_of": "2026-10-20T04:48:17Z",
"count": 12,
"series": "sr_wxq9yq5v",
"years": [
"2025"
],
"index": "each month as a percentage of its year's monthly average (median across years); 100 is an average month"
},
"data": [
{
"month": 1,
"index": 106.3,
"low": 106.3,
"high": 106.3
},
{
"month": 2,
"index": 91.6,
"low": 91.6,
"high": 91.6
},
{
"month": 3,
"index": 98.3,
"low": 98.3,
"high": 98.3
}
]
}Response fields
| Field | Type | Example |
|---|---|---|
| month | number | 1 |
| index | number | 106.3 |
| low | number | 106.3 |
| high | number | 106.3 |