Documentation / Population and reference / 86 of 107

What is held

GET/v1/coverage/matrix

Every country against arrivals, nights, spend, departures, occupancy and capacity: the first and latest period held in each, the frequencies and how many series. The figures themselves come with the paid plans.

On every plan, Free includedKey requiredJSON or CSVCached until the next release

Parameters

Name	Type	Description
limitoptional	integer query	Rows per page, 1 to 1000 e.g. 100
cursoroptional	string query	The next value from the previous page

Request

# Every country against every measure
curl "https://api.tourismapi.com/v1/coverage/matrix" \
  -H "X-API-Key: $TOURISM_API_KEY"

const res = await fetch("https://api.tourismapi.com/v1/coverage/matrix", {
  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/coverage/matrix",
    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/coverage/matrix");
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_819fdf9e27",
        "data_as_of": "2026-11-07T04:51:51Z",
        "count": 161,
        "measures": [
            "arrivals",
            "nights",
            "spend",
            "departures",
            "occupancy",
            "capacity"
        ],
        "cell": "first and latest period held, the frequencies (M monthly, Q quarterly, A yearly) and how many series; null when nothing is held",
        "figures": "the figures themselves come with the paid plans: https://tourismapi.com/pricing"
    },
    "data": [
        {
            "iso": "AL",
            "name": "Albania",
            "region": "Europe",
            "arrivals": {
                "first": "2017-06",
                "latest": "2026-09",
                "frequencies": [
                    "M",
                    "A"
                ],
                "series": 107
            },
            "nights": {
                "first": "2017-06",
                "latest": "2026-08",
                "frequencies": [
                    "M",
                    "A"
                ],
                "series": 141
            },
            "spend": {
                "first": "2015-Q1",
                "latest": "2026-Q2",
                "frequencies": [
                    "Q",
                    "A"
                ],
                "series": 808
            },
            "departures": {
                "first": "2017",
                "latest": "2020",
                "frequencies": [
                    "A"
                ],
                "series": 209
            },
            "occupancy": {
                "first": "2017-06",
                "latest": "2026-08",
                "frequencies": [
                    "M"
                ],
                "series": 2
            },
            "capacity": null
        },
        {
            "iso": "AS",
            "name": "American Samoa",
            "region": "Asia Pacific",
            "arrivals": {
                "first": "1995",
                "latest": "2020",
                "frequencies": [
                    "A"
                ],
                "series": 5
            },
            "nights": null,
            "spend": null,
            "departures": null,
            "occupancy": null,
            "capacity": null
        },
        {
            "iso": "AO",
            "name": "Angola",
            "region": "Middle East and Africa",
            "arrivals": {
                "first": "2022-01",
                "latest": "2023-12",
                "frequencies": [
                    "M"
                ],
                "series": 1
            },
            "nights": null,
            "spend": null,
            "departures": null,
            "occupancy": null,
            "capacity": null
        }
    ]
}

Response fields

Field	Type	Example
iso	string	AL
name	string	Albania
region	string	Europe
arrivals	object	object
nights	object	object
spend	object	object
departures	object	object
occupancy	object	object
capacity	null	null