Documentation / Countries / 1 of 107

All countries

GET/v1/countries

Lists every place we hold with how far back each goes, how fresh its newest month is, and which measures it carries. Start here to see what you can ask for.

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

Parameters

Name	Type	Description
freqoptional	M \| Q \| A query	Frequency: monthly, quarterly or annual e.g. M
limitoptional	integer query	Rows per page, 1 to 1000 e.g. 100
formatoptional	json \| csv query	Response format e.g. json

Request

# Every country and territory held, with depth and freshness
curl "https://api.tourismapi.com/v1/countries" \
  -H "X-API-Key: $TOURISM_API_KEY"

const res = await fetch("https://api.tourismapi.com/v1/countries", {
  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/countries",
    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/countries");
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_6f6c5c58fe",
        "data_as_of": "2026-11-07T04:49:20Z",
        "count": 161
    },
    "data": [
        {
            "iso": "HK",
            "name": "Hong Kong",
            "region": "Asia Pacific",
            "monthly": true,
            "first": "2021",
            "latest": "2026-11-06",
            "months_behind": 1,
            "measures": [
                "arrivals"
            ],
            "iso3": "HKG",
            "wikidata_id": "Q8646"
        },
        {
            "iso": "IL",
            "name": "Israel",
            "region": "Middle East and Africa",
            "monthly": true,
            "first": "2007",
            "latest": "2026-10",
            "months_behind": 1,
            "measures": [
                "arrivals",
                "nights"
            ],
            "iso3": "ISR",
            "wikidata_id": "Q801"
        },
        {
            "iso": "SI",
            "name": "Slovenia",
            "region": "Europe",
            "monthly": true,
            "first": "1949",
            "latest": "2026-11-01",
            "months_behind": 1,
            "measures": [
                "arrivals",
                "nights",
                "spend"
            ],
            "iso3": "SVN",
            "wikidata_id": "Q215"
        }
    ]
}

Response fields

Field	Type	Example
iso	string	HK
name	string	Hong Kong
region	string	Asia Pacific
monthly	boolean	true
first	string	2021
latest	string	2026-11-06
months_behind	number	1
measures	array	1 items
iso3	string	HKG
wikidata_id	string	Q8646