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

Length of stay

GET/v1/stats/stay-length

Average length of stay: nights divided by arrivals, month by month, wherever one table publishes both.

Analyst plan and upKey requiredJSON or CSVCached until the next release
Parameters
NameTypeDescription
countryrequiredstring
query
ISO code of a country that carries this statistic (listed at /v1/countries/{iso})
e.g. JP
fromoptionalperiod
query
First month to return
e.g. 2024-01
Request
# Nights per arrival and its trend
curl "https://api.tourismapi.com/v1/stats/stay-length?country=JP" \
  -H "X-API-Key: $TOURISM_API_KEY"
Ready
Example response
{
    "meta": {
        "request_id": "req_7f3a23",
        "data_as_of": "2026-10-12T21:57:29Z",
        "count": 2,
        "next": null
    },
    "data": [
        {
            "period": "2026-07",
            "nights_per_arrival": 2.18
        },
        {
            "period": "2026-08",
            "nights_per_arrival": 2.12
        }
    ]
}
Response fields
FieldTypeExample
periodstring2026-07
nights_per_arrivalnumber2.18