Documentation / Statistics / 36 of 75

Trend

GET/v1/stats/trend

Each month with the seasonal swing taken out, plus the underlying trend, so one month can be read against the last without the calendar getting in the way. Classical multiplicative decomposition on a 2x12 centred average. 51 countries.

Analyst plan and upKey requiredJSON or CSVCached until the next release

Parameters

Name	Type	Description
countryrequired	string query	ISO code of a country that carries this statistic (listed at /v1/countries/{iso}) e.g. JP
fromoptional	period query	First month to return e.g. 2024-01

Request

# Seasonally adjusted figures and the trend
curl "https://api.tourismapi.com/v1/stats/trend?country=JP" \
  -H "X-API-Key: $TOURISM_API_KEY"

const res = await fetch("https://api.tourismapi.com/v1/stats/trend?country=JP", {
  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/stats/trend?country=JP",
    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/stats/trend?country=JP");
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"]);

Your API key

Ready

Example response

{
    "meta": {
        "request_id": "req_0377f162f0",
        "data_as_of": "2026-10-20T04:48:18Z",
        "count": 96,
        "country": "JP",
        "method": {
            "series": "Visitor arrivals to Japan from Total",
            "unit": "visitors",
            "first": "2003-01",
            "last": "2026-08",
            "seasonal_factors": {
                "03": 0.9303,
                "04": 1.0119,
                "05": 0.9185,
                "06": 0.8245,
                "07": 0.9821,
                "08": 0.885,
                "09": 0.8662,
                "10": 1.0731,
                "11": 1.0974,
                "12": 1.2396,
                "01": 1.3019,
                "02": 0.8696
            },
            "method": "multiplicative decomposition, 2x12 centred average"
        }
    },
    "data": [
        {
            "period": "2018-09",
            "adjusted": 2493188.1
        },
        {
            "period": "2018-10",
            "adjusted": 2460823.7
        },
        {
            "period": "2018-11",
            "adjusted": 2233298.6
        }
    ]
}

Response fields

Field	Type	Example
period	string	2018-09
adjusted	number	2493188.1