# Tourism API

> Official tourism statistics for every country: arrivals, nights, spend, departures, occupancy and capacity, with holidays, exchange rates and worked statistics. JSON over HTTPS at https://api.tourismapi.com/v1 with an X-API-Key header.

- [Full manual](https://tourismapi.com/documentation.md)
- [Agent skill](https://tourismapi.com/skill.md)
- [OpenAPI](https://tourismapi.com/openapi.json)
- [MCP server](https://tourismapi.com/mcp)
- [Pricing](https://tourismapi.com/pricing)

## Guides

- [Start with a free key](https://tourismapi.com/documentation/guides/start-with-a-free-key): What a free key reaches, and a first request that works straight away.
- [Getting started](https://tourismapi.com/documentation/guides/getting-started): Your first call in five minutes: a key, one request, and how to read what comes back.
- [Authentication](https://tourismapi.com/documentation/guides/authentication): How keys work: the header, live and test keys, rotation with overlap.
- [MCP server for Claude and ChatGPT](https://tourismapi.com/documentation/guides/mcp-server-for-claude-and-chatgpt): Ask about tourism figures in plain English from Claude, ChatGPT or any MCP client.
- [MCP tools](https://tourismapi.com/documentation/guides/mcp-tools): Every tool the MCP server offers, what it answers and its inputs.
- [What we cover](https://tourismapi.com/documentation/guides/what-we-cover): Which countries are held, how far back, how often, and where the edges are.
- [The whole API in one file](https://tourismapi.com/documentation/guides/the-whole-api-in-one-file): Every guide and endpoint as one downloadable file, plus OpenAPI, the agent skill and llms.txt.
- [Data integrity](https://tourismapi.com/documentation/guides/data-integrity): What we check on every load, and how to see it for any country before you rely on it.
- [Data freshness and release calendar](https://tourismapi.com/documentation/guides/data-freshness-and-release-calendar): How far behind each country runs, and when its next figures are expected.
- [Revisions](https://tourismapi.com/documentation/guides/revisions): Offices change published figures. Every change is kept, with both values.
- [Historical data and bulk downloads](https://tourismapi.com/documentation/guides/historical-data-and-bulk-downloads): How far back the archive goes, and how to load it all at once.
- [The response envelope](https://tourismapi.com/documentation/guides/the-response-envelope): Every answer has the same two parts: meta and data.
- [Schemas](https://tourismapi.com/documentation/guides/schemas): The fields of every endpoint's answer, with their type and an example.
- [Batch requests](https://tourismapi.com/documentation/guides/batch-requests): Fetch up to 50 series in one call with the ids parameter.
- [Pagination](https://tourismapi.com/documentation/guides/pagination): Lists come in pages; follow the next cursor until it is empty.
- [Errors](https://tourismapi.com/documentation/guides/errors): One error shape, every code, and the status to expect.
- [Periods, dates and frequencies](https://tourismapi.com/documentation/guides/periods-dates-and-frequencies): Months, quarters and years in one notation, and how ranges work.
- [Units, scaling and currencies](https://tourismapi.com/documentation/guides/units-scaling-and-currencies): What each number means, and how money is converted.
- [Definitions differ between countries](https://tourismapi.com/documentation/guides/definitions-differ-between-countries): Arrivals in one country are not always arrivals in another. How to compare fairly.
- [Breakdowns](https://tourismapi.com/documentation/guides/breakdowns): Origin, purpose, accommodation type and region, and where each is held.
- [Joining holidays and exchange rates](https://tourismapi.com/documentation/guides/joining-holidays-and-exchange-rates): Put public holidays and currency moves beside any tourism series.
- [How the statistics are made](https://tourismapi.com/documentation/guides/how-the-statistics-are-made): The method behind every statistic, what each needs, and where each one stops.
- [Rate limits](https://tourismapi.com/documentation/guides/rate-limits): Per-minute and monthly limits, the headers that report them, and how to back off.
- [Webhooks for new releases](https://tourismapi.com/documentation/guides/webhooks-for-new-releases): Be told the moment a country's new figures land, instead of polling.
- [Changelog](https://tourismapi.com/documentation/guides/changelog): Every change to the API and its coverage, dated, newest first.

## Agent skill

- [Tourism API agent skill](https://tourismapi.com/.well-known/agent-skills/tourismapi/SKILL.md): how agents use Tourism API. Index: https://tourismapi.com/.well-known/agent-skills/index.json

## Endpoints

- [GET /v1/countries](https://tourismapi.com/documentation/endpoints/countries): Every country and territory held, with depth and freshness
- [GET /v1/countries/{iso}](https://tourismapi.com/documentation/endpoints/countries-iso): One country: measures, first and latest period
- [GET /v1/countries/{iso}/coverage](https://tourismapi.com/documentation/endpoints/countries-iso-coverage): What each measure covers for a country, month by month
- [GET /v1/countries/{iso}/latest](https://tourismapi.com/documentation/endpoints/countries-iso-latest): The newest figure for every measure in one call
- [GET /v1/regions](https://tourismapi.com/documentation/endpoints/regions): World regions and the countries in each
- [GET /v1/regions/{region}](https://tourismapi.com/documentation/endpoints/regions-region): Regional totals built from national figures
- [GET /v1/countries/{iso}/peers](https://tourismapi.com/documentation/endpoints/countries-iso-peers): The other countries in the same world region
- [GET /v1/countries/{iso}/brief](https://tourismapi.com/documentation/endpoints/countries-iso-brief): Where a country stands, written and in figures
- [GET /v1/countries/{iso}/rivals](https://tourismapi.com/documentation/endpoints/countries-iso-rivals): The destinations a country competes with
- [GET /v1/series](https://tourismapi.com/documentation/endpoints/series): Find series by country, measure, frequency or text
- [GET /v1/series/{id}](https://tourismapi.com/documentation/endpoints/series-id): One series with its unit, frequency and office
- [GET /v1/series/{id}/observations](https://tourismapi.com/documentation/endpoints/series-id-observations): Values for any period range, monthly to annual
- [GET /v1/series/{id}/revisions](https://tourismapi.com/documentation/endpoints/series-id-revisions): Every figure an office later changed, with both values
- [GET /v1/series/{id}/metadata](https://tourismapi.com/documentation/endpoints/series-id-metadata): Definitions, units and breaks in the series
- [GET /v1/series/search](https://tourismapi.com/documentation/endpoints/series-search): Full-text search over two million series names
- [GET /v1/tables](https://tourismapi.com/documentation/endpoints/tables): The office tables the series come from, by country
- [GET /v1/series/{id}/latest](https://tourismapi.com/documentation/endpoints/series-id-latest): The newest figure of a series, with a year before
- [GET /v1/arrivals](https://tourismapi.com/documentation/endpoints/arrivals): Visitor arrivals, any country, any frequency
- [GET /v1/nights](https://tourismapi.com/documentation/endpoints/nights): Overnight stays in all accommodation
- [GET /v1/spend](https://tourismapi.com/documentation/endpoints/spend): Visitor spend in local currency or converted
- [GET /v1/departures](https://tourismapi.com/documentation/endpoints/departures): Residents travelling abroad
- [GET /v1/occupancy](https://tourismapi.com/documentation/endpoints/occupancy): Bed and room occupancy rates
- [GET /v1/capacity](https://tourismapi.com/documentation/endpoints/capacity): Establishments, rooms and beds available
- [GET /v1/arrivals/by-origin](https://tourismapi.com/documentation/endpoints/arrivals-by-origin): Arrivals split by country of residence
- [GET /v1/nights/by-accommodation](https://tourismapi.com/documentation/endpoints/nights-by-accommodation): Nights by hotels, camping, rentals and more
- [GET /v1/nights/by-region](https://tourismapi.com/documentation/endpoints/nights-by-region): Nights by province, county or region
- [GET /v1/arrivals/by-purpose](https://tourismapi.com/documentation/endpoints/arrivals-by-purpose): Leisure, business and visiting friends
- [GET /v1/origins/{iso}](https://tourismapi.com/documentation/endpoints/origins-iso): Where one country's residents travel to
- [GET /v1/compare](https://tourismapi.com/documentation/endpoints/compare): Several countries side by side, same definitions
- [GET /v1/rank](https://tourismapi.com/documentation/endpoints/rank): Countries ranked on any measure and period
- [GET /v1/growth](https://tourismapi.com/documentation/endpoints/growth): Change on last year, month or quarter
- [GET /v1/share](https://tourismapi.com/documentation/endpoints/share): A destination's share of a group of markets
- [GET /v1/seasonality](https://tourismapi.com/documentation/endpoints/seasonality): Seasonal profile and peak months for a series
- [GET /v1/movers](https://tourismapi.com/documentation/endpoints/movers): The countries rising and falling fastest
- [GET /v1/records](https://tourismapi.com/documentation/endpoints/records): Each country's best month, and how close it is now
- [GET /v1/stats/trend](https://tourismapi.com/documentation/endpoints/stats-trend): Seasonally adjusted figures and the trend
- [GET /v1/stats/recovery](https://tourismapi.com/documentation/endpoints/stats-recovery): Each month against the same month of 2019
- [GET /v1/stats/benchmark](https://tourismapi.com/documentation/endpoints/stats-benchmark): A country against its region, on one index
- [GET /v1/stats/stay-length](https://tourismapi.com/documentation/endpoints/stats-stay-length): Nights per arrival and its trend
- [GET /v1/stats/forecast](https://tourismapi.com/documentation/endpoints/stats-forecast): Up to 24 months ahead, with ranges
- [GET /v1/stats/nowcast](https://tourismapi.com/documentation/endpoints/stats-nowcast): Months the office has not published yet
- [GET /v1/stats/anomalies](https://tourismapi.com/documentation/endpoints/stats-anomalies): Months far from what was expected
- [GET /v1/stats/origin-shift](https://tourismapi.com/documentation/endpoints/stats-origin-shift): Which markets are gaining or losing share
- [GET /v1/stats/concentration](https://tourismapi.com/documentation/endpoints/stats-concentration): How dependent a destination is on its markets
- [GET /v1/stats/fx-sensitivity](https://tourismapi.com/documentation/endpoints/stats-fx-sensitivity): How arrivals move with the exchange rate
- [GET /v1/stats/tourism-intensity](https://tourismapi.com/documentation/endpoints/tourism-intensity): Countries ranked by how much they rely on tourism
- [GET /v1/holidays](https://tourismapi.com/documentation/endpoints/holidays): Public holidays for every calendar held
- [GET /v1/holidays/{iso}](https://tourismapi.com/documentation/endpoints/holidays-iso): One country's holidays by year
- [GET /v1/fx](https://tourismapi.com/documentation/endpoints/fx): Daily reference exchange rates since 1999
- [GET /v1/fx/{currency}](https://tourismapi.com/documentation/endpoints/fx-currency): One currency's rate history
- [GET /v1/convert](https://tourismapi.com/documentation/endpoints/convert): Spend converted at each period's rate
- [GET /v1/joins/holidays](https://tourismapi.com/documentation/endpoints/joins-holidays): Any series with holiday counts per period
- [GET /v1/holidays/upcoming](https://tourismapi.com/documentation/endpoints/holidays-upcoming): Public holidays in the coming days
- [GET /v1/fx/latest](https://tourismapi.com/documentation/endpoints/fx-latest): The newest exchange rate for every currency
- [GET /v1/fuel](https://tourismapi.com/documentation/endpoints/fuel): Jet fuel and crude oil, month by month
- [GET /v1/fuel/latest](https://tourismapi.com/documentation/endpoints/fuel-latest): The newest month of fuel prices
- [GET /v1/economy/{iso}](https://tourismapi.com/documentation/endpoints/economy): A country's economy by year
- [GET /v1/economy/{iso}/tourism](https://tourismapi.com/documentation/endpoints/economy-tourism): Tourism's weight in a country's economy
- [GET /v1/economy/outlook](https://tourismapi.com/documentation/endpoints/economy-outlook): Growth and inflation outlook for the next three years
- [GET /v1/releases](https://tourismapi.com/documentation/endpoints/releases): Figures added or revised, newest first
- [GET /v1/releases/latest](https://tourismapi.com/documentation/endpoints/releases-latest): The last release for each country
- [GET /v1/freshness](https://tourismapi.com/documentation/endpoints/freshness): How many months behind each country is
- [GET /v1/gaps](https://tourismapi.com/documentation/endpoints/gaps): Which months each country is missing
- [GET /v1/calendar](https://tourismapi.com/documentation/endpoints/calendar): When each office is next expected to publish
- [GET /v1/changelog](https://tourismapi.com/documentation/endpoints/changelog): Changes to the API and its coverage
- [GET /v1/monitor](https://tourismapi.com/documentation/endpoints/monitor): The monthly report on world tourism, as data
- [GET /v1/monitor/editions](https://tourismapi.com/documentation/endpoints/monitor-editions): Every edition of the Monitor held
- [GET /v1/monitor/paper](https://tourismapi.com/documentation/endpoints/monitor-paper): The month's paper as one document
- [GET /v1/monitor/index](https://tourismapi.com/documentation/endpoints/monitor-index): The world tourism index, month by month
- [GET /v1/monitor/trust](https://tourismapi.com/documentation/endpoints/monitor-trust): How far each country's figures can be trusted
- [GET /v1/bulk/{iso}.csv](https://tourismapi.com/documentation/endpoints/bulk-iso-csv): A whole country in one file
- [GET /v1/bulk/all.zip](https://tourismapi.com/documentation/endpoints/bulk-all-zip): The entire archive in one download
- [GET /v1/units](https://tourismapi.com/documentation/endpoints/units): Every unit and how values are scaled
- [GET /v1/usage](https://tourismapi.com/documentation/endpoints/usage): Your requests today and this month
- [GET /v1/status](https://tourismapi.com/documentation/endpoints/status): Service status and data freshness