# Tourist nights by where guests live: Portugal, Algarve, Lisbon, London (Eurostat)

Nights spent at tourist accommodation (hotels, short-stay accommodation and camping) by the guest's residence, for Portugal, the Algarve (PT15), the Lisbon metropolitan area (PT17) and London (UKI): annual for the last 10 years and monthly for Portugal for 36 months. Regions are split into domestic, foreign and total guests; Portugal as a whole is also split by named country (United Kingdom, Germany, France, Spain, the Netherlands, the United States). Lisbon is PT17 to 2022 and Grande Lisboa (PT1A) plus Península de Setúbal (PT1B) from 2023, as Eurostat changed the regions. Eurostat's London data stops in 2016.

Three layers: **the source** (who publishes it, the terms, when it was read), **the raw data** as the publisher served it, and **the processed data**, what this site makes of it. The processing is where the value is: named fields, places joined, gaps marked, every value kept with its source and time.

## 1. The source

## At a glance

| Field | Value |
|---|---|
| Publisher | Eurostat (European Commission) |
| Source | [https://ec.europa.eu/eurostat/web/tourism/database](https://ec.europa.eu/eurostat/web/tourism/database) |
| Reader page | [https://ec.europa.eu/eurostat/databrowser/view/tour_occ_nin2/default/table](https://ec.europa.eu/eurostat/databrowser/view/tour_occ_nin2/default/table) |
| Schedule | every 6 hours: the Pages workflow (.github/workflows/pages.yml) at 00, 06, 12 and 18 UTC; three requests a run, 2.5 seconds apart (about 14 KB in all); every other run keeps the last read, copied from the live site. Eurostat updates these tables a few times a year. |
| Owner | data.b@PrompTugal.dinis |
| Collector | [sources/eurostat-tourism/collect.mjs](https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/sources/eurostat-tourism/collect.mjs) |
| Since | 2026-11-18 |
| Last read | 2026-11-21 07:06 UTC |
| Last run | ok: 3 requests ok, 0 failed |
| Now | 280 rows |
| Licence | The data: [Eurostat reuse policy (Commission Decision of 12 December 2011)](https://ec.europa.eu/eurostat/web/main/help/copyright-notice) (Eurostat). This page, the card and the records we add: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). |

## Reuse terms

Reuse of statistical data is authorised for commercial or non-commercial purposes provided the source is acknowledged (Commission Decision of 12 December 2011); no key. Acknowledge with "Source: Eurostat" and the dataset code. Not reviewed by a person. Reuse: yes, with the source acknowledged ("Source: Eurostat", dataset code and link).

> Reuse of statistical data, metadata, publications, and other dissemination tools published on this website for commercial or non-commercial purposes is authorised provided the source is acknowledged. The reuse policy of the European Commission is implemented by the Decision of 12 December 2011.
>
> The publisher's words (en), from [https://ec.europa.eu/eurostat/web/main/help/copyright-notice](https://ec.europa.eu/eurostat/web/main/help/copyright-notice), read on 2026-11-18.

**Open question:** The page named in the brief (https://ec.europa.eu/eurostat/about-us/policies/copyright) answers 404 now; the notice was read at the address above. The notice says individual documents may carry their own conditions; none was seen on these tables. security@PrompTugal.dinis to review.

## 2. The raw data

As Eurostat (European Commission) served it at the latest read (2026-11-21 07:06 UTC), unprocessed. The files: [tour_occ_nim.json](/api/v1/eurostat-tourism/raw/tour_occ_nim.json), [tour_occ_nin2.json](/api/v1/eurostat-tourism/raw/tour_occ_nin2.json), [tour_occ_ninraw.json](/api/v1/eurostat-tourism/raw/tour_occ_ninraw.json).

Eurostat's own JSON-stat answers, as served: nights by region, by country of residence, and by month. The data: [/api/v1/eurostat-tourism/raw/tour_occ_nin2.json](/api/v1/eurostat-tourism/raw/tour_occ_nin2.json).

## 3. The processed data

The collector asks Eurostat's dissemination API for three tables (tour_occ_nin2, tour_occ_ninraw, tour_occ_nim), reads each value with its dimension codes, keeps the last 10 years (36 months for the monthly table) and drops a value that does not decode. Regions are split only into domestic, foreign and total guests; named countries exist for Portugal as a whole. Lisbon is PT17 to 2022 and Grande Lisboa and Setubal from 2023, as Eurostat changed the regions. Eurostat has no London value after 2016. Source: Eurostat (tour_occ_nin2, tour_occ_ninraw, tour_occ_nim), [reuse notice](https://ec.europa.eu/eurostat/web/main/help/copyright-notice). The result: [latest.json](/api/v1/eurostat-tourism/latest.json).

Nights spent at tourist accommodation by where the guest lives: Portugal, the Algarve, Lisbon and London, with the United Kingdom, Germany, France, Spain, the Netherlands and the United States for Portugal as a whole. The data: [/api/v1/eurostat-tourism/latest.json](/api/v1/eurostat-tourism/latest.json).

## More about this source

## What runs by code, by agents and by people

### Code

- the collector asks Eurostat's JSON-stat API for three tables, decodes each value with its dimension codes and labels, and keeps number, unit and flag
- GitHub Actions runs it and deploys the site

### Agents

- data.b.dev2@PrompTugal.dinis wrote the collector and card on 18 November 2026 for data.b@ (WS-177)

### People

- Dinis Cruz decided to add the EU, keyless first, on 18 November 2026 (board/team/data/briefs/2026-11-18-dinis-europe-open-data-public-service.md); no person has checked the values (not reviewed)

## Cost

| Field | Value |
|---|---|
| per run tokens | 0 |
| per run model cost usd | 0 |
| runner | GitHub Actions on a public repository: no charge; three requests a run (about 14 KB) |
| build tokens | not measured |
| note | Code only: no model is called when the data is collected. |

## API addresses

These addresses stay for the life of v1 ([the contract](/api/v1/README.md)).

| File | Address |
|---|---|
| Latest read | [https://data.promptugal.news/api/v1/eurostat-tourism/latest.json](https://data.promptugal.news/api/v1/eurostat-tourism/latest.json) |
| Every read | [https://data.promptugal.news/api/v1/eurostat-tourism/reads.json](https://data.promptugal.news/api/v1/eurostat-tourism/reads.json) |
| Card | [https://data.promptugal.news/api/v1/eurostat-tourism/card.json](https://data.promptugal.news/api/v1/eurostat-tourism/card.json) |
| OpenAPI | [https://data.promptugal.news/api/v1/eurostat-tourism/openapi.json](https://data.promptugal.news/api/v1/eurostat-tourism/openapi.json) |

```
curl -s https://data.promptugal.news/api/v1/eurostat-tourism/latest.json
curl -s https://data.promptugal.news/api/v1/eurostat-tourism/reads.json | head -c 600
```

## Vault

Vault not yet created. The collector writes the bytes of each read to a vault copy; until the vault exists they are not kept.

## Last runs

| Time (UTC) | Requests ok | Requests failed | Reads with changed bytes |
|---|---|---|---|
| 2026-11-21 07:06 UTC | 3 | 0 | 0 of 3 |
| 2026-11-20 18:06 UTC | 3 | 0 | 0 of 3 |
| 2026-11-20 07:07 UTC | 3 | 0 | 0 of 3 |
| 2026-11-19 13:06 UTC | 3 | 0 | 0 of 3 |
| 2026-11-19 07:05 UTC | 3 | 0 | 0 of 3 |
| 2026-11-19 01:30 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 23:43 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 23:35 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 23:28 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 23:22 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 22:52 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 22:43 UTC | 3 | 0 | 3 of 3 |

Showing 12 of 12 runs kept. Full detail with sha256: [reads.json](https://data.promptugal.news/api/v1/eurostat-tourism/reads.json).

## Preview of the values

The first 3 of 3 entries in `datasets`, as read 2026-11-21 07:06 UTC. Source: [https://ec.europa.eu/eurostat/web/tourism/database](https://ec.europa.eu/eurostat/web/tourism/database). Long values are shortened here; the file has them whole.

| dataset | ok | title | updated | rows | api | Source |
|---|---|---|---|---|---|---|
| tour_occ_nin2 | true | Nights spent at tourist accommodation establishments by NUTS 3 region | 2026-10-20T23:00:00 | 102 | https://ec.europa.eu/eurostat/api/dissemination/statistics/1.0/data/tour_occ_... | [source](https://ec.europa.eu/eurostat/web/tourism/database) |
| tour_occ_ninraw | true | Nights spent at tourist accommodation establishments by country of origin of ... | 2026-10-12T23:00:00 | 70 | https://ec.europa.eu/eurostat/api/dissemination/statistics/1.0/data/tour_occ_... | [source](https://ec.europa.eu/eurostat/web/tourism/database) |
| tour_occ_nim | true | Nights spent at tourist accommodation establishments - monthly data | 2026-11-16T11:00:00 | 108 | https://ec.europa.eu/eurostat/api/dissemination/statistics/1.0/data/tour_occ_nim | [source](https://ec.europa.eu/eurostat/web/tourism/database) |

---

Version v0.1.151 · data read 2026-11-21 09:20 UTC · Code Apache-2.0; our pages, records and visualisations CC BY 4.0; each source's data under its own licence or terms, linked · [Repository](https://github.com/PrompTugal/PrompTugal__News__Data) · [Pay for what you read](https://promptugal.news/account/) · https://data.promptugal.news/sources/eurostat-tourism/
