{ "openapi": "3.1.0", "info": { "title": "Tourism API", "version": "1.0.0", "description": "Official tourism statistics for every country.", "termsOfService": "https://tourismapi.com/terms" }, "servers": [ { "url": "https://api.tourismapi.com" } ], "security": [ { "ApiKey": [] } ], "components": { "securitySchemes": { "ApiKey": { "type": "apiKey", "in": "header", "name": "X-API-Key" } }, "responses": { "Error": { "description": "An error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "plan": { "type": "string" }, "docs": { "type": "string" } } } } } } } } } }, "paths": { "/v1/countries": { "get": { "operationId": "countries", "summary": "Every country and territory held, with depth and freshness", "description": "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. Plan: Free and up.", "tags": [ "Countries" ], "parameters": [ { "name": "freq", "in": "query", "required": false, "description": "Frequency: monthly, quarterly or annual", "schema": { "type": "string", "example": "M" } }, { "name": "limit", "in": "query", "required": false, "description": "Rows per page, 1 to 1000", "schema": { "type": "integer", "example": "100" } }, { "name": "format", "in": "query", "required": false, "description": "Response format", "schema": { "type": "string", "example": "json" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/countries" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "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" } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/countries/{iso}": { "get": { "operationId": "countries_iso", "summary": "One country: measures, first and latest period", "description": "Everything held for one country: each measure, its frequency, first and latest period, and the series behind it. Plan: Free and up.", "tags": [ "Countries" ], "parameters": [ { "name": "iso", "in": "path", "required": true, "description": "ISO 3166 two-letter country code", "schema": { "type": "string", "example": "CL" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/countries-iso" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_854b538771", "data_as_of": "2026-10-20T04:47:58Z", "count": 1 }, "data": { "iso": "CL", "name": "Chile", "region": "Americas", "monthly": true, "first": "2026", "latest": "2026-08", "months_behind": 2, "measures": [ "arrivals", "nights", "spend" ], "statistics": [], "iso3": "CHL", "wikidata_id": "Q298" } } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/countries/{iso}/coverage": { "get": { "operationId": "countries_iso_coverage", "summary": "What each measure covers for a country, month by month", "description": "A month-by-month grid of which measures have a value, so you can see gaps before you query. Plan: Developer and up.", "tags": [ "Countries" ], "parameters": [ { "name": "iso", "in": "path", "required": true, "description": "ISO 3166 two-letter country code", "schema": { "type": "string", "example": "CL" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/countries-iso-coverage" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_9e29ea8228", "data_as_of": "2026-10-20T04:47:58Z", "count": 17, "country": "CL", "name": "Chile" }, "data": [ { "measure": "arrivals", "freq": "A", "breakdown": "total", "series": 2, "first": "2008", "last": "2024", "headline": "sr_gnvbx5rt" }, { "measure": "arrivals", "freq": "M", "breakdown": "accommodation", "series": 1, "first": "2026-06", "last": "2026-08", "headline": null }, { "measure": "capacity", "freq": "M", "breakdown": "total", "series": 6, "first": "2026-06", "last": "2026-08", "headline": null } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/countries/{iso}/latest": { "get": { "operationId": "countries_iso_latest", "summary": "The newest figure for every measure in one call", "description": "The newest finished period for every measure in a single response, with the change on the same period last year. Plan: Free and up.", "tags": [ "Countries" ], "parameters": [ { "name": "iso", "in": "path", "required": true, "description": "ISO 3166 two-letter country code", "schema": { "type": "string", "example": "CL" } }, { "name": "currency", "in": "query", "required": false, "description": "Convert money to this ISO 4217 currency at each period's rate", "schema": { "type": "string", "example": "USD" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/countries-iso-latest" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_7f3a1c", "data_as_of": "2026-10-12T12:01:11Z", "count": 1, "next": null }, "data": { "iso": "CL", "period": "2026-08", "figures": [ { "measure": "arrivals", "value": 798946, "unit": "arrivals", "yoy_pct": -1.8 }, { "measure": "nights", "value": 1696082, "unit": "nights", "yoy_pct": -0.7 }, { "measure": "adr", "value": 89828, "unit": "CLP", "yoy_pct": 1.6 } ] } } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/regions": { "get": { "operationId": "regions", "summary": "World regions and the countries in each", "description": "The regions used across the API and the ISO codes in each. Plan: Free and up.", "tags": [ "Countries" ], "parameters": [], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/regions" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_bb79abe3b1", "data_as_of": "2026-10-20T04:47:58Z", "count": 5 }, "data": [ { "region": "americas", "name": "Americas", "countries": [ "VE", "HT", "GY" ] }, { "region": "asia-pacific", "name": "Asia Pacific", "countries": [ "FM", "AS", "MM" ] }, { "region": "europe", "name": "Europe", "countries": [ "KG", "BY", "FO" ] } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/regions/{region}": { "get": { "operationId": "regions_region", "summary": "Regional totals built from national figures", "description": "Totals for a region built from its countries' own figures, with how many countries reported in each period. Plan: Developer and up.", "tags": [ "Countries" ], "parameters": [ { "name": "region", "in": "path", "required": true, "description": "Region code from /v1/regions", "schema": { "type": "string", "example": "europe" } }, { "name": "measure", "in": "query", "required": true, "description": "arrivals, nights, spend, departures, occupancy or capacity", "schema": { "type": "string", "example": "arrivals" } }, { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } }, { "name": "to", "in": "query", "required": false, "description": "Last period to return", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/regions-region" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_ac2f4bfa96", "data_as_of": "2026-10-20T04:47:58Z", "count": 20, "region": "europe", "name": "Europe", "measure": "arrivals", "countries": [ "FR", "GI", "IE", "SI", "AT", "CH", "EE", "ES", "FI", "GB", "HR", "HU", "IS", "IT", "LV", "ME", "NL", "NO", "TR", "AL", "BE", "BG", "CY", "CZ", "DE", "DK", "GR", "LI", "LT", "LU", "MK", "PL", "PT", "RO", "RS", "SE", "SK", "SM", "XK" ], "note": "The sum of each country's own headline series; countries count arrivals in their own way, and a month with fewer countries reporting is not comparable." }, "data": [ { "period": "2025-01", "value": 51963828.0, "countries_reporting": 37 }, { "period": "2025-02", "value": 55290486.0, "countries_reporting": 37 }, { "period": "2025-03", "value": 63097748.0, "countries_reporting": 36 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/countries/{iso}/peers": { "get": { "operationId": "countries_iso_peers", "summary": "The other countries in the same world region", "description": "Every other country in the same world region, with how far back and how fresh each is. A quick list to compare against. Plan: Free and up.", "tags": [ "Countries" ], "parameters": [ { "name": "iso", "in": "path", "required": true, "description": "ISO 3166 two-letter country code", "schema": { "type": "string", "example": "CL" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/countries-iso-peers" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_b3c11016b0", "data_as_of": "2026-10-20T04:47:58Z", "count": 40, "iso": "CL", "region": "Americas" }, "data": [ { "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" }, { "iso": "CW", "name": "Curaçao", "region": "Americas", "monthly": true, "first": "2016", "latest": "2026-09", "months_behind": 1, "measures": [ "arrivals", "nights", "spend" ], "iso3": "CUW", "wikidata_id": "Q25279" } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/countries/{iso}/brief": { "get": { "operationId": "countries_iso_brief", "summary": "Where a country stands, written and in figures", "description": "The country's latest month in a short written brief, checked against the figures, with the fact sheet behind it: the change on a year, against 2019 and year to date, the last six months, its rank in the region, its rivals, jet fuel, its currency, growth and the forecast for the next three months. Remade when a new month is published. Plan: Analyst and up.", "tags": [ "Countries" ], "parameters": [], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/countries-iso-brief" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_7f3a1c", "data_as_of": "2026-10-14T06:00:00Z", "count": 1, "next": null }, "data": [ { "country": "TH", "name": "Thailand", "month": "2026-08", "headline": "A stronger August, still short of 2019, with nearby rivals growing faster", "brief": [ "Thailand recorded 2,714,880 visitor arrivals in August 2026, +6.4% on a year and 93.1% of the August 2019 level." ], "figures": { "value": 2714880, "yoy_pct": 6.4, "vs_2019_pct": 93.1, "ytd_yoy_pct": 4.9, "region_rank": { "rank": 5, "of": 12 }, "trust": { "grade": "A", "score": 96 } }, "last_six": [ { "month": "2026-08", "value": 2714880, "yoy_pct": 6.4, "vs_2019_pct": 93.1, "vs_3yr_avg_pct": 12.8 } ], "outlook": [ { "month": "2026-09", "value": 2410000, "low": 2310000, "high": 2520000, "yoy_pct": 5.2 } ], "context": { "jet_fuel": { "month": "2026-08", "usd_gallon": 3.724, "yoy_pct": 17.8 }, "currency": { "currency": "THB", "per_eur": 37.12, "yoy_pct": -2.1 }, "growth": { "year": 2026, "pct": 2.8, "projected": true } }, "rivals": [ { "country": "VN", "name": "Vietnam", "score": 86, "shared_markets": [ "China", "Korea", "Taiwan" ], "month": "2026-08", "yoy_pct": 18.2 } ], "rival_for": [ "KH", "LA", "LK" ] } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/countries/{iso}/rivals": { "get": { "operationId": "countries_iso_rivals", "summary": "The destinations a country competes with", "description": "Up to six destinations competing for the same travellers, scored 0 to 100 from the source markets they share, how alike their seasons are, their size and region, with the shared markets named, and the countries that count this one as a rival. Remade every day. Plan: Developer and up.", "tags": [ "Countries" ], "parameters": [], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/countries-iso-rivals" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_7f3a1c", "data_as_of": "2026-10-14T06:00:00Z", "count": 1, "next": null }, "data": [ { "country": "VN", "name": "Vietnam", "rank": 1, "score": 86, "shared_markets": [ { "country": "CN", "name": "China" }, { "country": "KR", "name": "South Korea" } ], "basis": "shared source markets, season, size and region" } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/series": { "get": { "operationId": "series", "summary": "Find series by country, measure, frequency or text", "description": "Browse the 2.75 million series. Filter by country, measure and frequency; every result carries its id for the calls below. Plan: Developer and up.", "tags": [ "Series" ], "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } }, { "name": "measure", "in": "query", "required": true, "description": "arrivals, nights, spend, departures, occupancy or capacity", "schema": { "type": "string", "example": "arrivals" } }, { "name": "freq", "in": "query", "required": false, "description": "Frequency: monthly, quarterly or annual", "schema": { "type": "string", "example": "M" } }, { "name": "limit", "in": "query", "required": false, "description": "Rows per page, 1 to 1000", "schema": { "type": "integer", "example": "100" } }, { "name": "cursor", "in": "query", "required": false, "description": "The next value from the previous page", "schema": { "type": "string" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/series" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_0ba6034bd6", "data_as_of": "2026-10-20T04:47:58Z", "count": 3, "next_cursor": null, "page": 1, "per_page": 100, "total": 3, "total_pages": 1, "next_page": null, "prev_page": null }, "data": [ { "id": "sr_gnvbx5rt", "alias": "cl.arrivals.total.a", "country": "CL", "name": "CHL, _Z, ARRIVALS, PS, _T, _Z, TDS, A", "measure": "arrivals", "breakdown": null, "freq": "A", "unit": "PS", "first": "2008", "last": "2024", "points": 17, "headline": true }, { "id": "sr_f93x9ssn", "alias": null, "country": "CL", "name": "CHL, _Z, ARRIVALS, PS, SAME_DAY, _Z, TDS, A", "measure": "arrivals", "breakdown": null, "freq": "A", "unit": "PS", "first": "2008", "last": "2024", "points": 17, "headline": false }, { "id": "sr_swj304b6", "alias": null, "country": "CL", "name": "Tourist arrivals in Chile: hotels", "measure": "arrivals", "breakdown": "accommodation", "freq": "M", "unit": "arrivals", "first": "2026-06", "last": "2026-08", "points": 3, "headline": false } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/series/{id}": { "get": { "operationId": "series_id", "summary": "One series with its unit, frequency and office", "description": "The definition of one series: name, unit, frequency, first and latest period and the breakdown it belongs to. Plan: Developer and up.", "tags": [ "Series" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Series id from /v1/series", "schema": { "type": "string", "example": "jp.arrivals.total.m" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/series-id" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_890bd7da3e", "data_as_of": "2026-10-20T04:47:58Z", "count": 1 }, "data": { "id": "sr_wxq9yq5v", "alias": "jp.arrivals.total.m", "country": "JP", "name": "Visitor arrivals to Japan from Total", "measure": "arrivals", "breakdown": null, "freq": "M", "unit": "visitors", "first": "2003-01", "last": "2026-08", "points": 284, "headline": true } } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/series/{id}/observations": { "get": { "operationId": "series_id_observations", "summary": "Values for any period range, monthly to annual", "description": "The values of one series for any range. Missing months are listed as null with a reason, never silently dropped. Plan: Developer and up.", "tags": [ "Series" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Series id from /v1/series", "schema": { "type": "string", "example": "jp.arrivals.total.m" } }, { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } }, { "name": "to", "in": "query", "required": false, "description": "Last period to return", "schema": { "type": "string", "example": "2026-08" } }, { "name": "format", "in": "query", "required": false, "description": "Response format", "schema": { "type": "string", "example": "json" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/series-id-observations" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_db5940af9c", "data_as_of": "2026-10-20T04:47:58Z", "count": 20, "series": "sr_wxq9yq5v", "name": "Visitor arrivals to Japan from Total", "unit": "visitors", "freq": "M" }, "data": [ { "period": "2025-01", "value": 3781629.0 }, { "period": "2025-02", "value": 3258491.0 }, { "period": "2025-03", "value": 3497755.0 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/series/{id}/revisions": { "get": { "operationId": "series_id_revisions", "summary": "Every figure an office later changed, with both values", "description": "Each time a published figure was changed: the period, the old and new value and when we saw the change. Plan: Analyst and up.", "tags": [ "Series" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Series id from /v1/series", "schema": { "type": "string", "example": "jp.arrivals.total.m" } }, { "name": "since", "in": "query", "required": false, "description": "Only changes after this UTC time", "schema": { "type": "string", "example": "2026-10-01T00:00:00Z" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/series-id-revisions" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_7f3a1c", "data_as_of": "2026-10-12T12:01:11Z", "count": 1, "next": null }, "data": [ { "period": "2026-06", "old": 48211904, "new": 48390117, "seen_at": "2026-10-12T10:51:15Z" } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/series/{id}/metadata": { "get": { "operationId": "series_id_metadata", "summary": "Definitions, units and breaks in the series", "description": "What the series counts, how values are scaled and any breaks where the method changed. Plan: Developer and up.", "tags": [ "Series" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Series id from /v1/series", "schema": { "type": "string", "example": "jp.arrivals.total.m" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/series-id-metadata" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_89b193ab42", "data_as_of": "2026-10-20T04:47:58Z", "count": 1 }, "data": { "id": "sr_wxq9yq5v", "alias": "jp.arrivals.total.m", "country": "JP", "name": "Visitor arrivals to Japan from Total", "measure": "arrivals", "breakdown": null, "freq": "M", "unit": "visitors", "first": "2003-01", "last": "2026-08", "points": 284, "headline": true, "table": "Visitor arrivals to Japan by nationality", "derived": false, "latest_value": 3098900.0, "currency": null, "scale": null, "revisions": 0, "last_revised": null, "updated": "2026-10-13T02:37:15Z" } } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/series/search": { "get": { "operationId": "series_search", "summary": "Full-text search over two million series names", "description": "Free-text search across series names in every language held, ranked by match and freshness. Plan: Developer and up.", "tags": [ "Series" ], "parameters": [ { "name": "q", "in": "query", "required": true, "description": "Words to match in series names", "schema": { "type": "string", "example": "hotel nights foreign" } }, { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } }, { "name": "limit", "in": "query", "required": false, "description": "Rows per page, 1 to 1000", "schema": { "type": "integer", "example": "100" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/series-search" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_80ea08050d", "data_as_of": "2026-10-20T04:48:00Z", "count": 25, "q": "hotel nights foreign" }, "data": [ { "id": "sr_2efm01hs", "alias": null, "country": "NO", "name": "Hotels and similar establishments, Foreign national, total, Guest nights", "measure": "capacity", "breakdown": null, "freq": "M", "unit": "", "first": "2010-01", "last": "2019-12", "points": 120, "headline": false }, { "id": "sr_yj47ah45", "alias": null, "country": "NO", "name": "Hotels and similar establishments, Foreign national, total, Guest nights so far this year", "measure": "capacity", "breakdown": null, "freq": "M", "unit": "", "first": "2010-01", "last": "2019-12", "points": 120, "headline": false }, { "id": "sr_sn352fer", "alias": null, "country": "BE", "name": "Nights spent at accommodation: Foreign country, Hotels; holiday and other short-stay accommodation; camping grounds, recreational vehicle parks and trailer parks", "measure": "nights", "breakdown": "origin", "freq": "M", "unit": "Number", "first": "1990-01", "last": "2026-07", "points": 439, "headline": false } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/tables": { "get": { "operationId": "tables", "summary": "The office tables the series come from, by country", "description": "The published tables behind the series for a country, with how many series each holds. Plan: Developer and up.", "tags": [ "Series" ], "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } }, { "name": "limit", "in": "query", "required": false, "description": "Rows per page, 1 to 1000", "schema": { "type": "integer", "example": "100" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/tables" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_fc141bc7cb", "data_as_of": "2026-10-20T04:48:00Z", "count": 12, "country": "CL" }, "data": [ { "table": "Enterprises and employment in tourism", "series": 18, "first": "2008", "last": "2024", "measures": [] }, { "table": "Chile monthly tourist accommodation survey", "series": 15, "first": "2026-06", "last": "2026-08", "measures": [ "nights", "occupancy", "spend" ] }, { "table": "Outbound tourism", "series": 9, "first": "2008", "last": "2024", "measures": [ "departures" ] } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/series/{id}/latest": { "get": { "operationId": "series_id_latest", "summary": "The newest figure of a series, with a year before", "description": "The newest figure your plan can see for one series, the same period a year before, and the change in percent. Plan: Developer and up.", "tags": [ "Series" ], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Series id from /v1/series", "schema": { "type": "string", "example": "jp.arrivals.total.m" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/series-id-latest" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_d440128e7b", "data_as_of": "2026-10-20T04:48:00Z", "count": 1 }, "data": { "series": "sr_wxq9yq5v", "name": "Visitor arrivals to Japan from Total", "unit": "visitors", "period": "2026-08", "value": 3098900.0, "year_before": 3428406.0, "yoy_pct": -9.6 } } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/arrivals": { "get": { "operationId": "arrivals", "summary": "Visitor arrivals, any country, any frequency", "description": "Total visitor arrivals for one or more countries, in each country's own headline definition, monthly where the country publishes monthly. Plan: Developer and up.", "tags": [ "Measures" ], "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } }, { "name": "freq", "in": "query", "required": false, "description": "Frequency: monthly, quarterly or annual", "schema": { "type": "string", "example": "M" } }, { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } }, { "name": "to", "in": "query", "required": false, "description": "Last period to return", "schema": { "type": "string", "example": "2026-08" } }, { "name": "format", "in": "query", "required": false, "description": "Response format", "schema": { "type": "string", "example": "json" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/arrivals" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_6bf614b1dc", "data_as_of": "2026-10-20T04:48:00Z", "count": 3, "measure": "arrivals" }, "data": [ { "country": "CL", "series": "sr_gnvbx5rt", "name": "CHL, _Z, ARRIVALS, PS, _T, _Z, TDS, A", "unit": "PS", "freq": "A", "observations": [] }, { "country": "BA", "series": null, "observations": [], "note": "No arrivals series held for BA." }, { "country": "AT", "series": "sr_tn5yvzzv", "name": "Arrivals at accommodation: Total, Hotels; holiday and other short-stay accommodation; camping grounds, recreational vehicle parks and trailer parks", "unit": "Number", "freq": "M", "observations": [ { "period": "2026-05", "value": 3378684.0 }, { "period": "2026-06", "value": 4093346.0 }, { "period": "2026-07", "value": 5429162.0 } ] } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/nights": { "get": { "operationId": "nights", "summary": "Overnight stays in all accommodation", "description": "Nights spent in tourist accommodation, total and split by residents and non-residents where published. Plan: Developer and up.", "tags": [ "Measures" ], "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } }, { "name": "freq", "in": "query", "required": false, "description": "Frequency: monthly, quarterly or annual", "schema": { "type": "string", "example": "M" } }, { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } }, { "name": "to", "in": "query", "required": false, "description": "Last period to return", "schema": { "type": "string", "example": "2026-08" } }, { "name": "format", "in": "query", "required": false, "description": "Response format", "schema": { "type": "string", "example": "json" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/nights" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_9f83727052", "data_as_of": "2026-10-20T04:48:00Z", "count": 3, "measure": "nights" }, "data": [ { "country": "CL", "series": "sr_ay31rkhs", "name": "CHL, TRIPS, PS, OVERNIGHT, _T, TDS, A", "unit": "PS", "freq": "A", "observations": [] }, { "country": "BA", "series": "sr_226y4v9p", "name": "Tourist nights in Bosnia and Herzegovina: total", "unit": "nights", "freq": "M", "observations": [ { "period": "2026-06", "value": 388414.0 }, { "period": "2026-07", "value": 510876.0 }, { "period": "2026-08", "value": 560221.0 } ] }, { "country": "AT", "series": "sr_09pbgpx5", "name": "Nights, Carinthia , Netherlands <25>", "unit": "nights", "freq": "M", "observations": [ { "period": "2026-06", "value": 86625.0 }, { "period": "2026-07", "value": 304633.0 }, { "period": "2026-08", "value": 273538.0 } ] } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/spend": { "get": { "operationId": "spend", "summary": "Visitor spend in local currency or converted", "description": "What visitors spent, in local currency, or converted at each period's reference rate. Plan: Developer and up.", "tags": [ "Measures" ], "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } }, { "name": "freq", "in": "query", "required": false, "description": "Frequency: monthly, quarterly or annual", "schema": { "type": "string", "example": "M" } }, { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } }, { "name": "to", "in": "query", "required": false, "description": "Last period to return", "schema": { "type": "string", "example": "2026-08" } }, { "name": "currency", "in": "query", "required": false, "description": "Convert money to this ISO 4217 currency at each period's rate", "schema": { "type": "string", "example": "USD" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/spend" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_b34a6c9ee0", "data_as_of": "2026-10-20T04:48:00Z", "count": 3, "measure": "spend", "currency": "USD", "converted_at": "the average rate of each period" }, "data": [ { "country": "CL", "series": "sr_qn2jpsb5", "name": "Travel spending (debit), CHL, quarterly", "unit": "US dollars, x10^6", "freq": "Q", "observations": [ { "period": "2025-Q4", "value": 752348814.62 }, { "period": "2026-Q1", "value": 975684952.45 }, { "period": "2026-Q2", "value": 770375501.44 } ], "note": "This series is not in a currency we can convert; shown as published." }, { "country": "JP", "series": "sr_6xrp44rt", "name": "Travel receipts (credit), JPN, quarterly", "unit": "US dollars, x10^6", "freq": "Q", "observations": [ { "period": "2025-Q4", "value": 16806923240.334 }, { "period": "2026-Q1", "value": 15080441399.437 }, { "period": "2026-Q2", "value": 16225839715.666 } ], "note": "This series is not in a currency we can convert; shown as published." }, { "country": "IE", "series": "sr_918xs3ky", "name": "Mean Nightly Accommodation Costs of Overnight Foreign Visitors, USA & Canada", "unit": "USD", "freq": "M", "observations": [ { "period": "2026-06", "value": 131.31, "rate": 1.1518 }, { "period": "2026-07", "value": 129.02, "rate": 1.141748 }, { "period": "2026-08", "value": 125.21, "rate": 1.15931 } ] } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/departures": { "get": { "operationId": "departures", "summary": "Residents travelling abroad", "description": "Trips abroad by residents of a country: the outbound side of the same flows. Plan: Developer and up.", "tags": [ "Measures" ], "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } }, { "name": "freq", "in": "query", "required": false, "description": "Frequency: monthly, quarterly or annual", "schema": { "type": "string", "example": "M" } }, { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } }, { "name": "to", "in": "query", "required": false, "description": "Last period to return", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/departures" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_3ad052948b", "data_as_of": "2026-10-20T04:48:00Z", "count": 3, "measure": "departures" }, "data": [ { "country": "CL", "series": "sr_r3pa07sb", "name": "CHL, _Z, DEPARTURES, PS, _T, _Z, _Z, A", "unit": "PS", "freq": "A", "observations": [] }, { "country": "BA", "series": null, "observations": [], "note": "No departures series held for BA." }, { "country": "AT", "series": "sr_f8fd0f1e", "name": "Trips by duration, purpose and main destination: All countries of the world, Total, 1 night or over", "unit": "Number", "freq": "A", "observations": [ { "period": "2025", "value": 30456817.0 } ] } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/occupancy": { "get": { "operationId": "occupancy", "summary": "Bed and room occupancy rates", "description": "Bed and room occupancy as a percentage, with the rate per room where the country publishes it. Plan: Developer and up.", "tags": [ "Measures" ], "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } }, { "name": "freq", "in": "query", "required": false, "description": "Frequency: monthly, quarterly or annual", "schema": { "type": "string", "example": "M" } }, { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } }, { "name": "to", "in": "query", "required": false, "description": "Last period to return", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/occupancy" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_df49822e84", "data_as_of": "2026-10-20T04:48:00Z", "count": 3, "measure": "occupancy" }, "data": [ { "country": "CL", "series": null, "observations": [], "note": "No occupancy series held for CL." }, { "country": "BA", "series": null, "observations": [], "note": "No occupancy series held for BA." }, { "country": "AT", "series": "sr_jsdezbr0", "name": "Net occupancy of bed places and rooms: Bedrooms", "unit": "Percentage", "freq": "M", "observations": [ { "period": "2026-05", "value": 41.0 }, { "period": "2026-06", "value": 53.5 }, { "period": "2026-07", "value": 67.1 } ] } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/capacity": { "get": { "operationId": "capacity", "summary": "Establishments, rooms and beds available", "description": "Supply: open establishments, rooms and bed places by period. Plan: Developer and up.", "tags": [ "Measures" ], "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } }, { "name": "freq", "in": "query", "required": false, "description": "Frequency: monthly, quarterly or annual", "schema": { "type": "string", "example": "M" } }, { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } }, { "name": "to", "in": "query", "required": false, "description": "Last period to return", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/capacity" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_24786a4ab7", "data_as_of": "2026-10-20T04:48:00Z", "count": 3, "measure": "capacity" }, "data": [ { "country": "CL", "series": null, "observations": [], "note": "No capacity series held for CL." }, { "country": "BA", "series": null, "observations": [], "note": "No capacity series held for BA." }, { "country": "AT", "series": "sr_ckgy7wbt", "name": "Accommodation capacity: Bedplaces, Hotels; holiday and other short-stay accommodation; camping grounds, recreational vehicle parks and trailer parks", "unit": "Number", "freq": "A", "observations": [ { "period": "2025", "value": 1167138.0 } ] } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/arrivals/by-origin": { "get": { "operationId": "arrivals_by_origin", "summary": "Arrivals split by country of residence", "description": "Arrivals in one country broken down by where visitors live, ranked by size. Plan: Developer and up.", "tags": [ "Breakdowns" ], "parameters": [ { "name": "iso", "in": "query", "required": true, "description": "ISO 3166 two-letter country code", "schema": { "type": "string", "example": "CL" } }, { "name": "period", "in": "query", "required": false, "description": "One period; defaults to the latest finished one", "schema": { "type": "string", "example": "2026-08" } }, { "name": "limit", "in": "query", "required": false, "description": "Rows per page, 1 to 1000", "schema": { "type": "integer", "example": "100" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/arrivals-by-origin" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_d00a016153", "data_as_of": "2026-10-20T04:48:11Z", "count": 50, "country": "CA", "measure": "arrivals", "breakdown": "origin", "period": "2026-07", "freq": "M" }, "data": [ { "series": "sr_4zqx3d8x", "name": "Canada, Non-resident visitors entering Canada", "unit": "Visitors", "value": 4584611.0 }, { "series": "sr_khdrh7f3", "name": "Canada, United States of America residents entering Canada", "unit": "Visitors", "value": 3547732.0 }, { "series": "sr_2q7mr73c", "name": "Ontario, Non-resident visitors entering Canada", "unit": "Visitors", "value": 2022507.0 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/nights/by-accommodation": { "get": { "operationId": "nights_by_accommodation", "summary": "Nights by hotels, camping, rentals and more", "description": "Nights split by type of accommodation for one country and period. Plan: Developer and up.", "tags": [ "Breakdowns" ], "parameters": [ { "name": "iso", "in": "query", "required": true, "description": "ISO 3166 two-letter country code", "schema": { "type": "string", "example": "CL" } }, { "name": "period", "in": "query", "required": false, "description": "One period; defaults to the latest finished one", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/nights-by-accommodation" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_97fd15c176", "data_as_of": "2026-10-20T04:48:12Z", "count": 1, "country": "CL", "measure": "nights", "breakdown": "accommodation", "period": "2026-08", "freq": "M" }, "data": [ { "series": "sr_85g2v1ta", "name": "Tourist nights in Chile: hotels", "unit": "nights", "value": 1333264.0 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/nights/by-region": { "get": { "operationId": "nights_by_region", "summary": "Nights by province, county or region", "description": "Nights for each region inside a country, in the country's own regional units. Plan: Developer and up.", "tags": [ "Breakdowns" ], "parameters": [ { "name": "iso", "in": "query", "required": true, "description": "ISO 3166 two-letter country code", "schema": { "type": "string", "example": "CL" } }, { "name": "period", "in": "query", "required": false, "description": "One period; defaults to the latest finished one", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/nights-by-region" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_1566e78b1e", "data_as_of": "2026-10-20T04:48:14Z", "count": 50, "country": "SI", "measure": "nights", "breakdown": "region", "period": "2025", "freq": "A" }, "data": [ { "series": "sr_d1jex8kh", "name": "SLOVENIA", "unit": "", "value": 17843311.0 }, { "series": "sr_dtkwatyh", "name": "Nights spent, NUTS 2 regions: Total, Hotels; holiday and other short-stay accommodation; camping grounds, recreational vehicle parks and trailer parks, Slovenija", "unit": "Number", "value": 17827408.0 }, { "series": "sr_re4a2m9s", "name": "SLOVENIA, Foreign, Overnight stays", "unit": "", "value": 13358792.0 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/arrivals/by-purpose": { "get": { "operationId": "arrivals_by_purpose", "summary": "Leisure, business and visiting friends", "description": "Arrivals by purpose of trip where the country asks visitors why they came. Plan: Developer and up.", "tags": [ "Breakdowns" ], "parameters": [ { "name": "iso", "in": "query", "required": true, "description": "ISO 3166 two-letter country code", "schema": { "type": "string", "example": "CL" } }, { "name": "period", "in": "query", "required": false, "description": "One period; defaults to the latest finished one", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/arrivals-by-purpose" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_42ffdfc566", "data_as_of": "2026-10-20T04:48:15Z", "count": 50, "country": "NL", "measure": "arrivals", "breakdown": "purpose", "period": "2010", "freq": "A" }, "data": [ { "series": "sr_qv12q8ks", "name": "The Netherlands, All leisure accommodation, Netherlands (x1 000), year", "unit": "number", "value": 40540800.0 }, { "series": "sr_e6x7v623", "name": "The Netherlands, Holiday parks, Netherlands (x1 000), year", "unit": "number", "value": 21176900.0 }, { "series": "sr_x3qbr2e9", "name": "The Netherlands, Camp sites, Netherlands (x1 000), year", "unit": "number", "value": 16043700.0 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/origins/{iso}": { "get": { "operationId": "origins_iso", "summary": "Where one country's residents travel to", "description": "Reverses the by-origin tables: every destination that counts visitors from this country. Plan: Developer and up.", "tags": [ "Breakdowns" ], "parameters": [ { "name": "iso", "in": "path", "required": true, "description": "ISO 3166 two-letter country code", "schema": { "type": "string", "example": "CL" } }, { "name": "period", "in": "query", "required": false, "description": "One period; defaults to the latest finished one", "schema": { "type": "string", "example": "2026-08" } }, { "name": "limit", "in": "query", "required": false, "description": "Rows per page, 1 to 1000", "schema": { "type": "integer", "example": "100" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/origins-iso" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_5f00866b9c", "data_as_of": "2026-10-20T04:48:17Z", "count": 7, "origin": "CL", "note": "Each destination's own count and latest period; units differ (hotel guests, border arrivals or visitors), so read them side by side, not as one total." }, "data": [ { "destination": "CR", "name": "Costa Rica", "series": "sr_h1jk3ec9", "unit": "tourists", "freq": "M", "period": "2026-08", "value": 1420.0 }, { "destination": "CW", "name": "Curaçao", "series": "sr_vhv39yc1", "unit": "visitors", "freq": "M", "period": "2026-08", "value": 786.0 }, { "destination": "TH", "name": "Thailand", "series": "sr_gzg0tnrr", "unit": "tourists", "freq": "M", "period": "2026-08", "value": 755.0 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/compare": { "get": { "operationId": "compare", "summary": "Several countries side by side, same definitions", "description": "One measure for several countries on a shared period grid, with each country's definition noted. Plan: Developer and up.", "tags": [ "Compare and rank" ], "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } }, { "name": "measure", "in": "query", "required": true, "description": "arrivals, nights, spend, departures, occupancy or capacity", "schema": { "type": "string", "example": "arrivals" } }, { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } }, { "name": "to", "in": "query", "required": false, "description": "Last period to return", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/compare" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_332f112500", "data_as_of": "2026-10-20T04:48:17Z", "count": 19, "measure": "arrivals", "series": { "CL": null, "BA": null, "AT": "sr_tn5yvzzv" } }, "data": [ { "period": "2025-01", "CL": null, "BA": null, "AT": 3491284.0 }, { "period": "2025-02", "CL": null, "BA": null, "AT": 3524043.0 }, { "period": "2025-03", "CL": null, "BA": null, "AT": 3144123.0 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/rank": { "get": { "operationId": "rank", "summary": "Countries ranked on any measure and period", "description": "Every reporting country ranked on one measure for one period. Plan: Developer and up.", "tags": [ "Compare and rank" ], "parameters": [ { "name": "measure", "in": "query", "required": true, "description": "arrivals, nights, spend, departures, occupancy or capacity", "schema": { "type": "string", "example": "arrivals" } }, { "name": "period", "in": "query", "required": false, "description": "One period; defaults to the latest finished one", "schema": { "type": "string", "example": "2026-08" } }, { "name": "limit", "in": "query", "required": false, "description": "Rows per page, 1 to 1000", "schema": { "type": "integer", "example": "100" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/rank" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_9c3babe112", "data_as_of": "2026-10-20T04:48:17Z", "count": 40, "measure": "arrivals", "period": "2026-08", "note": "Each country's own headline series; units can differ (arrivals at hotels, at the border, or visitors)." }, "data": [ { "rank": 1, "country": "HU", "name": "Hungary", "series": "sr_8dhrzswd", "unit": "", "period": "2026-08", "value": 6916472.0, "year_before": 7340976.0, "yoy_pct": -5.8 }, { "rank": 2, "country": "HK", "name": "Hong Kong", "series": "sr_3e3rjawd", "unit": "persons", "period": "2026-08", "value": 5456645.0, "year_before": 5153244.0, "yoy_pct": 5.9 }, { "rank": 3, "country": "MX", "name": "Mexico", "series": "sr_dr2x8n1d", "unit": "visitors", "period": "2026-08", "value": 4216916.0, "year_before": 4094085.0, "yoy_pct": 3.0 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/growth": { "get": { "operationId": "growth", "summary": "Change on last year, month or quarter", "description": "Percentage change on the same period last year, the previous period, and year to date. Plan: Developer and up.", "tags": [ "Compare and rank" ], "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } }, { "name": "measure", "in": "query", "required": true, "description": "arrivals, nights, spend, departures, occupancy or capacity", "schema": { "type": "string", "example": "arrivals" } }, { "name": "period", "in": "query", "required": false, "description": "One period; defaults to the latest finished one", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/growth" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_e295df5140", "data_as_of": "2026-10-20T04:48:17Z", "count": 3, "measure": "arrivals" }, "data": [ { "country": "CL", "note": "No arrivals figure held for CL at that period." }, { "country": "JP", "series": "sr_wxq9yq5v", "unit": "visitors", "period": "2026-08", "value": 3098900.0, "year_before": 3428406.0, "yoy_pct": -9.6, "ytd": 27626262.0, "ytd_year_before": 28384099.0, "ytd_pct": -2.7 }, { "country": "TH", "series": "sr_mvtdw63b", "unit": "persons", "period": "2026-08", "value": 2515320.0, "year_before": 2583640.0, "yoy_pct": -2.6, "ytd": 20935150.0, "ytd_year_before": 21599460.0, "ytd_pct": -3.1 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/share": { "get": { "operationId": "share", "summary": "A destination's share of a group of markets", "description": "One destination's share of arrivals from a source market across a group of destinations. Plan: Developer and up.", "tags": [ "Compare and rank" ], "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } }, { "name": "origin", "in": "query", "required": false, "description": "Country of residence of the visitor", "schema": { "type": "string", "example": "DE" } }, { "name": "period", "in": "query", "required": false, "description": "One period; defaults to the latest finished one", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/share" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_7f3a1c", "data_as_of": "2026-10-12T12:01:11Z", "count": 1, "next": null }, "data": { "country": "AT", "origin": "DE", "period": "2026-08", "share_pct": 41.2, "group": "europe" } } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/seasonality": { "get": { "operationId": "seasonality", "summary": "Seasonal profile and peak months for a series", "description": "The average shape of a year for a series, peak and low months, and how strong the swing is. Plan: Developer and up.", "tags": [ "Compare and rank" ], "parameters": [ { "name": "id", "in": "query", "required": true, "description": "Series id from /v1/series", "schema": { "type": "string", "example": "jp.arrivals.total.m" } }, { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } }, { "name": "to", "in": "query", "required": false, "description": "Last period to return", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/seasonality" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_95d5ab4a86", "data_as_of": "2026-10-20T04:48:17Z", "count": 12, "series": "sr_wxq9yq5v", "years": [ "2025" ], "index": "each month as a percentage of its year's monthly average (median across years); 100 is an average month" }, "data": [ { "month": 1, "index": 106.3, "low": 106.3, "high": 106.3 }, { "month": 2, "index": 91.6, "low": 91.6, "high": 91.6 }, { "month": 3, "index": 98.3, "low": 98.3, "high": 98.3 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/movers": { "get": { "operationId": "movers", "summary": "The countries rising and falling fastest", "description": "Every country with a monthly headline, latest month against the same month a year before: the biggest risers and fallers on one measure. Plan: Developer and up.", "tags": [ "Compare and rank" ], "parameters": [ { "name": "measure", "in": "query", "required": true, "description": "arrivals, nights, spend, departures, occupancy or capacity", "schema": { "type": "string", "example": "arrivals" } }, { "name": "limit", "in": "query", "required": false, "description": "Rows per page, 1 to 1000", "schema": { "type": "integer", "example": "100" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/movers" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_efe0e5b6d9", "data_as_of": "2026-10-20T04:48:18Z", "count": 1, "measure": "arrivals", "compared": 109, "note": "Each country's own latest month against the same month a year before." }, "data": { "rising": [ { "country": "NC", "name": "New Caledonia", "series": "sr_ne8xpxnt", "unit": "tourists", "period": "2026-08", "value": 6786.0, "year_before": 5260.0, "yoy_pct": 29.0 }, { "country": "XK", "name": "Kosovo", "series": "sr_xqz9ffw9", "unit": "Number", "period": "2026-07", "value": 99053.0, "year_before": 77481.0, "yoy_pct": 27.8 }, { "country": "SI", "name": "Slovenia", "series": "sr_k8n6ecam", "unit": "", "period": "2026-08", "value": 101002.0, "year_before": 80614.0, "yoy_pct": 25.3 } ], "falling": [ { "country": "PE", "name": "Peru", "series": "sr_41hhx4bx", "unit": "tourists", "period": "2026-06", "value": 258156.0, "year_before": 278218.0, "yoy_pct": -7.2 }, { "country": "MS", "name": "Montserrat", "series": "sr_qzb4d6p3", "unit": "visitors", "period": "2026-06", "value": 441.0, "year_before": 475.0, "yoy_pct": -7.2 }, { "country": "GI", "name": "Gibraltar", "series": "sr_5jctjzp4", "unit": "passengers", "period": "2026-09", "value": 19241.0, "year_before": 20686.0, "yoy_pct": -7.0 } ] } } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/records": { "get": { "operationId": "records", "summary": "Each country's best month, and how close it is now", "description": "Each country's best month on record for one measure, its latest month, and the latest as a percent of the record. Plan: Developer and up.", "tags": [ "Compare and rank" ], "parameters": [ { "name": "measure", "in": "query", "required": true, "description": "arrivals, nights, spend, departures, occupancy or capacity", "schema": { "type": "string", "example": "arrivals" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/records" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "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.0, "latest_period": "2026-07", "latest_value": 2126258.0, "pct_of_record": 100.0, "latest_is_record": true }, { "country": "DE", "name": "Germany", "series": "sr_wjq538vh", "unit": "Number", "record_period": "2026-07", "record_value": 20797973.0, "latest_period": "2026-07", "latest_value": 20797973.0, "pct_of_record": 100.0, "latest_is_record": true }, { "country": "GH", "name": "Ghana", "series": "sr_emgc50w7", "unit": "visitors", "record_period": "2025-12", "record_value": 141186.0, "latest_period": "2025-12", "latest_value": 141186.0, "pct_of_record": 100.0, "latest_is_record": true } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/stats/trend": { "get": { "operationId": "stats_trend", "summary": "Seasonally adjusted figures and the trend", "description": "Each month with the seasonal swing taken out, plus the underlying trend, so one month can be read against the last without the calendar getting in the way. Classical multiplicative decomposition on a 2x12 centred average. 51 countries. Plan: Analyst and up.", "tags": [ "Statistics" ], "parameters": [ { "name": "country", "in": "query", "required": true, "description": "ISO code of a country that carries this statistic (listed at /v1/countries/{iso})", "schema": { "type": "string", "example": "JP" } }, { "name": "from", "in": "query", "required": false, "description": "First month to return", "schema": { "type": "string", "example": "2024-01" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/stats-trend" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_0377f162f0", "data_as_of": "2026-10-20T04:48:18Z", "count": 96, "country": "JP", "method": { "series": "Visitor arrivals to Japan from Total", "unit": "visitors", "first": "2003-01", "last": "2026-08", "seasonal_factors": { "03": 0.9303, "04": 1.0119, "05": 0.9185, "06": 0.8245, "07": 0.9821, "08": 0.885, "09": 0.8662, "10": 1.0731, "11": 1.0974, "12": 1.2396, "01": 1.3019, "02": 0.8696 }, "method": "multiplicative decomposition, 2x12 centred average" } }, "data": [ { "period": "2018-09", "adjusted": 2493188.1 }, { "period": "2018-10", "adjusted": 2460823.7 }, { "period": "2018-11", "adjusted": 2233298.6 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/stats/recovery": { "get": { "operationId": "stats_recovery", "summary": "Each month against the same month of 2019", "description": "Every month as a percentage of the same month in 2019 (= 100): the recovery index buyers quote. 53 countries. Plan: Analyst and up.", "tags": [ "Statistics" ], "parameters": [ { "name": "country", "in": "query", "required": true, "description": "ISO code of a country that carries this statistic (listed at /v1/countries/{iso})", "schema": { "type": "string", "example": "JP" } }, { "name": "from", "in": "query", "required": false, "description": "First month to return", "schema": { "type": "string", "example": "2024-01" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/stats-recovery" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_a4d58816ef", "data_as_of": "2026-10-20T04:48:18Z", "count": 80, "country": "JP", "method": { "series": "Visitor arrivals to Japan from Total", "unit": "visitors", "first": "2003-01", "last": "2026-08", "basis": "same month of 2019 = 100" } }, "data": [ { "period": "2020-01", "index": 98.95 }, { "period": "2020-02", "index": 41.67 }, { "period": "2020-03", "index": 7.02 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/stats/benchmark": { "get": { "operationId": "stats_benchmark", "summary": "A country against its region, on one index", "description": "A country's yearly total indexed to 2019 = 100, beside the average of the other countries in its region (or a peer list you choose). 45 countries. Plan: Analyst and up.", "tags": [ "Statistics" ], "parameters": [ { "name": "country", "in": "query", "required": true, "description": "ISO code of a country that carries this statistic (listed at /v1/countries/{iso})", "schema": { "type": "string", "example": "JP" } }, { "name": "peers", "in": "query", "required": false, "description": "The region (default) or your own comma-separated list of ISO codes", "schema": { "type": "string", "example": "region" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/stats-benchmark" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_c5f566d177", "data_as_of": "2026-10-20T04:48:18Z", "count": 11, "country": "JP", "method": { "region": "East Asia & Pacific", "peers": [ "AU", "KH", "KR", "LA", "NC", "NZ", "PH", "SG", "VN", "VU" ], "basis": "2019 = 100, whole years only" } }, "data": [ { "year": "2015", "country": 61.9, "region": 74.9 }, { "year": "2016", "country": 75.4, "region": 84.2 }, { "year": "2017", "country": 90.0, "region": 86.3 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/stats/stay-length": { "get": { "operationId": "stats_stay_length", "summary": "Nights per arrival and its trend", "description": "Average length of stay: nights divided by arrivals, month by month, wherever one table publishes both. Plan: Analyst and up.", "tags": [ "Statistics" ], "parameters": [ { "name": "country", "in": "query", "required": true, "description": "ISO code of a country that carries this statistic (listed at /v1/countries/{iso})", "schema": { "type": "string", "example": "JP" } }, { "name": "from", "in": "query", "required": false, "description": "First month to return", "schema": { "type": "string", "example": "2024-01" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/stats-stay-length" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_7f3a23", "data_as_of": "2026-10-12T21:57:29Z", "count": 2, "next": null }, "data": [ { "period": "2026-07", "nights_per_arrival": 2.18 }, { "period": "2026-08", "nights_per_arrival": 2.12 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/stats/forecast": { "get": { "operationId": "stats_forecast", "summary": "Up to 24 months ahead, with ranges", "description": "Holt-Winters seasonal smoothing on log values, fitted from each country's post-pandemic reopening, with 80% and 95% ranges. Every forecast carries the date it was made and its error on the last 12 published months. 47 countries. Plan: Intel and up.", "tags": [ "Statistics" ], "parameters": [ { "name": "country", "in": "query", "required": true, "description": "ISO code of a country that carries this statistic (listed at /v1/countries/{iso})", "schema": { "type": "string", "example": "JP" } }, { "name": "horizon", "in": "query", "required": false, "description": "Months ahead, 1 to 24", "schema": { "type": "integer", "example": "12" } }, { "name": "level", "in": "query", "required": false, "description": "Width of the range returned with each value", "schema": { "type": "string", "example": "80" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/stats-forecast" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_cc634468fe", "data_as_of": "2026-10-20T04:48:18Z", "count": 24, "country": "JP", "method": { "series": "Visitor arrivals to Japan from Total", "unit": "visitors", "first": "2003-01", "last": "2026-08", "made": "2026-10-20", "fitted_from": "2022-12", "horizon_months": 24, "backtest_mape_pct": 7.6, "method": "Holt-Winters on logs, damped slope 0.9, season started from 2017 to 2019" } }, "data": [ { "period": "2026-09", "value": 2799576.0, "low": 2581010.0, "high": 3036651.0 }, { "period": "2026-10", "value": 3194684.0, "low": 2847754.0, "high": 3583880.0 }, { "period": "2026-11", "value": 2975169.0, "low": 2584435.0, "high": 3424976.0 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/stats/nowcast": { "get": { "operationId": "stats_nowcast", "summary": "Months the office has not published yet", "description": "An estimate for each month between a country's last published figure and last month, from the seasonal pattern and the latest year-on-year change. Always estimated: true, and replaced the moment the office publishes. 45 countries. Plan: Intel and up.", "tags": [ "Statistics" ], "parameters": [ { "name": "country", "in": "query", "required": true, "description": "ISO code of a country that carries this statistic (listed at /v1/countries/{iso})", "schema": { "type": "string", "example": "JP" } }, { "name": "level", "in": "query", "required": false, "description": "Width of the range returned with each value", "schema": { "type": "string", "example": "80" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/stats-nowcast" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_28692f383c", "data_as_of": "2026-10-20T04:48:18Z", "count": 1, "country": "JP", "method": { "series": "Visitor arrivals to Japan from Total", "unit": "visitors", "first": "2003-01", "last": "2026-08", "published_to": "2026-08", "estimated_to": "2026-09", "yoy_used": 0.9458, "method": "same month last year times the average year-on-year change of the last 3 published months" } }, "data": [ { "period": "2026-09", "value": 3090230.0, "low": 2848972.0, "high": 3351918.0, "estimated": true } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/stats/anomalies": { "get": { "operationId": "stats_anomalies", "summary": "Months far from what was expected", "description": "Months where the figure sits well away from what trend and season predicted, scored in robust standard deviations, with the expected value beside it. 51 countries. Plan: Intel and up.", "tags": [ "Statistics" ], "parameters": [ { "name": "country", "in": "query", "required": true, "description": "ISO code of a country that carries this statistic (listed at /v1/countries/{iso})", "schema": { "type": "string", "example": "JP" } }, { "name": "min_score", "in": "query", "required": false, "description": "Smallest score to return, in standard deviations (default 3)", "schema": { "type": "string", "example": "3" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/stats-anomalies" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_8e45be3bae", "data_as_of": "2026-10-20T04:48:18Z", "count": 19, "country": "JP", "method": { "series": "Visitor arrivals to Japan from Total", "unit": "visitors", "first": "2003-01", "last": "2026-08", "months_checked": 84, "flagged": 19, "threshold_sd": 3, "range_fields": "lo80 holds the expected value" } }, "data": [ { "period": "2020-03", "score": -6.6, "expected": 974204.6 }, { "period": "2020-04", "score": -22.92, "expected": 860332.4 }, { "period": "2020-05", "score": -23.7, "expected": 595193.8 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/stats/origin-shift": { "get": { "operationId": "stats_origin_shift", "summary": "Which markets are gaining or losing share", "description": "Each origin market's share of arrivals over the latest 12 months against the 12 before, in percentage points, largest moves first. Plan: Intel and up.", "tags": [ "Statistics" ], "parameters": [ { "name": "country", "in": "query", "required": true, "description": "ISO code of a country that carries this statistic (listed at /v1/countries/{iso})", "schema": { "type": "string", "example": "JP" } }, { "name": "limit", "in": "query", "required": false, "description": "Rows per page, 1 to 1000", "schema": { "type": "integer", "example": "100" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/stats-origin-shift" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_bc1d107551", "data_as_of": "2026-10-20T04:48:18Z", "count": 37, "country": "JP", "method": { "window": "2025-09 to 2026-08", "against": "2024-09 to 2025-08", "value": "change in share, points", "lo80": "share now, percent" } }, "data": [ { "origin": "China", "share_pct": 13.05, "change_points": -9.58 }, { "origin": "South Korea", "share_pct": 26.53, "change_points": 3.83 }, { "origin": "Taiwan", "share_pct": 18.88, "change_points": 2.87 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/stats/concentration": { "get": { "operationId": "stats_concentration", "summary": "How dependent a destination is on its markets", "description": "A Herfindahl index of origin shares (0 to 10,000) and the share of the top three markets: one dependence score per destination. Plan: Intel and up.", "tags": [ "Statistics" ], "parameters": [ { "name": "country", "in": "query", "required": true, "description": "ISO code of a country that carries this statistic (listed at /v1/countries/{iso})", "schema": { "type": "string", "example": "JP" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/stats-concentration" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_9de815f403", "data_as_of": "2026-10-20T04:48:18Z", "count": 1, "country": "JP", "method": { "window": "2025-09 to 2026-08", "markets": 39, "top": { "South Korea": 26.5, "Taiwan": 18.9, "China": 13, "United States": 8.5, "Hong Kong": 6.6 }, "scale": "Herfindahl index 0 to 10000 on percentage shares" } }, "data": { "hhi": 1391, "top3_share_pct": 58.5, "window": "2025-09 to 2026-08", "markets": 39, "top": { "South Korea": 26.5, "Taiwan": 18.9, "China": 13, "United States": 8.5, "Hong Kong": 6.6 } } } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/stats/fx-sensitivity": { "get": { "operationId": "stats_fx_sensitivity", "summary": "How arrivals move with the exchange rate", "description": "Year-on-year change in arrivals from an origin set against the year-on-year change in that origin's currency, with the elasticity, R squared and months used. Coming next; listed so you can plan for it. Plan: Intel and up.", "tags": [ "Statistics" ], "parameters": [ { "name": "country", "in": "query", "required": true, "description": "ISO code of a country that carries this statistic (listed at /v1/countries/{iso})", "schema": { "type": "string", "example": "JP" } }, { "name": "origin", "in": "query", "required": true, "description": "Origin country whose currency is tested", "schema": { "type": "string", "example": "US" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/stats-fx-sensitivity" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_4a89eea669", "data_as_of": "2026-10-20T04:48:18Z", "count": 1, "country": "JP", "currency": "JPY", "method": "Year-on-year change in monthly arrivals from each market against the year-on-year change in what the destination currency costs in that market's currency (monthly average reference rates), in logs; 2020 to 2022 left out; at least 24 months." }, "data": [ { "origin": "US", "name": "United States", "currency": "USD", "series": "sr_p4b6agqg", "months": 226, "elasticity": -0.47, "correlation": -0.28, "reading": "A 10% dearer JPY for United States travellers goes with -4.7% arrivals, all else equal." } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/stats/tourism-intensity": { "get": { "operationId": "tourism_intensity", "summary": "Countries ranked by how much they rely on tourism", "description": "Countries ranked by arrivals and tourism receipts per resident for one year, 2019 by default, the last full year before travel stopped. Plan: Analyst and up.", "tags": [ "Statistics" ], "parameters": [ { "name": "year", "in": "query", "required": false, "description": "Calendar year", "schema": { "type": "integer", "example": "2026" } }, { "name": "limit", "in": "query", "required": false, "description": "Rows per page, 1 to 1000", "schema": { "type": "integer", "example": "100" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/tourism-intensity" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_2fb5bf7eee", "data_as_of": "2026-10-20T04:48:18Z", "count": 50, "ranked": 179, "year": 2019 }, "data": [ { "rank": 1, "country": "AD", "name": "Andorra", "year": 2019, "arrivals_per_resident": 107.684, "receipts_per_resident_usd": 24976.0, "arrivals": 8235000, "population": 76474 }, { "rank": 2, "country": "MO", "name": "Macao", "year": 2019, "arrivals_per_resident": 58.64, "receipts_per_resident_usd": 61259.0, "arrivals": 39406000, "population": 672000 }, { "rank": 3, "country": "SM", "name": "San Marino", "year": 2019, "arrivals_per_resident": 54.929, "receipts_per_resident_usd": null, "arrivals": 1904000, "population": 34663 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/holidays": { "get": { "operationId": "holidays", "summary": "Public holidays for every calendar held", "description": "Public holidays for 204 countries from 1999 to 2027, filterable by date range. Plan: Free and up.", "tags": [ "Context" ], "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } }, { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } }, { "name": "to", "in": "query", "required": false, "description": "Last period to return", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/holidays" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_4e5c39cb00", "data_as_of": "2026-10-20T04:48:18Z", "count": 85 }, "data": [ { "country": "AT", "date": "2025-01-01", "name": "New Year's Day", "local_name": "Neujahr", "national": true }, { "country": "BA", "date": "2025-01-01", "name": "New Year's Day", "local_name": "Nova Godina", "national": true }, { "country": "CL", "date": "2025-01-01", "name": "New Year's Day", "local_name": "Año Nuevo", "national": true } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/holidays/{iso}": { "get": { "operationId": "holidays_iso", "summary": "One country's holidays by year", "description": "All public holidays for one country and year, national and regional. Plan: Free and up.", "tags": [ "Context" ], "parameters": [ { "name": "iso", "in": "path", "required": true, "description": "ISO 3166 two-letter country code", "schema": { "type": "string", "example": "CL" } }, { "name": "year", "in": "query", "required": false, "description": "Calendar year", "schema": { "type": "integer", "example": "2026" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/holidays-iso" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_866432f6c4", "data_as_of": "2026-10-20T04:48:18Z", "count": 17 }, "data": [ { "country": "CL", "date": "2026-01-01", "name": "New Year's Day", "local_name": "Año Nuevo", "national": true }, { "country": "CL", "date": "2026-04-03", "name": "Good Friday", "local_name": "Viernes Santo", "national": true }, { "country": "CL", "date": "2026-04-04", "name": "Holy Saturday", "local_name": "Sábado Santo", "national": true } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/fx": { "get": { "operationId": "fx", "summary": "Daily reference exchange rates since 1999", "description": "Daily reference rates for 44 currencies from 1999, quoted per euro. Plan: Free and up.", "tags": [ "Context" ], "parameters": [ { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } }, { "name": "to", "in": "query", "required": false, "description": "Last period to return", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/fx" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_d840bfdf74", "data_as_of": "2026-10-20T04:48:19Z", "count": 145, "base": "EUR", "quoted": "units of the currency per 1 EUR" }, "data": [ { "quote": "AUD", "base": "EUR", "date": "2026-10-13", "rate": 1.6033 }, { "quote": "BRL", "base": "EUR", "date": "2026-10-13", "rate": 5.6125 }, { "quote": "CAD", "base": "EUR", "date": "2026-10-13", "rate": 1.5933 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/fx/{currency}": { "get": { "operationId": "fx_currency", "summary": "One currency's rate history", "description": "The daily history of one currency, with monthly and annual averages ready to join to tourism series. Plan: Free and up.", "tags": [ "Context" ], "parameters": [ { "name": "currency", "in": "path", "required": true, "description": "ISO 4217 currency code", "schema": { "type": "string", "example": "THB" } }, { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } }, { "name": "to", "in": "query", "required": false, "description": "Last period to return", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/fx-currency" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_23f59bcc31", "data_as_of": "2026-10-20T04:48:19Z", "count": 255, "base": "EUR", "quoted": "units of the currency per 1 EUR" }, "data": [ { "quote": "THB", "base": "EUR", "date": "2025-10-20", "rate": 38.106 }, { "quote": "THB", "base": "EUR", "date": "2025-10-21", "rate": 38.071 }, { "quote": "THB", "base": "EUR", "date": "2025-10-22", "rate": 38.107 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/convert": { "get": { "operationId": "convert", "summary": "Spend converted at each period's rate", "description": "Converts any money series at the average rate of each period, not one rate for all. Plan: Developer and up.", "tags": [ "Context" ], "parameters": [ { "name": "id", "in": "query", "required": true, "description": "Series id from /v1/series", "schema": { "type": "string", "example": "jp.arrivals.total.m" } }, { "name": "currency", "in": "query", "required": false, "description": "Convert money to this ISO 4217 currency at each period's rate", "schema": { "type": "string", "example": "USD" } }, { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } }, { "name": "to", "in": "query", "required": false, "description": "Last period to return", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/convert" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_9588524814", "data_as_of": "2026-10-20T04:48:19Z", "count": 20, "series": "sr_918xs3ky", "from": "EUR", "to": "USD", "scale": 1, "rate": "average rate of the period" }, "data": [ { "period": "2025-01", "value": 102.5, "rate": 1.035373 }, { "period": "2025-02", "value": 93.71, "rate": 1.04125 }, { "period": "2025-03", "value": 106.99, "rate": 1.080681 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/joins/holidays": { "get": { "operationId": "joins_holidays", "summary": "Any series with holiday counts per period", "description": "A series with the number of public holidays and weekend days in each period beside it. Plan: Developer and up.", "tags": [ "Context" ], "parameters": [ { "name": "id", "in": "query", "required": true, "description": "Series id from /v1/series", "schema": { "type": "string", "example": "jp.arrivals.total.m" } }, { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } }, { "name": "to", "in": "query", "required": false, "description": "Last period to return", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/joins-holidays" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_8192c35bc9", "data_as_of": "2026-10-20T04:48:19Z", "count": 20, "series": "sr_wxq9yq5v", "country": "JP" }, "data": [ { "period": "2025-01", "value": 3781629.0, "holidays": 2, "holiday_list": [ { "date": "2025-01-01", "name": "New Year's Day" }, { "date": "2025-01-13", "name": "Coming of Age Day" } ] }, { "period": "2025-02", "value": 3258491.0, "holidays": 3, "holiday_list": [ { "date": "2025-02-11", "name": "Foundation Day" }, { "date": "2025-02-23", "name": "Emperor's Birthday" }, { "date": "2025-02-24", "name": "Substitute Holiday" } ] }, { "period": "2025-03", "value": 3497755.0, "holidays": 1, "holiday_list": [ { "date": "2025-03-20", "name": "Vernal Equinox Day" } ] } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/holidays/upcoming": { "get": { "operationId": "holidays_upcoming", "summary": "Public holidays in the coming days", "description": "Public holidays from today for the next 30 days (or any number up to a year), with how many days away each is. Plan: Free and up.", "tags": [ "Context" ], "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } }, { "name": "days", "in": "query", "required": false, "description": "How many days ahead, 1 to 365 (30 when left out)", "schema": { "type": "integer", "example": "30" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/holidays-upcoming" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_86acc455b5", "data_as_of": "2026-10-20T04:48:19Z", "count": 2, "from": "2026-10-20", "days": 30 }, "data": [ { "country": "CL", "date": "2026-10-31", "name": "Reformation Day", "local_name": "Día Nacional de las Iglesias Evangélicas y Protestantes", "national": true, "in_days": 11 }, { "country": "CL", "date": "2026-11-01", "name": "All Saints Day", "local_name": "Día de Todos los Santos", "national": true, "in_days": 12 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/fx/latest": { "get": { "operationId": "fx_latest", "summary": "The newest exchange rate for every currency", "description": "The newest daily reference rate for every currency held, one row each, or for the currencies you name. Plan: Free and up.", "tags": [ "Context" ], "parameters": [ { "name": "currency", "in": "query", "required": false, "description": "Convert money to this ISO 4217 currency at each period's rate", "schema": { "type": "string", "example": "USD" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/fx-latest" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_c58d5f3cd7", "data_as_of": "2026-10-20T04:48:19Z", "count": 1, "base": "EUR", "date": "2026-10-19", "quoted": "units of the currency per 1 EUR" }, "data": [ { "quote": "USD", "rate": 1.1225 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/fuel": { "get": { "operationId": "fuel", "summary": "Jet fuel and crude oil, month by month", "description": "One world price each, by month from 1990: jet fuel a gallon and a litre, crude oil a barrel, each against its 2019 average (2019 = 100, the Monitor's base) and on a year. Fuel trades on world markets, so one price holds for flights everywhere. Without from, it starts in 2015. Plan: Analyst and up.", "tags": [ "Context" ], "parameters": [ { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } }, { "name": "to", "in": "query", "required": false, "description": "Last period to return", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/fuel" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_91df0ef0a9", "data_as_of": "2026-10-20T04:48:19Z", "count": 20, "units": { "jet_fuel": "US dollars a gallon and a litre, monthly average of the spot price", "crude": "US dollars a barrel, monthly average of the spot price" }, "index_base": "average of 2019 = 100, the same base as the Monitor", "note": "One world price each: jet fuel and crude trade on world markets, so the price moves together everywhere." }, "data": [ { "month": "2025-01", "jet_fuel_usd_gallon": 2.347, "jet_fuel_usd_litre": 0.62, "jet_fuel_index": 125.0, "jet_fuel_yoy_pct": -9.2, "crude_usd_barrel": 79.27, "crude_index": 123.2, "crude_yoy_pct": -1.1 }, { "month": "2025-02", "jet_fuel_usd_gallon": 2.264, "jet_fuel_usd_litre": 0.598, "jet_fuel_index": 120.6, "jet_fuel_yoy_pct": -15.6, "crude_usd_barrel": 75.44, "crude_index": 117.2, "crude_yoy_pct": -9.6 }, { "month": "2025-03", "jet_fuel_usd_gallon": 2.069, "jet_fuel_usd_litre": 0.547, "jet_fuel_index": 110.2, "jet_fuel_yoy_pct": -20.2, "crude_usd_barrel": 72.73, "crude_index": 113.0, "crude_yoy_pct": -14.8 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/fuel/latest": { "get": { "operationId": "fuel_latest", "summary": "The newest month of fuel prices", "description": "The latest month of jet fuel and crude oil prices, with the index against 2019 and the change on a year. Free on every key; the history is /v1/fuel. Plan: Free and up.", "tags": [ "Context" ], "parameters": [], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/fuel-latest" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_1a5ec66f17", "data_as_of": "2026-10-20T04:48:19Z", "count": 1, "history": "/v1/fuel, from the Analyst plan" }, "data": [ { "month": "2026-09", "jet_fuel_usd_gallon": 4.388, "jet_fuel_usd_litre": 1.159, "jet_fuel_index": 233.7, "jet_fuel_yoy_pct": 110.1, "crude_usd_barrel": 114.16, "crude_index": 177.4, "crude_yoy_pct": 67.9 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/economy/{iso}": { "get": { "operationId": "economy", "summary": "A country's economy by year", "description": "Growth, inflation, size, income per head, population, unemployment and the current account by year, with the years ahead flagged as projections. Plan: Analyst and up.", "tags": [ "Context" ], "parameters": [ { "name": "iso", "in": "path", "required": true, "description": "ISO 3166 two-letter country code", "schema": { "type": "string", "example": "CL" } }, { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/economy" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_3a57d6be33", "data_as_of": "2026-10-20T04:48:19Z", "count": 7, "country": "CL", "name": "Chile", "note": "Years from 2026 on are projections and are revised as new figures arrive." }, "data": [ { "year": 2031, "projection": true, "gdp_growth_pct": 2.3, "inflation_pct": 3.0, "gdp_usd_bn": 486.5, "gdp_per_capita_usd": 23676.0, "population_m": 20.55, "unemployment_pct": 7.8, "current_account_pct_gdp": -1.5 }, { "year": 2030, "projection": true, "gdp_growth_pct": 2.3, "inflation_pct": 3.0, "gdp_usd_bn": 466.6, "gdp_per_capita_usd": 22772.0, "population_m": 20.49, "unemployment_pct": 8.0, "current_account_pct_gdp": -1.5 }, { "year": 2029, "projection": true, "gdp_growth_pct": 2.3, "inflation_pct": 3.0, "gdp_usd_bn": 447.3, "gdp_per_capita_usd": 21905.0, "population_m": 20.42, "unemployment_pct": 8.5, "current_account_pct_gdp": -1.4 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/economy/{iso}/tourism": { "get": { "operationId": "economy_tourism", "summary": "Tourism's weight in a country's economy", "description": "Tourism receipts and spending abroad (balance-of-payments travel, annual and the last eight quarters) beside the size of the economy, with arrivals added up from the country's own monthly count and receipts per arrival. Plan: Analyst and up.", "tags": [ "Context" ], "parameters": [ { "name": "iso", "in": "path", "required": true, "description": "ISO 3166 two-letter country code", "schema": { "type": "string", "example": "CL" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/economy-tourism" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_bb78ee64ca", "data_as_of": "2026-10-20T04:48:19Z", "count": 51, "country": "CL", "name": "Chile", "latest_year": 2025, "quarters": [ { "quarter": "2026-Q2", "receipts_usd": 627221750.0, "receipts_change_pct": -11.5, "spending_abroad_usd": 770375501.0, "spending_change_pct": 1.9 }, { "quarter": "2026-Q1", "receipts_usd": 1140866893.0, "receipts_change_pct": -14.6, "spending_abroad_usd": 975684952.0, "spending_change_pct": 9.2 }, { "quarter": "2025-Q4", "receipts_usd": 967368721.0, "receipts_change_pct": 1.5, "spending_abroad_usd": 752348815.0, "spending_change_pct": -10.6 }, { "quarter": "2025-Q3", "receipts_usd": 831608091.0, "receipts_change_pct": 11.3, "spending_abroad_usd": 751399734.0, "spending_change_pct": -6.2 }, { "quarter": "2025-Q2", "receipts_usd": 708624154.0, "receipts_change_pct": 18.0, "spending_abroad_usd": 755718520.0, "spending_change_pct": -2.2 }, { "quarter": "2025-Q1", "receipts_usd": 1336515869.0, "receipts_change_pct": 48.4, "spending_abroad_usd": 893186751.0, "spending_change_pct": -9.2 }, { "quarter": "2024-Q4", "receipts_usd": 953337591.0, "receipts_change_pct": 29.7, "spending_abroad_usd": 841584415.0, "spending_change_pct": 9.5 }, { "quarter": "2024-Q3", "receipts_usd": 747046971.0, "receipts_change_pct": 45.3, "spending_abroad_usd": 800656044.0, "spending_change_pct": 1.5 } ], "note": "Receipts and spending abroad are the balance-of-payments travel credit and debit; arrivals are the country's own monthly count added up over each whole year (all twelve months held). The last eight quarters of receipts and spending are in meta.quarters; monthly arrivals are at /v1/arrivals." }, "data": [ { "year": 2025, "receipts_usd": 3844116835.0, "spending_abroad_usd": 3152653820.0, "arrivals": null, "receipts_per_arrival_usd": null, "receipts_share_gdp_pct": 1.08 }, { "year": 2024, "receipts_usd": 3201545203.0, "spending_abroad_usd": 3398653204.0, "arrivals": null, "receipts_per_arrival_usd": null, "receipts_share_gdp_pct": 0.97 }, { "year": 2023, "receipts_usd": 2422229727.0, "spending_abroad_usd": 3086357723.0, "arrivals": null, "receipts_per_arrival_usd": null, "receipts_share_gdp_pct": 0.72 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/economy/outlook": { "get": { "operationId": "economy_outlook", "summary": "Growth and inflation outlook for the next three years", "description": "Projected growth and inflation for every country, or the ones you name, from a starting year. Plan: Analyst and up.", "tags": [ "Context" ], "parameters": [ { "name": "year", "in": "query", "required": false, "description": "Calendar year", "schema": { "type": "integer", "example": "2026" } }, { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/economy-outlook" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_5b6ab1cda8", "data_as_of": "2026-10-20T04:48:19Z", "count": 1, "years": [ 2026, 2027, 2028 ], "note": "Projections, revised as new figures arrive." }, "data": [ { "country": "CL", "name": "Chile", "gdp_growth_2026": 0.6, "inflation_2026": 3.7, "gdp_growth_2027": 2.6, "inflation_2027": 3.5, "gdp_growth_2028": 2.4, "inflation_2028": 3.0 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/releases": { "get": { "operationId": "releases", "summary": "Figures added or revised, newest first", "description": "Every load of new or revised figures, newest first, with counts by country. Plan: Developer and up.", "tags": [ "Releases" ], "parameters": [ { "name": "since", "in": "query", "required": false, "description": "Only changes after this UTC time", "schema": { "type": "string", "example": "2026-10-01T00:00:00Z" } }, { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } }, { "name": "limit", "in": "query", "required": false, "description": "Rows per page, 1 to 1000", "schema": { "type": "integer", "example": "100" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/releases" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_3c1dfc36b1", "data_as_of": "2026-10-20T04:48:20Z", "count": 11, "since": "2026-09-20" }, "data": [ { "date": "2026-10-18", "country": "AT", "series_updated": 1968, "latest_period": "2026-Q1", "measures": [ "departures", "nights", "spend" ] }, { "date": "2026-10-18", "country": "CL", "series_updated": 53, "latest_period": "2026-Q2", "measures": [ "nights", "occupancy", "spend" ] }, { "date": "2026-10-18", "country": "BA", "series_updated": 24, "latest_period": "2026-Q1", "measures": [ "spend" ] } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/releases/latest": { "get": { "operationId": "releases_latest", "summary": "The last release for each country", "description": "For each country, when figures last arrived and which period they took it to. Plan: Developer and up.", "tags": [ "Releases" ], "parameters": [], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/releases-latest" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_9a9e0aa49b", "data_as_of": "2026-10-20T04:48:24Z", "count": 100, "since": "2026-10-13" }, "data": [ { "date": "2026-10-19", "country": "HU", "series_updated": 434, "latest_period": "2026-08", "measures": [ "capacity", "spend", "arrivals" ] }, { "date": "2026-10-19", "country": "JM", "series_updated": 169, "latest_period": "2025-12", "measures": [ "arrivals" ] }, { "date": "2026-10-19", "country": "SX", "series_updated": 6, "latest_period": "2025-12", "measures": [ "arrivals" ] } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/freshness": { "get": { "operationId": "freshness", "summary": "How many months behind each country is", "description": "Months between today and each country's newest finished period, worst first. Plan: Free and up.", "tags": [ "Releases" ], "parameters": [ { "name": "freq", "in": "query", "required": false, "description": "Frequency: monthly, quarterly or annual", "schema": { "type": "string", "example": "M" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/freshness" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_9218e3d9ce", "data_as_of": "2026-10-20T04:48:24Z", "count": 125 }, "data": [ { "iso": "KI", "name": "Kiribati", "latest": "2018-12", "months_behind": 94 }, { "iso": "KZ", "name": "Kazakhstan", "latest": "2022-10", "months_behind": 48 }, { "iso": "GM", "name": "Gambia", "latest": "2022-12", "months_behind": 46 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/gaps": { "get": { "operationId": "gaps", "summary": "Which months each country is missing", "description": "Every monthly country from its first figure to last month: the months held, missing, not published by the source and withheld, with the missing runs. Nothing before a country's first figure counts as missing. Free. Plan: Free and up.", "tags": [ "Releases" ], "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/gaps" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_4c9d20", "data_as_of": "2026-10-14T12:00:00Z", "count": 1, "next": null }, "data": [ { "country": "VN", "name": "Vietnam", "measure": "arrivals", "series": "sr_k2v8x0q1", "first": "2008-01", "latest": "2026-09", "months_held": 220, "months_missing": 0, "months_not_published": 0, "months_withheld": 0, "months_pending": 0, "complete_pct": 100.0, "missing": [], "not_published": [], "withheld": [], "checked_at": "2026-10-14T12:00:00Z" } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/calendar": { "get": { "operationId": "calendar", "summary": "When each office is next expected to publish", "description": "Expected next release for each country, from the pattern of its past releases. Plan: Developer and up.", "tags": [ "Releases" ], "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/calendar" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_900c62c454", "data_as_of": "2026-10-20T04:48:24Z", "count": 3, "note": "Expected months are worked out from each office's usual delay; offices set their own dates." }, "data": [ { "country": "AT", "name": "Austria", "latest": "2026-08", "next_period": "2026-09", "expected_in": "2026-11", "usual_delay_months": 2, "overdue": false }, { "country": "BA", "name": "Bosnia and Herzegovina", "latest": "2026-08", "next_period": "2026-09", "expected_in": "2026-11", "usual_delay_months": 2, "overdue": false }, { "country": "CL", "name": "Chile", "latest": "2026-08", "next_period": "2026-09", "expected_in": "2026-11", "usual_delay_months": 2, "overdue": false } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/changelog": { "get": { "operationId": "changelog", "summary": "Changes to the API and its coverage", "description": "Additions, changes and retirements, dated, so integrations never break unannounced. Plan: Free and up.", "tags": [ "Releases" ], "parameters": [ { "name": "since", "in": "query", "required": false, "description": "Only changes after this UTC time", "schema": { "type": "string", "example": "2026-10-01T00:00:00Z" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/changelog" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_e206208610", "data_as_of": "2026-10-20T04:48:24Z", "count": 8 }, "data": [ { "date": "2026-10-14", "change": "Data gaps for every country, month by month, free: /v1/gaps" }, { "date": "2026-10-14", "change": "Country briefs and rivals: /v1/countries/{iso}/brief and /v1/countries/{iso}/rivals" }, { "date": "2026-10-14", "change": "Jet fuel and crude oil by month from 1990, with an index against 2019: /v1/fuel and /v1/fuel/latest" } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/monitor": { "get": { "operationId": "monitor", "summary": "The monthly report on world tourism, as data", "description": "One edition of the World Tourism Monitor: headline figures, regions, movers, records, trust grades, coming holidays and exchange rates. The world or one region, any month from 2015. Each edition is kept as first published as well as revised: vintage=first returns the first, and meta says whether it has been revised since. Plan: Free and up.", "tags": [ "Releases" ], "parameters": [ { "name": "month", "in": "query", "required": false, "description": "A month, YYYY-MM (the latest when left out)", "schema": { "type": "string", "example": "2026-09" } }, { "name": "edition", "in": "query", "required": false, "description": "world (the default), asia-pacific, europe, americas, africa or middle-east", "schema": { "type": "string", "example": "world" } }, { "name": "vintage", "in": "query", "required": false, "description": "latest (the default): the edition as rebuilt with countries' later revisions; first: the edition exactly as first published", "schema": { "type": "string", "example": "first" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/monitor" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_2996221a5c", "data_as_of": "2026-10-20T04:48:24Z", "count": 1, "edition": "world", "month": "2026-07", "vintage": "latest", "first_published_at": "2026-10-13T21:08:06Z", "revised_since": true }, "data": { "month": "2026-07", "edition": "world", "title": "World", "built_at": "2026-10-19T15:42:30Z", "headline": { "countries": 71, "growing": 52, "compared": 71, "yoy_pct": 4, "vs_2019_pct": 104.5, "records": 13, "trust": 99 }, "regions": [ { "region": "americas", "name": "Americas", "countries": 10, "yoy_pct": 4.1, "vs_2019_pct": 101.1 }, { "region": "africa", "name": "Africa", "countries": 4, "yoy_pct": 7.5, "vs_2019_pct": 115.9 }, { "region": "middle-east", "name": "Middle East", "countries": 2, "yoy_pct": 23.2, "vs_2019_pct": 70.4 } ], "rising": [ { "country": "XK", "name": "Kosovo", "region": "europe", "measure": "arrivals", "unit": "Number", "series": "sr_zqr55sk9", "basis": "stays", "value": 66955, "year_before": 50825, "yoy_pct": 31.7, "vs_2019_pct": null, "series_break": true, "pct_of_record": 100, "record": true }, { "country": "IL", "name": "Israel", "region": "middle-east", "measure": "arrivals", "unit": "number", "series": "sr_4jryaj4q", "basis": "border", "value": 109300, "year_before": 85000, "yoy_pct": 28.6, "vs_2019_pct": 33.9, "series_break": false, "pct_of_record": 22.5, "record": false }, { "country": "SK", "name": "Slovakia", "region": "europe", "measure": "arrivals", "unit": "Number", "series": "sr_m4e713de", "basis": "stays", "value": 315126, "year_before": 256276, "yoy_pct": 23, "vs_2019_pct": 110, "series_break": false, "pct_of_record": 100, "record": true } ], "falling": [ { "country": "AU", "name": "Australia", "region": "asia-pacific", "measure": "arrivals", "unit": "NUM", "series": "sr_bgakrnej", "basis": "border", "value": 710980, "year_before": 743210, "yoy_pct": -4.3, "vs_2019_pct": 90, "series_break": false, "pct_of_record": 66, "record": false }, { "country": "CY", "name": "Cyprus", "region": "europe", "measure": "arrivals", "unit": "Number", "series": "sr_890crw2r", "basis": "stays", "value": 413874, "year_before": 430908, "yoy_pct": -4, "vs_2019_pct": 112.8, "series_break": false, "pct_of_record": 93.5, "record": false }, { "country": "SG", "name": "Singapore", "region": "asia-pacific", "measure": "arrivals", "unit": "Number", "series": "sr_x860p4b7", "basis": "border", "value": 1515955, "year_before": 1571981, "yoy_pct": -3.6, "vs_2019_pct": 87.9, "series_break": false, "pct_of_record": 86.5, "record": false } ], "records": [ { "country": "RS", "name": "Serbia", "region": "europe", "measure": "arrivals", "unit": "Number", "series": "sr_7w10s48w", "basis": "stays", "value": 283890, "year_before": 273713, "yoy_pct": 3.7, "vs_2019_pct": 131.6, "series_break": false, "pct_of_record": 100, "record": true }, { "country": "SE", "name": "Sweden", "region": "europe", "measure": "arrivals", "unit": "Number", "series": "sr_3p3g5pxe", "basis": "stays", "value": 1920099, "year_before": 1725525, "yoy_pct": 11.3, "vs_2019_pct": 119.7, "series_break": false, "pct_of_record": 100, "record": true }, { "country": "SK", "name": "Slovakia", "region": "europe", "measure": "arrivals", "unit": "Number", "series": "sr_m4e713de", "basis": "stays", "value": 315126, "year_before": 256276, "yoy_pct": 23, "vs_2019_pct": 110, "series_break": false, "pct_of_record": 100, "record": true } ], "near_record": [ { "country": "DE", "name": "Germany", "region": "europe", "measure": "arrivals", "unit": "Number", "series": "sr_1pwb6msd", "basis": "stays", "value": 4847525, "year_before": 4666150, "yoy_pct": 3.9, "vs_2019_pct": 100.3, "series_break": false, "pct_of_record": 100, "record": true }, { "country": "LI", "name": "Liechtenstein", "region": "europe", "measure": "arrivals", "unit": "Number", "series": "sr_dsta93xs", "basis": "stays", "value": 22514, "year_before": 15838, "yoy_pct": 42.2, "vs_2019_pct": 171.9, "series_break": false, "pct_of_record": 100, "record": true }, { "country": "LU", "name": "Luxembourg", "region": "europe", "measure": "arrivals", "unit": "Number", "series": "sr_r4tdem87", "basis": "stays", "value": 204693, "year_before": 183375, "yoy_pct": 11.6, "vs_2019_pct": 164.7, "series_break": false, "pct_of_record": 100, "record": true } ], "holidays_next_month": [ { "name": "Day of the Republic", "date": "2026-08-02", "countries": [ "MK" ] }, { "name": "Agrarian Reform Day", "date": "2026-08-02", "countries": [ "BO" ] }, { "name": "Commerce Day", "date": "2026-08-03", "countries": [ "IS" ] } ], "fx": [ { "currency": "AUD", "per_eur": 1.6396, "change_pct": 0 }, { "currency": "THB", "per_eur": 38.2595, "change_pct": -1 }, { "currency": "INR", "per_eur": 109.4158, "change_pct": -0.1 } ], "countries": [ { "country": "TN", "name": "Tunisia", "region": "africa", "measure": "arrivals", "unit": "visitors", "series": "sr_pxc56ykb", "basis": "border", "value": 1113200, "year_before": 1065600, "yoy_pct": 4.5, "vs_2019_pct": null, "series_break": false, "pct_of_record": 90.2, "record": false, "trust": { "fresh": 100, "complete": 96, "stable": 100, "official": 100, "score": 99, "grade": "A" } }, { "country": "US", "name": "United States", "region": "americas", "measure": "arrivals", "unit": "arrivals", "series": "sr_4fr14e35", "basis": "border", "value": 6248242, "year_before": 6252054, "yoy_pct": -0.1, "vs_2019_pct": 81.1, "series_break": false, "pct_of_record": 76.5, "record": false, "trust": { "fresh": 100, "complete": 85, "stable": 100, "official": 100, "score": 96, "grade": "A" } }, { "country": "VN", "name": "Vietnam", "region": "asia-pacific", "measure": "arrivals", "unit": "visitors", "series": "sr_6e2r1wmy", "basis": "border", "value": 1665846, "year_before": 1562588, "yoy_pct": 6.6, "vs_2019_pct": 126.6, "series_break": false, "pct_of_record": 67.9, "record": false, "trust": { "fresh": 100, "complete": 98, "stable": 100, "official": 100, "score": 99, "grade": "A" } } ], "method": "Each country's monthly headline (arrivals, or nights where arrivals are not counted). Changes are combined as a geometric mean, each country weighted by the square root of its size in 2019, so the large destinations count for more and none decides it alone. Trust is the data as held today: freshness, completeness over five years, revisions and official status, 0 to 100.", "status": "complete", "lede": "Seventy-one countries reported July figures, of which 52 registered growth. International arrivals rose 4.0% on a year, lifting the global level to 104.5% of the same month in 2019. Europe led the larger regions with a 4.2% gain, while the Middle East posted the steepest rise at 23.2%. Africa reached 115.9% of its 2019 benchmark, the highest of any region.", "highlights": [ { "tag": "Movers", "text": "Bhutan led the risers with arrivals up 101.2% on a year." }, { "tag": "Records", "text": "Eight countries, including Germany and South Korea, set a record July." }, { "tag": "Currencies", "text": "The Korean won rose 3.5% against the euro, the strongest move in the basket." } ], "page": "https://tourismapi.com/monitor/2026-07", "pdf": "https://tourismapi.com/monitor/2026-07.pdf", "cite": "Tourism API, World Tourism Monitor: World, July 2026. https://tourismapi.com/monitor/2026-07" } } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/monitor/editions": { "get": { "operationId": "monitor_editions", "summary": "Every edition of the Monitor held", "description": "Every month and edition of the World Tourism Monitor held, with how many countries each covers. Plan: Free and up.", "tags": [ "Releases" ], "parameters": [], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/monitor-editions" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_62702115ee", "data_as_of": "2026-10-20T04:48:26Z", "count": 829 }, "data": [ { "month": "2026-08", "edition": "africa", "countries": 3, "status": "complete", "built_at": "2026-10-19T15:42:30Z" }, { "month": "2026-08", "edition": "americas", "countries": 7, "status": "complete", "built_at": "2026-10-19T15:42:30Z" }, { "month": "2026-08", "edition": "asia-pacific", "countries": 17, "status": "complete", "built_at": "2026-10-19T15:42:30Z" } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/monitor/paper": { "get": { "operationId": "monitor_paper", "summary": "The month's paper as one document", "description": "The World Tourism Monitor paper for a month: brief, key findings, every section, figure and table, each with the call that reproduces it. Free on every key. Plan: Free and up.", "tags": [ "Releases" ], "parameters": [ { "name": "month", "in": "query", "required": false, "description": "A month, YYYY-MM (the latest when left out)", "schema": { "type": "string", "example": "2026-09" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/monitor-paper" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_b4aa0e9eca", "data_as_of": "2026-10-20T04:48:26Z", "count": 1, "month": "2026-07", "built_at": "2026-10-19T15:43:15Z", "cite": "Tourism API (2026). World Tourism Monitor, Issue No. 139, World edition, July 2026. Reference TAPI-WTM-2026-07-WLD. https://tourismapi.com/monitor/2026-07" }, "data": { "month": "2026-07", "issue": 139, "reference": "TAPI-WTM-2026-07-WLD", "title": "World Tourism Monitor, July 2026", "built_at": "2026-10-19T15:43:15Z", "edition_built_at": "2026-10-19T15:42:30Z", "cite": "Tourism API (2026). World Tourism Monitor, Issue No. 139, World edition, July 2026. Reference TAPI-WTM-2026-07-WLD. https://tourismapi.com/monitor/2026-07", "brief": "International arrivals moved +4.0% on a year in July 2026 across the 71 countries that can be compared, and stood at 104.5% of the July 2019 level. 52 of them grew, and 13 had the highest month in their records.", "kf": [ [ "Against July 2019", "104.5%", "" ], [ "Countries growing", "52 of 71", "" ], [ "Record months", "13", "" ] ], "key_findings": [ "Middle East: +23.2% on a year across 2 countries, at 70.4% of 2019; too few countries to speak for the region.", "Largest rise among destinations of 100,000 a month or more: Bolivia, +47.4%. Largest fall: Cambodia, -29.2%.", "Jet fuel averaged $3.40 a gallon, +51.6% on a year." ], "sections": [ { "no": 26, "kick": "Appendix B", "title": "Economic tables", "dek": "Growth, inflation, unemployment and output for every country in this edition.", "paragraphs": [], "figures": [], "tables": [ 21 ] }, { "no": 27, "kick": "Appendix C", "title": "Revisions and corrections", "dek": "What changed in the figures behind this edition, and how corrections are made.", "paragraphs": [ "6 figures behind this edition were revised by the countries in the 35 days before this paper was built on 19 October 2026, after the month it covers. Each edition is kept as first published and served beside its revised form.", "To report an error in this paper, use tourismapi.com/support with the reference on its cover and the figure; confirmed errors are corrected and listed in the next edition." ], "figures": [], "tables": [ 22 ] }, { "no": 28, "kick": "Appendix D", "title": "How this paper was made", "dek": "What went in, what each part rests on, and what was kept out.", "paragraphs": [ "The visitor figures are each country's own published counts, as held when this paper was built. 38 of the 71 countries in this edition count visitors at the border; 33 count guests or nights from abroad at accommodation, where each stay is counted, so their levels are read for direction, not size. Only travel from abroad is used: where a country counts every guest, its foreign guests alone are taken.", "Kept out: estimates from international bodies, bookings or search data, and any figure a country did not publish itself. A country with no figure for the month is not estimated (see Coverage in full). A month that jumps far above the months around it with no change in what is counted is set aside as a likely error; a series that changed what it counts is not compared across the change; a series that covers part of a country only, or counts residents, is held back.", "The world and regional figures are a weighted geometric mean of each country's change on a year, weighted by the square root of its size, so the large destinations count for more and no single country decides them. The largest rise and fall are named among destinations of 100,000 visitors a month or more. Every number in the text was checked against the figures before publication, and a paper that fails the check is held back, not published." ], "figures": [], "tables": [ 23 ] } ], "facts": [ "Visitors from France, summed over the 14 destinations that count them (Costa Rica, Curaçao, Israel, Japan, Jersey, Mauritius, Mongolia, Netherlands, New Caledonia, South Africa, South Korea, Sri Lanka, Thailand, Vietnam): 281,156, +7.4% on a year, 19,000 more than a year before.", "Visitors from the United Kingdom, summed over the 12 destinations that count them (Costa Rica, Curaçao, Israel, Japan, Jersey, Mauritius, Mongolia, South Africa, South Korea, Sri Lanka, Thailand, Vietnam): 271,117, +2.4% on a year, 6,400 more than a year before.", "The world figure with one country left out: without South Korea +3.7%; without Bolivia +3.8%; without Israel +3.8%; without United States +4.2%; without Thailand +4.3%; without Cambodia +4.6%." ], "figures": [ { "no": 19, "title": "The world figure for the next three months, with its range", "unit": "Change on a year, %", "type": "band", "data": { "months": [ "2026-08", "2026-09", "2026-10" ], "value": [ 2.2, 7.6, 2.8 ], "low": [ 1.7, 5.4, -1.8 ], "high": [ 2.7, 9.8, 7.6 ] }, "source": "Tourism API, /v1/stats/forecast, combined as the index is. Months a country has already published are its own figures.", "call": "/v1/stats/forecast?country=ES&horizon=3" }, { "no": 20, "title": "The world figure with each country left out in turn", "unit": "Change on a year, %", "type": "dots", "data": { "labels": [ "United States", "Thailand", "Cambodia" ], "values": [ 4.2, 4.3, 4.6 ], "mark": 4, "low": 2.4, "high": 5.8 }, "source": "Tourism API, World Tourism Monitor. The band holds the middle nine in ten of resampled panels.", "call": "/v1/monitor" }, { "no": 21, "title": "Change on a year, every country, last twelve months", "unit": "%", "type": "heat", "data": { "months": [ "2026-05", "2026-06", "2026-07" ], "rows": [ { "name": "Tunisia", "values": [ null, 10.6, 4.5 ] }, { "name": "United States", "values": [ 2.3, 2.7, -0.1 ] }, { "name": "Vietnam", "values": [ 16.5, 14.7, 6.6 ] } ] }, "source": "Tourism API, /v1/arrivals. Blank: no figure held for the month.", "call": "/v1/growth" } ], "tables": [ { "no": 21, "title": "Economic figures by country", "head": [ "Inflation 2026", "Jobless 2026", "GDP 2026" ], "rows": [ [ "5.5", "n/a", "$62.7bn" ], [ "3.6", "4.2", "$32,642.4bn" ], [ "4.7", "2.1", "$542.1bn" ] ], "source": "Tourism API, /v1/economy/{iso}. Per cent unless shown. Figures from 2026 on are projections.", "call": "/v1/economy/{iso}", "cls": "ct" }, { "no": 22, "title": "Revisions to the figures behind this edition, the 35 days before 19 October 2026", "head": [ "Was", "Now", "Revised" ], "rows": [ [ "107,505", "118,644", "2026-10-15" ], [ "148,567", "159,272", "2026-10-15" ], [ "164,646", "176,624", "2026-10-15" ] ], "source": "Tourism API, /v1/series/{id}/revisions.", "call": "/v1/series/{id}/revisions", "cls": "ct" }, { "no": 23, "title": "What this paper was built from", "head": [ "Part", "What is used", "Where it comes from" ], "rows": [ [ "Currencies", "Daily exchange rates against the euro", "Central bank reference rates" ], [ "Calendar", "Public holidays by country and date", "Official holiday calendars" ], [ "Outlook", "Expected arrivals for the months ahead", "Tourism API's own models, built from each country's history; marked as forecasts" ] ], "source": "Tourism API. Every figure and table in this paper names the call that returns it (Reproduce this paper).", "call": "/v1/monitor?month=2026-07", "cls": "ct" } ], "publisher": "Tourism API", "left_out": [], "back": false, "calls": [ [ "Economic figures by country", "/v1/economy/{iso}", "analyst" ], [ "Revisions to the figures behind this edition, the 35 days before 19 October 2026", "/v1/series/{id}/revisions", "analyst" ], [ "What this paper was built from", "/v1/monitor?month=2026-07", "free" ] ], "numbers": [ "28,000", "33,000", "6,400" ], "check": { "ok": true, "numbers_recorded": 976, "problems": [] }, "scrutiny": { "rules": [ { "level": "check", "where": "Table 9, Maldives", "what": "55.1% of GDP", "why": "Receipts worth more than half of output." }, { "level": "check", "where": "Table 9, Antigua and Barbuda", "what": "52.3% of GDP", "why": "Receipts worth more than half of output." } ], "stops": 0, "checked_at": "2026-10-19T15:43:15Z" }, "articles_kept": 10, "written_at": "2026-10-19T17:09:31Z", "writing": { "open": 0, "at": "2026-10-19T17:09:31Z" } } } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/monitor/index": { "get": { "operationId": "monitor_index", "summary": "The world tourism index, month by month", "description": "The Monitor's headline as a monthly series from 2015: the change on a year, the level against 2019, countries growing and the trust score, for the world or one region. Plan: Analyst and up.", "tags": [ "Releases" ], "parameters": [ { "name": "edition", "in": "query", "required": false, "description": "world (the default), asia-pacific, europe, americas, africa or middle-east", "schema": { "type": "string", "example": "world" } }, { "name": "from", "in": "query", "required": false, "description": "First period to return", "schema": { "type": "string", "example": "2025-01" } }, { "name": "to", "in": "query", "required": false, "description": "Last period to return", "schema": { "type": "string", "example": "2026-08" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/monitor-index" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_7b0dd19565", "data_as_of": "2026-10-20T04:48:26Z", "count": 19, "edition": "world", "method": "Each month: the countries' changes on a year combined as a geometric mean weighted by 2019 size; vs_2019_pct the same month in 2019 = 100." }, "data": [ { "month": "2025-01", "countries": 90, "yoy_pct": 13.4, "vs_2019_pct": 109.8, "growing": 69, "compared": 88, "records": 8, "trust": 97 }, { "month": "2025-02", "countries": 91, "yoy_pct": 3.9, "vs_2019_pct": 106.6, "growing": 56, "compared": 89, "records": 0, "trust": 97 }, { "month": "2025-03", "countries": 92, "yoy_pct": -0.4, "vs_2019_pct": 100.4, "growing": 39, "compared": 89, "records": 2, "trust": 97 } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/monitor/trust": { "get": { "operationId": "monitor_trust", "summary": "How far each country's figures can be trusted", "description": "Every country in the latest Monitor graded on its data as held today: freshness, completeness over five years, revisions and official status, with a 0 to 100 score and a grade. Weakest first. Plan: Analyst and up.", "tags": [ "Releases" ], "parameters": [ { "name": "country", "in": "query", "required": false, "description": "One or more ISO codes, comma separated", "schema": { "type": "string", "example": "CL,BA,AT" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/monitor-trust" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_7f3a1c", "data_as_of": "2026-10-13T04:47:22Z", "count": 1, "next": null }, "data": [ { "country": "LK", "name": "Sri Lanka", "region": "asia-pacific", "measure": "arrivals", "series": "sr_mman287y", "fresh": 100, "complete": 38, "stable": 100, "official": 100, "score": 81, "grade": "B" } ] } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/bulk/{iso}.csv": { "get": { "operationId": "bulk_iso_csv", "summary": "A whole country in one file", "description": "Every series and value for one country as a single CSV, rebuilt after each release. Plan: Intel and up.", "tags": [ "Bulk and account" ], "parameters": [ { "name": "iso", "in": "path", "required": true, "description": "ISO 3166 two-letter country code", "schema": { "type": "string", "example": "CL" } } ], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/bulk-iso-csv" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": "series_id,period,value,unit\njp.arrivals.total.m,2026-06,694628,arrivals\njp.arrivals.total.m,2026-07,769406,arrivals\njp.arrivals.total.m,2026-08,798946,arrivals\n..." } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/bulk/all.zip": { "get": { "operationId": "bulk_all_zip", "summary": "The entire archive in one download", "description": "Everything held, one CSV per country in a zip, with a manifest of series. Plan: Intel and up.", "tags": [ "Bulk and account" ], "parameters": [], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/bulk-all-zip" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_7f3a1c", "data_as_of": "2026-10-12T12:01:11Z", "count": 1, "next": null }, "data": { "file": "all.zip", "countries": 199, "built_at": "2026-10-12T09:41:07Z", "manifest": "/v1/bulk/manifest.json" } } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/units": { "get": { "operationId": "units", "summary": "Every unit and how values are scaled", "description": "The units used across the API and how to read scaled values. Plan: Free and up.", "tags": [ "Bulk and account" ], "parameters": [], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/units" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_55d1900b9d", "data_as_of": "2026-10-20T04:48:26Z", "count": 1 }, "data": { "counts": [ { "unit": "nights", "scale": 1 }, { "unit": "visitors", "scale": 1 }, { "unit": "establishments", "scale": 1 } ], "rates": [ { "unit": "percent", "scale": 1 }, { "unit": "nights per arrival", "scale": 1 } ], "currencies": [ "TWD", "USD", "ZAR" ], "periods": [ "2026-Q2 a quarter", "2026 a year", "2026-10-12 a day" ] } } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/usage": { "get": { "operationId": "usage", "summary": "Your requests today and this month", "description": "Requests made with your key today and this month, by endpoint. Plan: Free and up.", "tags": [ "Bulk and account" ], "parameters": [], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/usage" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_7f3a1c", "data_as_of": "2026-10-12T12:01:11Z", "count": 1, "next": null }, "data": { "today": 214, "month": 3880, "by_endpoint": { "/v1/arrivals": 120, "/v1/series/{id}/observations": 94 } } } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } }, "/v1/status": { "get": { "operationId": "status", "summary": "Service status and data freshness", "description": "Whether the API is up, and when figures were last loaded. Plan: Free and up.", "tags": [ "Bulk and account" ], "parameters": [], "externalDocs": { "url": "https://tourismapi.com/documentation/endpoints/status" }, "responses": { "200": { "description": "The data and its meta", "content": { "application/json": { "example": { "meta": { "request_id": "req_b2f15b089d", "data_as_of": "2026-10-20T04:48:26Z", "count": 1 }, "data": { "ok": true, "last_load": "2026-10-20T04:14:01Z", "countries": 214, "monthly_countries": 125, "monthly_within_2_months": 55, "endpoints_live": 75, "status_page": "https://tourismapi.com/status" } } } } }, "4XX": { "$ref": "#/components/responses/Error" } } } } } }