Documentation / Compare and rank / 45 of 107

Rankings

GET/v1/rank

Every reporting country ranked on one measure for one period.

Developer plan and upKey requiredJSON or CSVCached until the next release

Parameters

Name	Type	Description
measurerequired	string query	arrivals, nights, spend, departures, occupancy or capacity e.g. arrivals
periodoptional	period query	One period; defaults to the latest finished one e.g. 2026-08
limitoptional	integer query	Rows per page, 1 to 1000 e.g. 100

Request

# Countries ranked on any measure and period
curl "https://api.tourismapi.com/v1/rank?measure=arrivals&period=2026-08" \
  -H "X-API-Key: $TOURISM_API_KEY"

const res = await fetch("https://api.tourismapi.com/v1/rank?measure=arrivals&period=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/rank?measure=arrivals&period=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/rank?measure=arrivals&period=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_9c3babe112",
        "data_as_of": "2026-11-07T04:51:46Z",
        "count": 50,
        "measure": "arrivals",
        "period": "2026-08",
        "note": "Each country's own headline series; units can differ (arrivals at hotels, at the border, or visitors)."
    },
    "data": [
        {
            "rank": 1,
            "country": "FR",
            "name": "France",
            "series": "sr_fea62wdk",
            "unit": "Number",
            "period": "2026-08",
            "value": 26741423,
            "year_before": 27088143,
            "yoy_pct": -1.3
        },
        {
            "rank": 2,
            "country": "IT",
            "name": "Italy",
            "series": "sr_wcgzphp5",
            "unit": "Number",
            "period": "2026-08",
            "value": 22358898,
            "year_before": 22281550,
            "yoy_pct": 0.3
        },
        {
            "rank": 3,
            "country": "DE",
            "name": "Germany",
            "series": "sr_wjq538vh",
            "unit": "Number",
            "period": "2026-08",
            "value": 20158287,
            "year_before": 20207897,
            "yoy_pct": -0.2
        }
    ]
}

Response fields

Field	Type	Example
rank	number	1
country	string	FR
name	string	France
series	string	sr_fea62wdk
unit	string	Number
period	string	2026-08
value	number	26741423
year_before	number	27088143
yoy_pct	number	-1.3