Market share
GET
/v1/shareOne destination's share of arrivals from a source market across a group of destinations.
Developer plan and upKey requiredJSON or CSVCached until the next release
Parameters
| Name | Type | Description |
|---|---|---|
| countryoptional | string query | One or more ISO codes, comma separated e.g. CL,BA,AT |
| originoptional | string query | Country of residence of the visitor e.g. DE |
| periodoptional | period query | One period; defaults to the latest finished one e.g. 2026-08 |
Request
# A destination's share of a group of markets
curl "https://api.tourismapi.com/v1/share?country=TH&origin=CN" \
-H "X-API-Key: $TOURISM_API_KEY"const res = await fetch("https://api.tourismapi.com/v1/share?country=TH&origin=CN", {
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/share?country=TH&origin=CN",
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/share?country=TH&origin=CN");
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"]);
Example response
{
"meta": {
"request_id": "req_0a857a392e",
"data_as_of": "2026-11-07T04:51:46Z",
"count": 1,
"total_from": "the sum of every market counted"
},
"data": {
"country": "TH",
"origin": "CN",
"period": "2026-09",
"series": "sr_w0c0m2wv",
"unit": "tourists",
"value": 349182,
"total": 7753616,
"share_pct": 4.5,
"year_before": 321309
}
}Response fields
| Field | Type | Example |
|---|---|---|
| country | string | TH |
| origin | string | CN |
| period | string | 2026-09 |
| series | string | sr_w0c0m2wv |
| unit | string | tourists |
| value | number | 349182 |
| total | number | 7753616 |
| share_pct | number | 4.5 |
| year_before | number | 321309 |