{
 "license": {
  "name": "CC BY 4.0",
  "url": "https://creativecommons.org/licenses/by/4.0/",
  "holder": "PrompTugal.news",
  "note": "What PrompTugal.news makes: this file's structure, records and derived values."
 },
 "about": "The catalogue of data.promptugal.news: the raw public data behind every PrompTugal site, collected by code, no articles. Not a warning service: follow IPMA and ANEPC.",
 "api": "v1",
 "contract": "https://data.promptugal.news/api/v1/README.md",
 "version": "v0.1.47",
 "built_at": "2026-11-18T19:18:17.146Z",
 "site": "https://data.promptugal.news",
 "licence": {
  "code": "Apache-2.0",
  "text": "CC BY 4.0",
  "data": "each source keeps its own terms (terms_summary, and the card)"
 },
 "sources": [
  {
   "id": "adsb-faro",
   "title": "Flights around Faro airport",
   "publisher": "adsb.lol (community ADS-B receivers)",
   "cadence": "hourly",
   "read_at": "2026-11-18T19:14:25Z",
   "status": "ok",
   "headline": "1 airline flights, 0 other aircraft",
   "latest": "https://data.promptugal.news/api/v1/adsb-faro/latest.json",
   "reads": "https://data.promptugal.news/api/v1/adsb-faro/reads.json",
   "card": "https://data.promptugal.news/api/v1/adsb-faro/card.json",
   "openapi": "https://data.promptugal.news/api/v1/adsb-faro/openapi.json",
   "page": "https://data.promptugal.news/sources/adsb-faro/",
   "vault_id": "sd1fblzs",
   "terms_summary": "adsb.lol: its API data is licensed under the Open Database License (ODbL 1.0): share-alike, with attribution; no key needed up to 500 requests a day per address."
  },
  {
   "id": "base-gov-pt",
   "title": "Public contracts (Portal BASE)",
   "publisher": "IMPIC, Instituto dos Mercados Públicos, do Imobiliário e da Construção (Portal BASE), through dados.gov.pt",
   "cadence": "every 6 hours",
   "read_at": "2026-11-18T19:14:25Z",
   "status": "ok",
   "headline": "1514 contracts",
   "latest": "https://data.promptugal.news/api/v1/base-gov-pt/latest.json",
   "reads": "https://data.promptugal.news/api/v1/base-gov-pt/reads.json",
   "card": "https://data.promptugal.news/api/v1/base-gov-pt/card.json",
   "openapi": "https://data.promptugal.news/api/v1/base-gov-pt/openapi.json",
   "page": "https://data.promptugal.news/sources/base-gov-pt/",
   "vault_id": null,
   "terms_summary": "IMPIC publishes these contracts as open data on dados.gov.pt with the licence \"Outra (Domínio Público)\" (other-pd, public domain); we name IMPIC and the Portal BASE as the source and link each contract's page."
  },
  {
   "id": "cams",
   "title": "Public live cameras: where they are and whether they are up",
   "publisher": "Each camera's operator, on its own page (register/cams.json lists them)",
   "cadence": "hourly",
   "read_at": "2026-11-18T19:14:28Z",
   "status": "ok",
   "headline": "22 cameras",
   "latest": "https://data.promptugal.news/api/v1/cams/latest.json",
   "reads": "https://data.promptugal.news/api/v1/cams/reads.json",
   "card": "https://data.promptugal.news/api/v1/cams/card.json",
   "openapi": "https://data.promptugal.news/api/v1/cams/openapi.json",
   "page": "https://data.promptugal.news/sources/cams/",
   "vault_id": null,
   "terms_summary": "Official cameras of public bodies and operators' own pages only, by link; each camera's terms are recorded in register/cams.json (terms_page, terms_summary, licence_link). We ask for the operator's page only, once an hour, and keep only whether it answered and whether it still carries a player: never a frame, snapshot or stream, no face or plate recognition, no recording. Never an unsecured private camera. Take-down on request. Rules confirmed by Dinis Cruz on 18 November 2026, about 19:00 UTC (official cameras only; the operator's own embed or a link; never record; MEO BeachCam through its official embeds; Windy's webcams API under its terms, attributed). Not reviewed by a person."
  },
  {
   "id": "events-pt",
   "title": "Events in Portugal, by place",
   "publisher": "Câmara Municipal de Lisboa (Agenda Cultural de Lisboa, agendalx.pt) Câmara Municipal de Lagos (cm-lagos.pt), Teatro das Figuras, Faro (teatrodasfiguras.pt) and Câmara Municipal de Tavira (cm-tavira.pt)",
   "cadence": "every 6 hours",
   "read_at": "2026-11-18T19:14:33Z",
   "status": "partly failed",
   "headline": "141 events",
   "latest": "https://data.promptugal.news/api/v1/events-pt/latest.json",
   "reads": "https://data.promptugal.news/api/v1/events-pt/reads.json",
   "card": "https://data.promptugal.news/api/v1/events-pt/card.json",
   "openapi": "https://data.promptugal.news/api/v1/events-pt/openapi.json",
   "page": "https://data.promptugal.news/sources/events-pt/",
   "vault_id": null,
   "terms_summary": "Strictest of the sources: no reuse licence or terms page was found for any of the four hosts (teatrodasfiguras.pt and cm-tavira.pt show only \"Todos os direitos reservados\" in their footers, and cm-tavira.pt has no robots.txt). The robots.txt files that exist allow the paths read; agendalx.pt sets Content-Signal search=yes, ai-train=no, use=reference. So: reference use only, name the source, link to the event, no AI training. Not reviewed by a person: whether this is enough to republish is for Dinis."
  },
  {
   "id": "github-pt",
   "title": "Code from Portuguese organisations on GitHub",
   "publisher": "The organisations listed in sources/github-pt/orgs.json, through GitHub, Inc.'s REST API",
   "cadence": "every 6 hours",
   "read_at": "2026-11-18T19:14:57Z",
   "status": "ok",
   "headline": "21 orgs",
   "latest": "https://data.promptugal.news/api/v1/github-pt/latest.json",
   "reads": "https://data.promptugal.news/api/v1/github-pt/reads.json",
   "card": "https://data.promptugal.news/api/v1/github-pt/card.json",
   "openapi": "https://data.promptugal.news/api/v1/github-pt/openapi.json",
   "page": "https://data.promptugal.news/sources/github-pt/",
   "vault_id": null,
   "terms_summary": "GitHub's terms allow this use: reading public data through the API is permitted; excessive requests may be suspended; data must not be used for spam or to sell users' personal information. We read organisations' public repositories and releases only, collect no personal data, stay well under the rate limits, and keep each repository's own licence (or a link to its terms) on every item. Not reviewed by a person."
  },
  {
   "id": "ipma-city-forecasts",
   "title": "IPMA daily forecasts by place",
   "publisher": "IPMA, Instituto Português do Mar e da Atmosfera",
   "cadence": "hourly",
   "read_at": "2026-11-18T19:15:52Z",
   "status": "ok",
   "headline": "35 places",
   "latest": "https://data.promptugal.news/api/v1/ipma-city-forecasts/latest.json",
   "reads": "https://data.promptugal.news/api/v1/ipma-city-forecasts/reads.json",
   "card": "https://data.promptugal.news/api/v1/ipma-city-forecasts/card.json",
   "openapi": "https://data.promptugal.news/api/v1/ipma-city-forecasts/openapi.json",
   "page": "https://data.promptugal.news/sources/ipma-city-forecasts/",
   "vault_id": "dn8m3051",
   "terms_summary": "IPMA: free to copy and use for personal or public use if the use has no profit-making or offensive purpose; always name IPMA as the source."
  },
  {
   "id": "ipma-fire-risk",
   "title": "IPMA fire risk",
   "publisher": "IPMA, Instituto Português do Mar e da Atmosfera",
   "cadence": "hourly",
   "read_at": "2026-11-18T19:17:22Z",
   "status": "ok",
   "headline": "278 municipalities",
   "latest": "https://data.promptugal.news/api/v1/ipma-fire-risk/latest.json",
   "reads": "https://data.promptugal.news/api/v1/ipma-fire-risk/reads.json",
   "card": "https://data.promptugal.news/api/v1/ipma-fire-risk/card.json",
   "openapi": "https://data.promptugal.news/api/v1/ipma-fire-risk/openapi.json",
   "page": "https://data.promptugal.news/sources/ipma-fire-risk/",
   "vault_id": "94lw1wl8",
   "terms_summary": "IPMA: free to copy and use for personal or public use if the use has no profit-making or offensive purpose; always name IPMA as the source."
  },
  {
   "id": "ipma-observations",
   "title": "IPMA station observations",
   "publisher": "IPMA, Instituto Português do Mar e da Atmosfera",
   "cadence": "hourly",
   "read_at": "2026-11-18T19:17:29Z",
   "status": "ok",
   "headline": "171 of 227 stations reporting",
   "latest": "https://data.promptugal.news/api/v1/ipma-observations/latest.json",
   "reads": "https://data.promptugal.news/api/v1/ipma-observations/reads.json",
   "card": "https://data.promptugal.news/api/v1/ipma-observations/card.json",
   "openapi": "https://data.promptugal.news/api/v1/ipma-observations/openapi.json",
   "page": "https://data.promptugal.news/sources/ipma-observations/",
   "vault_id": "a3y1ezgg",
   "terms_summary": "IPMA: free to copy and use for personal or public use if the use has no profit-making or offensive purpose; always name IPMA as the source."
  },
  {
   "id": "ipma-sea",
   "title": "IPMA sea forecast",
   "publisher": "IPMA, Instituto Português do Mar e da Atmosfera",
   "cadence": "hourly",
   "read_at": "2026-11-18T19:17:34Z",
   "status": "ok",
   "headline": "12 coastal places",
   "latest": "https://data.promptugal.news/api/v1/ipma-sea/latest.json",
   "reads": "https://data.promptugal.news/api/v1/ipma-sea/reads.json",
   "card": "https://data.promptugal.news/api/v1/ipma-sea/card.json",
   "openapi": "https://data.promptugal.news/api/v1/ipma-sea/openapi.json",
   "page": "https://data.promptugal.news/sources/ipma-sea/",
   "vault_id": "2q3ospco",
   "terms_summary": "IPMA: free to copy and use for personal or public use if the use has no profit-making or offensive purpose; always name IPMA as the source."
  },
  {
   "id": "ipma-uv",
   "title": "IPMA UV index",
   "publisher": "IPMA, Instituto Português do Mar e da Atmosfera",
   "cadence": "hourly",
   "read_at": "2026-11-18T19:17:44Z",
   "status": "ok",
   "headline": "28 places",
   "latest": "https://data.promptugal.news/api/v1/ipma-uv/latest.json",
   "reads": "https://data.promptugal.news/api/v1/ipma-uv/reads.json",
   "card": "https://data.promptugal.news/api/v1/ipma-uv/card.json",
   "openapi": "https://data.promptugal.news/api/v1/ipma-uv/openapi.json",
   "page": "https://data.promptugal.news/sources/ipma-uv/",
   "vault_id": "mah4euep",
   "terms_summary": "IPMA: free to copy and use for personal or public use if the use has no profit-making or offensive purpose; always name IPMA as the source."
  },
  {
   "id": "ipma-warnings",
   "title": "IPMA weather warnings",
   "publisher": "IPMA, Instituto Português do Mar e da Atmosfera",
   "cadence": "hourly",
   "read_at": "2026-11-18T19:17:47Z",
   "status": "ok",
   "headline": "27 active warnings in 25 areas",
   "latest": "https://data.promptugal.news/api/v1/ipma-warnings/latest.json",
   "reads": "https://data.promptugal.news/api/v1/ipma-warnings/reads.json",
   "card": "https://data.promptugal.news/api/v1/ipma-warnings/card.json",
   "openapi": "https://data.promptugal.news/api/v1/ipma-warnings/openapi.json",
   "page": "https://data.promptugal.news/sources/ipma-warnings/",
   "vault_id": "4ol6ht3d",
   "terms_summary": "IPMA: free to copy and use for personal or public use if the use has no profit-making or offensive purpose; always name IPMA as the source."
  },
  {
   "id": "meteoalarm-pt",
   "title": "MeteoAlarm CAP feed for Portugal",
   "publisher": "MeteoAlarm (EUMETNET), from IPMA",
   "cadence": "hourly",
   "read_at": "2026-11-18T19:17:49Z",
   "status": "ok",
   "headline": "66 messages, 27 not expired",
   "latest": "https://data.promptugal.news/api/v1/meteoalarm-pt/latest.json",
   "reads": "https://data.promptugal.news/api/v1/meteoalarm-pt/reads.json",
   "card": "https://data.promptugal.news/api/v1/meteoalarm-pt/card.json",
   "openapi": "https://data.promptugal.news/api/v1/meteoalarm-pt/openapi.json",
   "page": "https://data.promptugal.news/sources/meteoalarm-pt/",
   "vault_id": "whliuye4",
   "terms_summary": "MeteoAlarm: re-users must name the national service (IPMA), keep the time of issue, link www.meteoalarm.org and publish MeteoAlarm's disclaimer. latest.json carries all four."
  },
  {
   "id": "social",
   "title": "Social signals: organisations' public posts, by link",
   "publisher": "The organisations themselves, through Bluesky (public AppView API) and Mastodon (public instance API)",
   "cadence": "every 6 hours",
   "read_at": "2026-11-18T19:17:54Z",
   "status": "partly failed",
   "headline": "147 posts",
   "latest": "https://data.promptugal.news/api/v1/social/latest.json",
   "reads": "https://data.promptugal.news/api/v1/social/reads.json",
   "card": "https://data.promptugal.news/api/v1/social/card.json",
   "openapi": "https://data.promptugal.news/api/v1/social/openapi.json",
   "page": "https://data.promptugal.news/sources/social/",
   "vault_id": null,
   "terms_summary": "Organisations only, official interfaces only, by link. Bluesky: robots.txt of the public API allows crawling it and asks for backoff on 429; the Terms of Service (14 Aug 2025) leave each post's content with its author, so we store link and metadata only and credit the organisation. Mastodon: mastodon.social's terms (effective 2026-08-31) say whoever owns the content retains ownership and allow API access; its robots.txt disallows only /media_proxy/, /interact/ and a domain-blocks path. Licence on each post: the platform's terms, holder the organisation. Not reviewed by a person."
  },
  {
   "id": "storm-charles-archive",
   "title": "Storm Charles archive",
   "publisher": "storm-charles.promptugal.news (the Storm Charles incident team)",
   "cadence": "once",
   "read_at": "2026-11-17T19:27:57Z",
   "status": "archived",
   "headline": "142 files",
   "latest": "https://data.promptugal.news/api/v1/storm-charles-archive/latest.json",
   "reads": null,
   "card": "https://data.promptugal.news/api/v1/storm-charles-archive/card.json",
   "openapi": "https://data.promptugal.news/api/v1/storm-charles-archive/openapi.json",
   "page": "https://data.promptugal.news/sources/storm-charles-archive/",
   "vault_id": "j2fq58kn",
   "terms_summary": "The storm site's own data: Apache-2.0 (its repository's licence). Quoted sources keep their own terms; each item links its source."
  }
 ],
 "by_place": [
  "https://data.promptugal.news/api/v1/by-place/now/albufeira.json",
  "https://data.promptugal.news/api/v1/by-place/now/alcoutim.json",
  "https://data.promptugal.news/api/v1/by-place/now/algarve.json",
  "https://data.promptugal.news/api/v1/by-place/now/aljezur.json",
  "https://data.promptugal.news/api/v1/by-place/now/castro-marim.json",
  "https://data.promptugal.news/api/v1/by-place/now/faro.json",
  "https://data.promptugal.news/api/v1/by-place/now/lagoa.json",
  "https://data.promptugal.news/api/v1/by-place/now/lagos.json",
  "https://data.promptugal.news/api/v1/by-place/now/loule.json",
  "https://data.promptugal.news/api/v1/by-place/now/monchique.json",
  "https://data.promptugal.news/api/v1/by-place/now/olhao.json",
  "https://data.promptugal.news/api/v1/by-place/now/portimao.json",
  "https://data.promptugal.news/api/v1/by-place/now/quarteira.json",
  "https://data.promptugal.news/api/v1/by-place/now/sao-bras-de-alportel.json",
  "https://data.promptugal.news/api/v1/by-place/now/silves.json",
  "https://data.promptugal.news/api/v1/by-place/now/tavira.json",
  "https://data.promptugal.news/api/v1/by-place/now/vila-do-bispo.json",
  "https://data.promptugal.news/api/v1/by-place/now/vila-real-de-santo-antonio.json"
 ],
 "by_place_index": "https://data.promptugal.news/api/v1/by-place/now/index.json",
 "events_by_place_index": "https://data.promptugal.news/api/v1/events/by-place/index.json",
 "openapi": "https://data.promptugal.news/api/v1/openapi.json",
 "swagger": "https://data.promptugal.news/api/swagger/"
}
