Anomalies
GET
/v1/stats/anomaliesMonths where the figure sits well away from what trend and season predicted, scored in robust standard deviations, with the expected value beside it. 51 countries.
Intel 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 |
| min_scoreoptional | number query | Smallest score to return, in standard deviations (default 3) e.g. 3 |
Request
# Months far from what was expected
curl "https://api.tourismapi.com/v1/stats/anomalies?country=JP" \
-H "X-API-Key: $TOURISM_API_KEY"const res = await fetch("https://api.tourismapi.com/v1/stats/anomalies?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/anomalies?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/anomalies?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"]);
Example response
{
"meta": {
"request_id": "req_8e45be3bae",
"data_as_of": "2026-10-20T04:48:18Z",
"count": 19,
"country": "JP",
"method": {
"series": "Visitor arrivals to Japan from Total",
"unit": "visitors",
"first": "2003-01",
"last": "2026-08",
"months_checked": 84,
"flagged": 19,
"threshold_sd": 3,
"range_fields": "lo80 holds the expected value"
}
},
"data": [
{
"period": "2020-03",
"score": -6.6,
"expected": 974204.6
},
{
"period": "2020-04",
"score": -22.92,
"expected": 860332.4
},
{
"period": "2020-05",
"score": -23.7,
"expected": 595193.8
}
]
}Response fields
| Field | Type | Example |
|---|---|---|
| period | string | 2020-03 |
| score | number | -6.6 |
| expected | number | 974204.6 |