{
 "openapi": "3.1.0",
 "info": {
  "title": "Events in Portugal, by place: data.promptugal.news",
  "version": "v0.1.47",
  "description": "Public events on now or in the next 60 days in Lisbon and the Algarve places, as schema.org Event records, each with its source URL and the time read.\n\nPublisher: 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). Reuse terms: 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. Not a warning service: follow IPMA and ANEPC.\n\nCode: Apache-2.0. Text: CC BY 4.0. The data keeps the terms of its own source (see each source card); nothing here relaxes them.",
  "license": {
   "name": "Apache-2.0 for code; each source keeps its own data terms",
   "identifier": "Apache-2.0"
  },
  "contact": {
   "name": "PrompTugal.news data",
   "url": "https://github.com/PrompTugal/PrompTugal__News__Data"
  }
 },
 "servers": [
  {
   "url": "https://data.promptugal.news",
   "description": "Production"
  }
 ],
 "externalDocs": {
  "description": "How to use the API",
  "url": "https://data.promptugal.news/api/"
 },
 "paths": {
  "/api/v1/events-pt/latest.json": {
   "get": {
    "operationId": "get_events_pt_latest",
    "tags": [
     "events-pt"
    ],
    "summary": "Events in Portugal, by place: the latest read",
    "description": "Events on now or starting within 60 days (to 2027-01-17) in the places listed, as schema.org Event records, each with its source URL and the time read. Dates are as the source gives them (Lisbon time; a time is added only where a single start hour is shown); a long-running event shows its first and last day. organizer is null where the source does not name an organiser (the agenda's publisher is in source). A dated record read by code, not a ticketing or booking service: check the organiser before travelling.",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "source": {
           "type": "string"
          },
          "title": {
           "type": "string"
          },
          "read_at": {
           "type": "string"
          },
          "provenance": {
           "type": "object",
           "properties": {
            "source": {
             "type": "string"
            },
            "page": {
             "type": "string"
            },
            "read_at": {
             "type": "string"
            },
            "by": {
             "type": "string"
            },
            "terms": {
             "type": "string"
            },
            "sources": {
             "type": "array",
             "items": {
              "type": "object",
              "properties": {
               "host": {
                "type": "string"
               },
               "what": {
                "type": "string"
               },
               "route": {
                "type": "string",
                "format": "uri"
               },
               "terms": {
                "type": "string"
               }
              },
              "required": [
               "host",
               "what",
               "route",
               "terms"
              ]
             }
            }
           },
           "required": [
            "source",
            "page",
            "read_at",
            "by",
            "terms",
            "sources"
           ]
          },
          "about": {
           "type": "string"
          },
          "counts": {
           "type": "object",
           "properties": {
            "events": {
             "type": "integer"
            },
            "places": {
             "type": "integer"
            },
            "by_source": {
             "type": "object",
             "properties": {
              "www.agendalx.pt": {
               "type": "integer"
              },
              "www.cm-lagos.pt": {
               "type": "integer"
              },
              "teatrodasfiguras.pt": {
               "type": "integer"
              },
              "cm-tavira.pt": {
               "type": "integer"
              }
             },
             "required": [
              "www.agendalx.pt",
              "www.cm-lagos.pt",
              "teatrodasfiguras.pt",
              "cm-tavira.pt"
             ]
            },
            "dropped_duplicates_or_unknown_place": {
             "type": "integer"
            }
           },
           "required": [
            "events",
            "places",
            "by_source",
            "dropped_duplicates_or_unknown_place"
           ]
          },
          "places": {
           "type": "object",
           "properties": {
            "lagos": {
             "type": "array",
             "items": {
              "type": "object",
              "properties": {
               "@type": {
                "type": "string"
               },
               "name": {
                "type": "string"
               },
               "startDate": {
                "type": "string"
               },
               "endDate": {
                "type": [
                 "string",
                 "null"
                ],
                "format": "date"
               },
               "location": {
                "type": "object",
                "properties": {
                 "@type": {
                  "type": "string"
                 },
                 "name": {
                  "type": "string"
                 },
                 "address": {
                  "type": "null"
                 },
                 "geo": {
                  "type": "null"
                 }
                },
                "required": [
                 "@type",
                 "name",
                 "address",
                 "geo"
                ]
               },
               "organizer": {
                "type": "null"
               },
               "url": {
                "type": "string",
                "format": "uri"
               },
               "source": {
                "type": "string",
                "format": "uri"
               },
               "read_at": {
                "type": "string"
               },
               "place": {
                "type": "string"
               }
              },
              "required": [
               "@type",
               "name",
               "startDate",
               "endDate",
               "location",
               "organizer",
               "url",
               "source",
               "read_at",
               "place"
              ]
             }
            },
            "faro": {
             "type": "array",
             "items": {
              "type": "object",
              "properties": {
               "@type": {
                "type": "string"
               },
               "name": {
                "type": "string"
               },
               "startDate": {
                "type": "string",
                "format": "date"
               },
               "endDate": {
                "type": [
                 "null",
                 "string"
                ]
               },
               "location": {
                "type": "object",
                "properties": {
                 "@type": {
                  "type": "string"
                 },
                 "name": {
                  "type": "string"
                 },
                 "address": {
                  "type": "null"
                 },
                 "geo": {
                  "type": "null"
                 }
                },
                "required": [
                 "@type",
                 "name",
                 "address",
                 "geo"
                ]
               },
               "organizer": {
                "type": "null"
               },
               "url": {
                "type": "string",
                "format": "uri"
               },
               "source": {
                "type": "string",
                "format": "uri"
               },
               "read_at": {
                "type": "string"
               },
               "place": {
                "type": "string"
               }
              },
              "required": [
               "@type",
               "name",
               "startDate",
               "endDate",
               "location",
               "organizer",
               "url",
               "source",
               "read_at",
               "place"
              ]
             }
            },
            "tavira": {
             "type": "array",
             "items": {
              "type": "object",
              "properties": {
               "@type": {
                "type": "string"
               },
               "name": {
                "type": "string"
               },
               "startDate": {
                "type": "string"
               },
               "endDate": {
                "type": "null"
               },
               "location": {
                "type": "object",
                "properties": {
                 "@type": {
                  "type": "string"
                 },
                 "name": {
                  "type": "string"
                 },
                 "address": {
                  "type": "null"
                 },
                 "geo": {
                  "type": "null"
                 }
                },
                "required": [
                 "@type",
                 "name",
                 "address",
                 "geo"
                ]
               },
               "organizer": {
                "type": "null"
               },
               "url": {
                "type": "string",
                "format": "uri"
               },
               "source": {
                "type": "string",
                "format": "uri"
               },
               "read_at": {
                "type": "string"
               },
               "place": {
                "type": "string"
               }
              },
              "required": [
               "@type",
               "name",
               "startDate",
               "endDate",
               "location",
               "organizer",
               "url",
               "source",
               "read_at",
               "place"
              ]
             }
            }
           },
           "required": [
            "lagos",
            "faro",
            "tavira"
           ]
          },
          "gaps": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "host": {
              "type": "string"
             },
             "why": {
              "type": "string"
             },
             "read_at": {
              "type": "string"
             }
            },
            "required": [
             "host",
             "why",
             "read_at"
            ]
           }
          }
         },
         "required": [
          "source",
          "title",
          "read_at",
          "provenance",
          "about",
          "counts",
          "places",
          "gaps"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "source": "events-pt",
           "title": "Events in Portugal, by place",
           "read_at": "2026-11-18T19:14:33Z",
           "provenance": {
            "source": "https://www.agendalx.pt/wp-json/agendalx/v1/events?per_page=50",
            "page": "https://www.agendalx.pt/",
            "read_at": "2026-11-18T19:14:33Z",
            "by": "sources/events-pt/collect.mjs (code, no model; run by data.b@PrompTugal.dinis)",
            "terms": "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 Co...",
            "sources": [
             {
              "host": "www.agendalx.pt",
              "what": "Agenda Cultural de Lisboa (Câmara Municipal de Lisboa)",
              "route": "https://www.agendalx.pt/wp-json/agendalx/v1/events?per_page=50",
              "terms": "No terms page found. robots.txt (read 18 Nov 2026) allows all paths and sets \"Content-Signal: search=yes,ai-train=no,use=reference\": reference use with the source named and linked; no AI training."
             },
             {
              "host": "www.cm-lagos.pt",
              "what": "Câmara Municipal de Lagos, events list",
              "route": "https://www.cm-lagos.pt/municipio/eventos",
              "terms": "No terms page found. robots.txt (read 18 Nov 2026) disallows only administrative folders, not /municipio/eventos."
             },
             {
              "host": "teatrodasfiguras.pt",
              "what": "Teatro das Figuras, Faro (municipal theatre), agenda page",
              "route": "https://teatrodasfiguras.pt/agenda",
              "terms": "No terms of use page found (its information pages are directions, opening hours, privacy and cookies only). robots.txt (read 18 Nov 2026) allows all but /private/. The footer says \"Todos os direitos reservados\". Titles, dates and links only; each event links to its page."
             }
            ]
           },
           "about": "Events on now or starting within 60 days (to 2027-01-17) in the places listed, as schema.org Event records, each with its source URL and the time read. Dates are as the source gives them (Lisbon time; a time is added only where a single start hour is shown); a long-running event shows its first and ...",
           "counts": {
            "events": 141,
            "places": 3,
            "by_source": {
             "www.agendalx.pt": 0,
             "www.cm-lagos.pt": 92,
             "teatrodasfiguras.pt": 10,
             "cm-tavira.pt": 39
            },
            "dropped_duplicates_or_unknown_place": 0
           },
           "places": {
            "lagos": [
             {
              "@type": "Event",
              "name": "EXPOSIÇÃO “O CRUZEIRO”, de Timo Dillner",
              "startDate": "2026-10-03",
              "endDate": "2026-12-30",
              "location": {
               "@type": "Place",
               "name": "Centro Cultural de Lagos – Sala de Exposições 1",
               "address": null,
               "geo": null
              },
              "organizer": null,
              "url": "https://www.cm-lagos.pt/municipio/eventos/16100-exposição-“o-cruzeiro”,-de-timo-dillner",
              "source": "https://www.cm-lagos.pt/municipio/eventos (Camara Municipal de Lagos, events list page)",
              "read_at": "2026-11-18T19:14:42Z",
              "place": "lagos"
             },
             {
              "@type": "Event",
              "name": "CLUBE DA CIÊNCIA",
              "startDate": "2026-10-07",
              "endDate": "2026-12-05",
              "location": {
               "@type": "Place",
               "name": "Centro Ciência Viva de Lagos",
               "address": null,
               "geo": null
              },
              "organizer": null,
              "url": "https://www.cm-lagos.pt/municipio/eventos/16162-clube-da-ciência_16162",
              "source": "https://www.cm-lagos.pt/municipio/eventos (Camara Municipal de Lagos, events list page)",
              "read_at": "2026-11-18T19:14:42Z",
              "place": "lagos"
             },
             {
              "@type": "Event",
              "name": "WORKSHOPS NO ESPAÇO JOVEM – ESCULTURA EM PLÁSTICO",
              "startDate": "2026-10-31",
              "endDate": "2026-11-22",
              "location": {
               "@type": "Place",
               "name": "Espaço Jovem do Município de Lagos – Ateliê de Expressão Plástica (salas 403 e 405)",
               "address": null,
               "geo": null
              },
              "organizer": null,
              "url": "https://www.cm-lagos.pt/municipio/eventos/16149-workshops-no-espaço-jovem-–-escultura-em-plástico",
              "source": "https://www.cm-lagos.pt/municipio/eventos (Camara Municipal de Lagos, events list page)",
              "read_at": "2026-11-18T19:14:42Z",
              "place": "lagos"
             }
            ],
            "faro": [
             {
              "@type": "Event",
              "name": "O Mundo Inteiro à Espera",
              "startDate": "2026-11-21",
              "endDate": null,
              "location": {
               "@type": "Place",
               "name": "Teatro das Figuras",
               "address": null,
               "geo": null
              },
              "organizer": null,
              "url": "https://teatrodasfiguras.pt/agenda/o-mund-inteiro-a-espera",
              "source": "https://teatrodasfiguras.pt/agenda (Teatro das Figuras, Faro, agenda page)",
              "read_at": "2026-11-18T19:14:47Z",
              "place": "faro"
             },
             {
              "@type": "Event",
              "name": "O Principezinho | Um musical para plateia e marionetas",
              "startDate": "2026-11-25",
              "endDate": null,
              "location": {
               "@type": "Place",
               "name": "Teatro das Figuras",
               "address": null,
               "geo": null
              },
              "organizer": null,
              "url": "https://teatrodasfiguras.pt/agenda/o-principezinho",
              "source": "https://teatrodasfiguras.pt/agenda (Teatro das Figuras, Faro, agenda page)",
              "read_at": "2026-11-18T19:14:47Z",
              "place": "faro"
             },
             {
              "@type": "Event",
              "name": "Picota (Este lugar também me pertence)",
              "startDate": "2026-11-26",
              "endDate": null,
              "location": {
               "@type": "Place",
               "name": "Teatro das Figuras",
               "address": null,
               "geo": null
              },
              "organizer": null,
              "url": "https://teatrodasfiguras.pt/agenda/picota-este-lugar-tambem-me-pertence",
              "source": "https://teatrodasfiguras.pt/agenda (Teatro das Figuras, Faro, agenda page)",
              "read_at": "2026-11-18T19:14:47Z",
              "place": "faro"
             }
            ],
            "tavira": [
             {
              "@type": "Event",
              "name": "Dansanté no Teatro | Aula de dança para a saúde e bem estar dos séniores",
              "startDate": "2026-11-18T10:30",
              "endDate": null,
              "location": {
               "@type": "Place",
               "name": "Teatro Municipal António Pinheiro Tavira",
               "address": null,
               "geo": null
              },
              "organizer": null,
              "url": "https://cm-tavira.pt/site/evento/dansante-no-teatro-aula-de-danca-para-a-saude-e-bem-estar-dos-seniores/2026-11-18/",
              "source": "https://cm-tavira.pt/site/evento/ (Camara Municipal de Tavira, Events Calendar route /site/wp-json/tribe/events/v1/events)",
              "read_at": "2026-11-18T19:14:52Z",
              "place": "tavira"
             },
             {
              "@type": "Event",
              "name": "Festival Internacional de Órgão do Algarve 2026 | Visita ao novo órgão, pelo organeiro Dinarte Machado",
              "startDate": "2026-11-20T17:00",
              "endDate": null,
              "location": {
               "@type": "Place",
               "name": "Igreja do Carmo",
               "address": null,
               "geo": null
              },
              "organizer": null,
              "url": "https://cm-tavira.pt/site/evento/festival-internacional-de-orgao-do-algarve-2026-visita-ao-novo-orgao-pelo-organeiro-dinarte-machado/",
              "source": "https://cm-tavira.pt/site/evento/ (Camara Municipal de Tavira, Events Calendar route /site/wp-json/tribe/events/v1/events)",
              "read_at": "2026-11-18T19:14:52Z",
              "place": "tavira"
             },
             {
              "@type": "Event",
              "name": "Encontro com Autores | Apresentação do livro “Comer a Natureza” de Paulo Moreira",
              "startDate": "2026-11-20T18:00",
              "endDate": null,
              "location": {
               "@type": "Place",
               "name": "Biblioteca Municipal Álvaro de Campos",
               "address": null,
               "geo": null
              },
              "organizer": null,
              "url": "https://cm-tavira.pt/site/evento/encontro-com-autores-apresentacao-do-livro-comer-a-natureza-de-paulo-moreira/",
              "source": "https://cm-tavira.pt/site/evento/ (Camara Municipal de Tavira, Events Calendar route /site/wp-json/tribe/events/v1/events)",
              "read_at": "2026-11-18T19:14:52Z",
              "place": "tavira"
             }
            ]
           },
           "gaps": [
            {
             "host": "dados.cm-lisboa.pt",
             "why": "Cloudflare bot check (\"Just a moment...\") on the open data API; its robots.txt also sets Content-Signal ai-train=no, use=reference. Respected, not worked around.",
             "read_at": "2026-11-18T14:00:00Z"
            },
            {
             "host": "www.lisboa.pt",
             "why": "HTTP 403 on its legal and terms pages (aviso-legal, termos-e-condicoes). Respected.",
             "read_at": "2026-11-18T14:00:00Z"
            },
            {
             "host": "visitalgarve.pt, eventos.visitalgarve.pt",
             "why": "eventos.visitalgarve.pt robots.txt allows all (read 18 Nov 2026), but the agenda is an empty JavaScript page (a React app, no server-rendered list, no feed or sitemap found) over a private POST API (api.visitalgarve.pt/website/Travelplanner/Search/Events) whose robots.txt was unreachable and whose t...",
             "read_at": "2026-11-18T18:00:00Z"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/events-pt/reads.json": {
   "get": {
    "operationId": "get_events_pt_reads",
    "tags": [
     "events-pt"
    ],
    "summary": "Events in Portugal, by place: every read, newest first",
    "description": "Every run of sources/events-pt/collect.mjs, newest first: each request's address, HTTP status, size, the first 16 hex of its sha256, and whether the bytes changed since the run before. The bytes and the full sha256 go to the source's vault (see card.json: latest/reads-full.json), never to git.",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "about": {
           "type": "string"
          },
          "source": {
           "type": "string"
          },
          "runs": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "at": {
              "type": "string"
             },
             "finished": {
              "type": "string"
             },
             "ok": {
              "type": "integer"
             },
             "failed": {
              "type": "integer"
             },
             "reads": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "name": {
                 "type": "string"
                },
                "url": {
                 "type": "string",
                 "format": "uri"
                },
                "at": {
                 "type": "string"
                },
                "status": {
                 "type": "integer"
                },
                "bytes": {
                 "type": "integer"
                },
                "sha256_prefix": {
                 "type": "string"
                },
                "changed": {
                 "type": [
                  "boolean",
                  "string"
                 ]
                }
               },
               "required": [
                "name",
                "url",
                "at",
                "status",
                "bytes",
                "sha256_prefix",
                "changed"
               ]
              }
             }
            },
            "required": [
             "at",
             "finished",
             "ok",
             "failed",
             "reads"
            ]
           }
          }
         },
         "required": [
          "about",
          "source",
          "runs"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "about": "Every run of sources/events-pt/collect.mjs, newest first: each request's address, HTTP status, size, the first 16 hex of its sha256, and whether the bytes changed since the run before. The bytes and the full sha256 go to the source's vault (see card.json: latest/reads-full.json), never to git.",
           "source": "events-pt",
           "runs": [
            {
             "at": "2026-11-18T19:14:33Z",
             "finished": "2026-11-18T19:14:57Z",
             "ok": 6,
             "failed": 2,
             "reads": [
              {
               "name": "agendalx-robots",
               "url": "https://www.agendalx.pt/robots.txt",
               "at": "2026-11-18T19:14:35Z",
               "status": 200,
               "bytes": 2676,
               "sha256_prefix": "3073d1e371afb327",
               "changed": false
              },
              {
               "name": "agendalx-events-p1",
               "url": "https://www.agendalx.pt/wp-json/agendalx/v1/events?per_page=50&page=1",
               "at": "2026-11-18T19:14:37Z",
               "status": 403,
               "bytes": 5666,
               "sha256_prefix": "ff58f8396ad24c8d",
               "changed": true
              },
              {
               "name": "lagos-robots",
               "url": "https://www.cm-lagos.pt/robots.txt",
               "at": "2026-11-18T19:14:40Z",
               "status": 200,
               "bytes": 285,
               "sha256_prefix": "848b423d72457bb6",
               "changed": false
              }
             ]
            },
            {
             "at": "2026-11-18T19:10:07Z",
             "finished": "2026-11-18T19:10:31Z",
             "ok": 6,
             "failed": 2,
             "reads": [
              {
               "name": "agendalx-robots",
               "url": "https://www.agendalx.pt/robots.txt",
               "at": "2026-11-18T19:10:09Z",
               "status": 200,
               "bytes": 2676,
               "sha256_prefix": "3073d1e371afb327",
               "changed": false
              },
              {
               "name": "agendalx-events-p1",
               "url": "https://www.agendalx.pt/wp-json/agendalx/v1/events?per_page=50&page=1",
               "at": "2026-11-18T19:10:11Z",
               "status": 403,
               "bytes": 5645,
               "sha256_prefix": "6df6a7b2689533f5",
               "changed": true
              },
              {
               "name": "lagos-robots",
               "url": "https://www.cm-lagos.pt/robots.txt",
               "at": "2026-11-18T19:10:14Z",
               "status": 200,
               "bytes": 285,
               "sha256_prefix": "848b423d72457bb6",
               "changed": false
              }
             ]
            },
            {
             "at": "2026-11-18T19:06:34Z",
             "finished": "2026-11-18T19:06:59Z",
             "ok": 6,
             "failed": 2,
             "reads": [
              {
               "name": "agendalx-robots",
               "url": "https://www.agendalx.pt/robots.txt",
               "at": "2026-11-18T19:06:36Z",
               "status": 200,
               "bytes": 2676,
               "sha256_prefix": "3073d1e371afb327",
               "changed": false
              },
              {
               "name": "agendalx-events-p1",
               "url": "https://www.agendalx.pt/wp-json/agendalx/v1/events?per_page=50&page=1",
               "at": "2026-11-18T19:06:39Z",
               "status": 403,
               "bytes": 5666,
               "sha256_prefix": "fad1f4c12b3a4510",
               "changed": true
              },
              {
               "name": "lagos-robots",
               "url": "https://www.cm-lagos.pt/robots.txt",
               "at": "2026-11-18T19:06:41Z",
               "status": 200,
               "bytes": 285,
               "sha256_prefix": "848b423d72457bb6",
               "changed": false
              }
             ]
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/events-pt/card.json": {
   "get": {
    "operationId": "get_events_pt_card",
    "tags": [
     "events-pt"
    ],
    "summary": "Events in Portugal, by place: the card",
    "description": "Who publishes the source, its reuse terms, the schedule, who owns it, what runs by code, by agents and by people, and the vault.",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "title": {
           "type": "string"
          },
          "what": {
           "type": "string"
          },
          "publisher": {
           "type": "string"
          },
          "owner": {
           "type": "string"
          },
          "collector": {
           "type": "string"
          },
          "source_home": {
           "type": "string"
          },
          "reader_page": {
           "type": "string"
          },
          "schedule": {
           "type": "object",
           "properties": {
            "cadence": {
             "type": "string"
            },
            "how": {
             "type": "string"
            }
           },
           "required": [
            "cadence",
            "how"
           ]
          },
          "terms": {
           "type": "object",
           "properties": {
            "summary": {
             "type": "string"
            },
            "page": {
             "type": "string"
            },
            "read_at": {
             "type": "string"
            },
            "quote": {
             "type": "string"
            },
            "quote_lang": {
             "type": "string"
            },
            "republish": {
             "type": "string"
            },
            "open_question": {
             "type": "string"
            }
           },
           "required": [
            "summary",
            "page",
            "read_at",
            "quote",
            "quote_lang",
            "republish",
            "open_question"
           ]
          },
          "api": {
           "type": "object",
           "properties": {
            "latest": {
             "type": "string"
            },
            "reads": {
             "type": "string"
            },
            "card": {
             "type": "string"
            },
            "openapi": {
             "type": "string"
            },
            "page": {
             "type": "string"
            }
           },
           "required": [
            "latest",
            "reads",
            "card",
            "openapi",
            "page"
           ]
          },
          "vault": {
           "type": "null"
          },
          "split": {
           "type": "object",
           "properties": {
            "code": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "agents": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "people": {
             "type": "array",
             "items": {
              "type": "string"
             }
            }
           },
           "required": [
            "code",
            "agents",
            "people"
           ]
          },
          "cost": {
           "type": "object",
           "properties": {
            "per_run_tokens": {
             "type": "integer"
            },
            "per_run_model_cost_usd": {
             "type": "integer"
            },
            "runner": {
             "type": "string"
            },
            "build_tokens": {
             "type": "string"
            },
            "note": {
             "type": "string"
            }
           },
           "required": [
            "per_run_tokens",
            "per_run_model_cost_usd",
            "runner",
            "build_tokens",
            "note"
           ]
          },
          "since": {
           "type": "string"
          }
         },
         "required": [
          "id",
          "title",
          "what",
          "publisher",
          "owner",
          "collector",
          "source_home",
          "reader_page",
          "schedule",
          "terms",
          "api",
          "vault",
          "split",
          "cost",
          "since"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "id": "events-pt",
           "title": "Events in Portugal, by place",
           "what": "Public events on now or in the next 60 days in Lisbon and the Algarve places, as schema.org Event records, each with its source URL and the time read.",
           "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)",
           "owner": "data.b@PrompTugal.dinis",
           "collector": "sources/events-pt/collect.mjs",
           "source_home": "https://www.agendalx.pt/wp-json/agendalx/v1/events",
           "reader_page": "https://www.agendalx.pt/",
           "schedule": {
            "cadence": "every 6 hours",
            "how": "the Pages workflow (.github/workflows/pages.yml) at 17 minutes past 00, 06, 12 and 18 UTC (the agendas change daily); every other hourly run keeps the last read, copied from the live site"
           },
           "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 Co...",
            "page": "https://www.agendalx.pt/robots.txt",
            "read_at": "2026-11-18",
            "quote": "User-agent: * Content-Signal: search=yes,ai-train=no,use=reference Allow: /",
            "quote_lang": "en",
            "republish": "unclear: no licence found; reference use with attribution and a link to each event's page",
            "open_question": "No reuse terms were found on agendalx.pt, lisboa.pt (403), cm-lagos.pt, teatrodasfiguras.pt or cm-tavira.pt. Dinis to decide whether to republish on this basis, or to ask the four publishers (Câmara Municipal de Lisboa, Câmara Municipal de Lagos, Teatro das Figuras, Câmara Municipal de Tavira). The ..."
           },
           "api": {
            "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": null,
           "split": {
            "code": [
             "the collector reads robots.txt, then the agenda route or page, and writes latest.json and reads.json",
             "collect/events-by-place.mjs derives data/events/by-place/<place>.json from latest.json",
             "GitHub Actions runs it every hour and deploys the site"
            ],
            "agents": [
             "data.b.collector@PrompTugal.dinis (Sonnet) researched the sources and wrote the collector and this card on 18 November 2026, for data.b@PrompTugal.dinis"
            ],
            "people": [
             "Dinis Cruz decided the events collection on 18 November 2026; no person has checked the values yet (not reviewed)"
            ]
           },
           "cost": {
            "per_run_tokens": 0,
            "per_run_model_cost_usd": 0,
            "runner": "GitHub Actions on a public repository: no charge; about 12 requests and 30 seconds a run (measured locally, 18 November 2026)",
            "build_tokens": "not measured",
            "note": "Code only: no model is called when the data is collected."
           },
           "since": "2026-11-18"
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/events-pt/openapi.json": {
   "get": {
    "operationId": "get_events_pt_openapi",
    "tags": [
     "events-pt"
    ],
    "summary": "Events in Portugal, by place: this document",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  }
 },
 "tags": [
  {
   "name": "events-pt",
   "description": "Public events on now or in the next 60 days in Lisbon and the Algarve places, as schema.org Event records, each with its source URL and the time read."
  }
 ],
 "x-source": {
  "id": "events-pt",
  "card": "https://data.promptugal.news/api/v1/events-pt/card.json",
  "page": "https://data.promptugal.news/sources/events-pt/"
 }
}
