Documentation / Compare and rank / 35 of 75

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-10-20T04:48:18Z",
        "count": 109,
        "measure": "arrivals",
        "note": "Records are over the months your plan can see."
    },
    "data": [
        {
            "country": "BE",
            "name": "Belgium",
            "series": "sr_6vm9se5n",
            "unit": "Number",
            "record_period": "2026-07",
            "record_value": 2126258,
            "latest_period": "2026-07",
            "latest_value": 2126258,
            "pct_of_record": 100,
            "latest_is_record": true
        },
        {
            "country": "DE",
            "name": "Germany",
            "series": "sr_wjq538vh",
            "unit": "Number",
            "record_period": "2026-07",
            "record_value": 20797973,
            "latest_period": "2026-07",
            "latest_value": 20797973,
            "pct_of_record": 100,
            "latest_is_record": true
        },
        {
            "country": "GH",
            "name": "Ghana",
            "series": "sr_emgc50w7",
            "unit": "visitors",
            "record_period": "2025-12",
            "record_value": 141186,
            "latest_period": "2025-12",
            "latest_value": 141186,
            "pct_of_record": 100,
            "latest_is_record": true
        }
    ]
}

Response fields

Field	Type	Example
country	string	BE
name	string	Belgium
series	string	sr_6vm9se5n
unit	string	Number
record_period	string	2026-07
record_value	number	2126258
latest_period	string	2026-07
latest_value	number	2126258
pct_of_record	number	100
latest_is_record	boolean	true