# How this site works: the data, the pictures, the provenance, the storage

Everything here is public data, read by code on a schedule and kept with its source and the time it was read. This page says, for every data set, where it comes from, how it is read, how it is shown, where it is stored and how to reach it.

## For every data set

| Data set | Source and interface | Read | Shown | Stored | Reach it |
|---|---|---|---|---|---|
| [Flights around Faro airport](/sources/adsb-faro/) | adsb.lol (community ADS-B receivers): [https://api.adsb.lol/v2/point/37.0144/-7.9659/40](https://api.adsb.lol/v2/point/37.0144/-7.9659/40) | hourly | [the source page](/sources/adsb-faro/): the source, the raw data, the processed data | vault sd1fblzs (public read key on the card), and this site | [latest.json](/api/v1/adsb-faro/latest.json), [OpenAPI](/api/v1/adsb-faro/openapi.json) |
| [Public contracts (Portal BASE)](/sources/base-gov-pt/) | IMPIC: [https://dados.gov.pt/pt/datasets/66d72d488ca4b7...](https://dados.gov.pt/pt/datasets/66d72d488ca4b7cb2de28712/) | every 6 hours | [the source page](/sources/base-gov-pt/): the source, the raw data, the processed data | this site (latest and every read) | [latest.json](/api/v1/base-gov-pt/latest.json), [OpenAPI](/api/v1/base-gov-pt/openapi.json) |
| [Public live cameras: where they are and whether they are up](/sources/cams/) | Each camera's operator: [https://github.com/PrompTugal/PrompTugal__News_...](https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/register/cams.json) | hourly | [the source page](/sources/cams/): the source, the raw data, the processed data | this site (latest and every read) | [latest.json](/api/v1/cams/latest.json), [OpenAPI](/api/v1/cams/openapi.json) |
| [Events in Portugal, by place](/sources/events-pt/) | Câmara Municipal de Lisboa (Agenda Cultural de Lisboa: [https://www.agendalx.pt/wp-json/agendalx/v1/events](https://www.agendalx.pt/wp-json/agendalx/v1/events) | every 6 hours | [the source page](/sources/events-pt/): the source, the raw data, the processed data | this site (latest and every read) | [latest.json](/api/v1/events-pt/latest.json), [OpenAPI](/api/v1/events-pt/openapi.json) |
| [Code from Portuguese organisations on GitHub](/sources/github-pt/) | The organisations listed in sources/github-pt/orgs.json: [https://api.github.com/](https://api.github.com/) | every 6 hours | [the source page](/sources/github-pt/): the source, the raw data, the processed data | this site (latest and every read) | [latest.json](/api/v1/github-pt/latest.json), [OpenAPI](/api/v1/github-pt/openapi.json) |
| [IPMA daily forecasts by place](/sources/ipma-city-forecasts/) | IPMA: [https://api.ipma.pt/open-data/forecast/meteorol...](https://api.ipma.pt/open-data/forecast/meteorology/cities/daily/) | hourly | [the source page](/sources/ipma-city-forecasts/): the source, the raw data, the processed data | vault dn8m3051 (public read key on the card), and this site | [latest.json](/api/v1/ipma-city-forecasts/latest.json), [OpenAPI](/api/v1/ipma-city-forecasts/openapi.json) |
| [IPMA fire risk](/sources/ipma-fire-risk/) | IPMA: [https://api.ipma.pt/open-data/forecast/meteorol...](https://api.ipma.pt/open-data/forecast/meteorology/rcm/) | hourly | [the source page](/sources/ipma-fire-risk/): the source, the raw data, the processed data | vault 94lw1wl8 (public read key on the card), and this site | [latest.json](/api/v1/ipma-fire-risk/latest.json), [OpenAPI](/api/v1/ipma-fire-risk/openapi.json) |
| [IPMA station observations](/sources/ipma-observations/) | IPMA: [https://api.ipma.pt/open-data/observation/meteo...](https://api.ipma.pt/open-data/observation/meteorology/stations/observations.json) | hourly | [the source page](/sources/ipma-observations/): the source, the raw data, the processed data | vault a3y1ezgg (public read key on the card), and this site | [latest.json](/api/v1/ipma-observations/latest.json), [OpenAPI](/api/v1/ipma-observations/openapi.json) |
| [IPMA sea forecast](/sources/ipma-sea/) | IPMA: [https://api.ipma.pt/open-data/forecast/oceanogr...](https://api.ipma.pt/open-data/forecast/oceanography/daily/) | hourly | [the source page](/sources/ipma-sea/): the source, the raw data, the processed data | vault 2q3ospco (public read key on the card), and this site | [latest.json](/api/v1/ipma-sea/latest.json), [OpenAPI](/api/v1/ipma-sea/openapi.json) |
| [IPMA UV index](/sources/ipma-uv/) | IPMA: [https://api.ipma.pt/open-data/forecast/meteorol...](https://api.ipma.pt/open-data/forecast/meteorology/uv/uv.json) | hourly | [the source page](/sources/ipma-uv/): the source, the raw data, the processed data | vault mah4euep (public read key on the card), and this site | [latest.json](/api/v1/ipma-uv/latest.json), [OpenAPI](/api/v1/ipma-uv/openapi.json) |
| [IPMA weather warnings](/sources/ipma-warnings/) | IPMA: [https://api.ipma.pt/open-data/forecast/warnings...](https://api.ipma.pt/open-data/forecast/warnings/warnings_www.json) | hourly | [the source page](/sources/ipma-warnings/): the source, the raw data, the processed data | vault 4ol6ht3d (public read key on the card), and this site | [latest.json](/api/v1/ipma-warnings/latest.json), [OpenAPI](/api/v1/ipma-warnings/openapi.json) |
| [MeteoAlarm CAP feed for Portugal](/sources/meteoalarm-pt/) | MeteoAlarm (EUMETNET): [https://feeds.meteoalarm.org/api/v1/warnings/fe...](https://feeds.meteoalarm.org/api/v1/warnings/feeds-portugal) | hourly | [the source page](/sources/meteoalarm-pt/): the source, the raw data, the processed data | vault whliuye4 (public read key on the card), and this site | [latest.json](/api/v1/meteoalarm-pt/latest.json), [OpenAPI](/api/v1/meteoalarm-pt/openapi.json) |
| [Social signals: organisations' public posts, by link](/sources/social/) | The organisations themselves: [https://public.api.bsky.app/xrpc/](https://public.api.bsky.app/xrpc/) | every 6 hours | [the source page](/sources/social/): the source, the raw data, the processed data | this site (latest and every read) | [latest.json](/api/v1/social/latest.json), [OpenAPI](/api/v1/social/openapi.json) |
| [Storm Charles archive](/sources/storm-charles-archive/) | storm-charles.promptugal.news (the Storm Charles incident team): [https://storm-charles.promptugal.news/api/v1/in...](https://storm-charles.promptugal.news/api/v1/index.json) | once | [the source page](/sources/storm-charles-archive/): the source, the raw data, the processed data | vault j2fq58kn (public read key on the card), and this site | [latest.json](/api/v1/storm-charles-archive/latest.json), [OpenAPI](/api/v1/storm-charles-archive/openapi.json) |

## Events: look, then publish what we may

- **Read:** official agendas with a public interface ([the events card](/sources/events-pt/)): Agenda LX for Lisbon, Câmara Municipal de Lagos. Their events are published with their details and a link back.
- **Look (phase 1):** once a day per place, one question to Perplexity (sonar, through OpenRouter) asks what is on, with sources. 18 answers so far, 0.10 USD in all (budget 5 USD a day until Dinis sets one). Each answer is kept whole with its model, time, prompt and cited links: [the discovery files](/api/v1/discovery/index.json). Nothing in an answer is published as content.
- **Claims (phase 2):** each event an answer names becomes a claim with every evidence link, each marked readable or not by [the register](/sources/). A claim takes its details only from a readable source; otherwise it shows the name, the date and the place with "details withheld". [Claims by place](/api/v1/events/claims/by-place/index.json).
- **Gaps:** every cited host we do not read is counted on [the gaps page](/sources/gaps/), and goes to the register and to a request on the record.
- **Over time:** a claim is never deleted when its date passes; it moves to [/api/v1/events/past/](/api/v1/events/claims/by-place/index.json), the history of each event series.

## Licences

- What PrompTugal.news makes (these pages, our records, the register, the visualisations) is [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
- What we take from a source stays under its licence: every JSON file and every event carries a `license` link, the source's published licence, or where it publishes none its terms labelled "the source's terms". Never blank, never assumed open.
- Events found only through Perplexity are shown by title, date, place and the pages that mention them, credited "through Perplexity"; their details are withheld.
- An organiser's own submission is published, credited and dated as theirs ([how](https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/submissions/README.md)); later, signed with the organiser's key.

## Security

- Every automation has a published threat model: what it reads, writes and trusts, what could go wrong, the mitigations. Written so far: [discovery (Perplexity) and claims](https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/docs/threat-models/discovery.md), [social signals](https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/docs/threat-models/social.md); the list and the ones still to write: [threat models](https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/docs/threat-models/README.md). Reviewed by security@PrompTugal.dinis.
- Text from Perplexity answers, social posts and fetched pages is untrusted: it is never acted on, shown only escaped, and links keep only http(s) addresses.
- An AppSec review runs on every code change before it is committed (Dinis, 18 November 2026). Every finding is published on [the security page](/security/).

## Who and what

- Code reads the sources and builds this site: no model is called to collect or build, except the daily discovery question above.
- Agents wrote the code: data.b@PrompTugal.dinis (Opus) and its Sonnet sub-agents; see [about](/about/).
- No person has checked a value yet.

---

Version v0.1.47 · data read 2026-11-18 19:18 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/how/
