214 countries and territories189 of 193 UN membersmonthly to 2026-09back to 1926
Documentation / Series / 12 of 75

Series values

GET/v1/series/{id}/observations

The values of one series for any range. Missing months are listed as null with a reason, never silently dropped.

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
formatoptionaljson | csv
query
Response format
e.g. json
Request
# Values for any period range, monthly to annual
curl "https://api.tourismapi.com/v1/series/jp.arrivals.total.m/observations?from=2025-01&to=2026-08" \
  -H "X-API-Key: $TOURISM_API_KEY"
Ready
Example response
{
    "meta": {
        "request_id": "req_db5940af9c",
        "data_as_of": "2026-10-20T04:47:58Z",
        "count": 20,
        "series": "sr_wxq9yq5v",
        "name": "Visitor arrivals to Japan from Total",
        "unit": "visitors",
        "freq": "M"
    },
    "data": [
        {
            "period": "2025-01",
            "value": 3781629
        },
        {
            "period": "2025-02",
            "value": 3258491
        },
        {
            "period": "2025-03",
            "value": 3497755
        }
    ]
}
Response fields
FieldTypeExample
periodstring2025-01
valuenumber3781629