Documentation / Compare and rank / 50 of 107

Records

GET/v1/records

Each country's best month on record for one measure, its latest month, and the latest as a percent of the record.

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

Request

# Each country's best month, and how close it is now
curl "https://api.tourismapi.com/v1/records?measure=arrivals" \
  -H "X-API-Key: $TOURISM_API_KEY"

const res = await fetch("https://api.tourismapi.com/v1/records?measure=arrivals", {
  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/records?measure=arrivals",
    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/records?measure=arrivals");
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_e734e1a908",
        "data_as_of": "2026-11-07T04:51:47Z",
        "count": 121,
        "measure": "arrivals",
        "note": "Records are over the months your plan can see."
    },
    "data": [
        {
            "country": "AT",
            "name": "Austria",
            "series": "sr_tn5yvzzv",
            "unit": "Number",
            "record_period": "2026-08",
            "record_value": 5667172,
            "latest_period": "2026-08",
            "latest_value": 5667172,
            "pct_of_record": 100,
            "latest_is_record": true
        },
        {
            "country": "BO",
            "name": "Bolivia",
            "series": "sr_4ajhn206",
            "unit": "travellers",
            "record_period": "2026-08",
            "record_value": 193686.5,
            "latest_period": "2026-08",
            "latest_value": 193686.5,
            "pct_of_record": 100,
            "latest_is_record": true
        },
        {
            "country": "CZ",
            "name": "Czechia",
            "series": "sr_hkve9r99",
            "unit": "Number",
            "record_period": "2026-08",
            "record_value": 3006002,
            "latest_period": "2026-08",
            "latest_value": 3006002,
            "pct_of_record": 100,
            "latest_is_record": true
        }
    ]
}

Response fields

Field	Type	Example
country	string	AT
name	string	Austria
series	string	sr_tn5yvzzv
unit	string	Number
record_period	string	2026-08
record_value	number	5667172
latest_period	string	2026-08
latest_value	number	5667172
pct_of_record	number	100
latest_is_record	boolean	true