Documentation / Visitors and stays / 14 of 107

Nights

GET/v1/nights

Nights spent in tourist accommodation, total and split by residents and non-residents where published.

Developer plan and upKey requiredJSON or CSVCached until the next release

Parameters

Name	Type	Description
countryoptional	string query	One or more ISO codes, comma separated e.g. CL,BA,AT
freqoptional	M \| Q \| A query	Frequency: monthly, quarterly or annual e.g. M
fromoptional	period query	First period to return e.g. 2025-01
tooptional	period query	Last period to return e.g. 2026-08
formatoptional	json \| csv query	Response format e.g. json

Request

# Overnight stays in all accommodation
curl "https://api.tourismapi.com/v1/nights?country=CL,BA,AT&from=2025-01&to=2026-08" \
  -H "X-API-Key: $TOURISM_API_KEY"

const res = await fetch("https://api.tourismapi.com/v1/nights?country=CL,BA,AT&from=2025-01&to=2026-08", {
  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/nights?country=CL,BA,AT&from=2025-01&to=2026-08",
    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/nights?country=CL,BA,AT&from=2025-01&to=2026-08");
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_9f83727052",
        "data_as_of": "2026-11-07T04:49:21Z",
        "count": 3,
        "measure": "nights"
    },
    "data": [
        {
            "country": "CL",
            "series": "sr_za1n785e",
            "name": "Tourist nights in Chile: all establishments",
            "unit": "nights",
            "freq": "M",
            "observations": [
                {
                    "period": "2026-06",
                    "value": 1429414
                },
                {
                    "period": "2026-07",
                    "value": 1695480
                },
                {
                    "period": "2026-08",
                    "value": 1696082
                }
            ]
        },
        {
            "country": "BA",
            "series": "sr_226y4v9p",
            "name": "Tourist nights in Bosnia and Herzegovina: total",
            "unit": "nights",
            "freq": "M",
            "observations": [
                {
                    "period": "2026-06",
                    "value": 388414
                },
                {
                    "period": "2026-07",
                    "value": 510876
                },
                {
                    "period": "2026-08",
                    "value": 560221
                }
            ]
        },
        {
            "country": "AT",
            "series": "sr_gd25ecz9",
            "name": "Nights spent at accommodation: Total, Hotels; holiday and other short-stay accommodation; camping grounds, recreational vehicle parks and trailer parks",
            "unit": "Number",
            "freq": "M",
            "observations": [
                {
                    "period": "2026-06",
                    "value": 11309467
                },
                {
                    "period": "2026-07",
                    "value": 16595013
                },
                {
                    "period": "2026-08",
                    "value": 18132478
                }
            ]
        }
    ]
}

Response fields

Field	Type	Example
country	string	CL
series	string	sr_za1n785e
name	string	Tourist nights in Chile: all establishments
unit	string	nights
freq	string	M
observations	array	3 items