Nowcast
GET
/v1/stats/nowcastAn estimate for each month between a country's last published figure and last month, from the seasonal pattern and the latest year-on-year change. Always estimated: true, and replaced the moment the office publishes. 45 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 |
| leveloptional | 80 | 95 query | Width of the range returned with each value e.g. 80 |
Request
# Months the office has not published yet
curl "https://api.tourismapi.com/v1/stats/nowcast?country=JP" \
-H "X-API-Key: $TOURISM_API_KEY"const res = await fetch("https://api.tourismapi.com/v1/stats/nowcast?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/nowcast?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/nowcast?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_28692f383c",
"data_as_of": "2026-10-20T04:48:18Z",
"count": 1,
"country": "JP",
"method": {
"series": "Visitor arrivals to Japan from Total",
"unit": "visitors",
"first": "2003-01",
"last": "2026-08",
"published_to": "2026-08",
"estimated_to": "2026-09",
"yoy_used": 0.9458,
"method": "same month last year times the average year-on-year change of the last 3 published months"
}
},
"data": [
{
"period": "2026-09",
"value": 3090230,
"low": 2848972,
"high": 3351918,
"estimated": true
}
]
}Response fields
| Field | Type | Example |
|---|---|---|
| period | string | 2026-09 |
| value | number | 3090230 |
| low | number | 2848972 |
| high | number | 3351918 |
| estimated | boolean | true |