Documentation / Compare and rank / 91 of 91

Direction of travel

GET/v1/direction

Each country's latest month against the same month a year before, in five bands from up strongly to down strongly, without the figures, with a tally of the bands.

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

Parameters

Name	Type	Description
limitoptional	integer query	Rows per page, 1 to 1000 e.g. 100
cursoroptional	string query	The next value from the previous page

Request

# Which way every country's latest month went
curl "https://api.tourismapi.com/v1/direction" \
  -H "X-API-Key: $TOURISM_API_KEY"

const res = await fetch("https://api.tourismapi.com/v1/direction", {
  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/direction",
    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/direction");
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_ab3741dbc8",
        "data_as_of": "2026-10-21T17:42:33Z",
        "count": 112,
        "bands": {
            "up strongly": "10% or more",
            "up": "2% to 10%",
            "flat": "within 2%",
            "down": "2% to 10% lower",
            "down strongly": "10% or more lower"
        },
        "compared_with": "the same month a year before",
        "tally": {
            "up strongly": 30,
            "flat": 30,
            "down": 20,
            "up": 25,
            "down strongly": 7
        },
        "figures": "the figures and exact changes come with the paid plans: https://tourismapi.com/pricing"
    },
    "data": [
        {
            "iso": "AL",
            "name": "Albania",
            "region": "Europe",
            "month": "2026-08",
            "direction": "up strongly"
        },
        {
            "iso": "AO",
            "name": "Angola",
            "region": "Middle East and Africa",
            "month": "2023-12",
            "direction": "flat"
        },
        {
            "iso": "AI",
            "name": "Anguilla",
            "region": "Other",
            "month": "2026-06",
            "direction": "up strongly"
        }
    ]
}

Response fields

Field	Type	Example
iso	string	AL
name	string	Albania
region	string	Europe
month	string	2026-08
direction	string	up strongly