214 countries and territories189 of 193 UN membersmonthly to 2026-09back to 1926
Documentation / Compare and rank / 33 of 75

Seasonality

GET/v1/seasonality

The 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
NameTypeDescription
idrequiredstring
path
Series id from /v1/series
e.g. jp.arrivals.total.m
fromoptionalperiod
query
First period to return
e.g. 2025-01
tooptionalperiod
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"
Ready
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
FieldTypeExample
monthnumber1
indexnumber106.3
lownumber106.3
highnumber106.3