# presidencia.pt monitor

> Unofficial monitor of news published by the Presidency of the Portuguese Republic
> (www.presidencia.pt). The official site gives each item a date but no time; this site
> records the time each item first appears in the official RSS feed, polled every 5 min,
> and tracks later edits to the text. Portuguese-language content. Not affiliated with
> the Presidency.

How to read the data:

- "first_seen_at" is the derived publication time: the item appeared in the feed at some
  point in (first_seen_after, first_seen_at], an interval of about 5 min. Cite it as the
  time this site first saw the item, not as an official publication time.
- Items published before monitoring began (the archive back to the start of the current
  mandate) have "time_known": false: only their date is known.
- "edited": true means a later capture of the article page differed from the first one.
  Article pages show a word diff; the article text itself is never republished here.
- Tags come from presidencia.pt itself; each item also carries its site section as a tag.
- Always link to the original article ("url") when quoting its content.

Licence: the data this site derives (first-seen times, intervals, edit detection) is
CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attribute it as
"presidencia.pt monitor (https://presidencia.dannyps.net)". Titles, tags and article content belong to
presidencia.pt and are not covered by that licence.

## Data

- [Articles, JSON](https://presidencia.dannyps.net/api/articles): newest first, 50 per page. Parameters: page, tag,
  q (title substring), since (RFC 3339). Returns total, page, page_size, articles[].
- [One article, JSON](https://presidencia.dannyps.net/api/articles/1): /api/articles/{id}, adds first_seen_after.
- [Tags, JSON](https://presidencia.dannyps.net/api/tags): every tag with its article count.
- [Statistics, JSON](https://presidencia.dannyps.net/api/stats)
- [All articles, CSV](https://presidencia.dannyps.net/data/articles.csv): one row per article, same fields.
- [RSS](https://presidencia.dannyps.net/feed.xml): items dated by first_seen_at.

## Pages

- [About and method](https://presidencia.dannyps.net/sobre): how times are derived, precision and limitations.
- [Latest news](https://presidencia.dannyps.net/): the listing, filterable by tag.
- [Tags](https://presidencia.dannyps.net/tags)
- [Statistics](https://presidencia.dannyps.net/stats): publications by day, hour and weekday.
- Article pages: https://presidencia.dannyps.net/a/{id}, with first-seen time, tags, tag history and edit diffs.