Documentation / Countries / 1 of 75

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-10-20T04:47:58Z",
        "count": 214
    },
    "data": [
        {
            "iso": "BT",
            "name": "Bhutan",
            "region": "Asia Pacific",
            "monthly": true,
            "first": "2025",
            "latest": "2026-09",
            "months_behind": 1,
            "measures": [
                "arrivals",
                "spend"
            ],
            "iso3": "BTN",
            "wikidata_id": "Q917"
        },
        {
            "iso": "CA",
            "name": "Canada",
            "region": "Americas",
            "monthly": true,
            "first": "1972",
            "latest": "2026-09-30",
            "months_behind": 1,
            "measures": [
                "arrivals",
                "nights",
                "spend"
            ],
            "iso3": "CAN",
            "wikidata_id": "Q16"
        },
        {
            "iso": "CR",
            "name": "Costa Rica",
            "region": "Americas",
            "monthly": true,
            "first": "2019",
            "latest": "2026-09",
            "months_behind": 1,
            "measures": [
                "arrivals",
                "nights",
                "spend"
            ],
            "iso3": "CRI",
            "wikidata_id": "Q800"
        }
    ]
}

Response fields

Field	Type	Example
iso	string	BT
name	string	Bhutan
region	string	Asia Pacific
monthly	boolean	true
first	string	2025
latest	string	2026-09
months_behind	number	1
measures	array	2 items
iso3	string	BTN
wikidata_id	string	Q917