Levar a agenda

Não é preciso chave nem registo. Os endereços abaixo respondem a qualquer pedido, de qualquer origem — e são para quem quer montar a lista com o seu próprio desenho. Quem só procura uma caixa pronta para colar não precisa de escrever código nenhum: está aqui em cima.

Endereços globais

https://mediotejo.coreto.org/feed.xml

RSS 2.0 com os próximos 50 eventos dos 11 concelhos.

https://mediotejo.coreto.org/agenda.ics

Calendário iCalendar com os próximos 100 eventos. Para subscrever, não para descarregar uma vez.

https://mediotejo.coreto.org/api/events

A agenda em JSON, com filtros. É a base do widget e de qualquer integração.

https://mediotejo.coreto.org/dados.json

O catálogo de uma vez, sem paginar, com a data de geração, a contagem e a licença dentro do próprio ficheiro. É o que se anexa a um processo em vez de explicar o que é uma API.

https://mediotejo.coreto.org/dados.csv

O mesmo, para quem abre folhas de cálculo. Com BOM, ponto e vírgula e os metadados em linhas «#» à cabeça, que o Excel e o LibreOffice saltam.

https://mediotejo.coreto.org/sitemap.xml

Mapa do sítio: as páginas fixas, os 11 concelhos, os espaços, os ciclos com programação e os eventos por acontecer. O que já passou não entra — um mapa do sítio é para o que se pode visitar.

Por concelho

Cada concelho tem os seus dois endereços. O padrão é /feed/<concelho>.xml e /agenda/<concelho>.ics.

Cada evento tem também o seu próprio calendário, em /evento/<endereço>/agenda.ics — é o botão «adicionar ao calendário» da ficha.

A API em JSON

GET /api/events devolve { events, total, page, limit, license, attribution, documentation }. Aceita pedidos de qualquer origem (CORS aberto) e responde sempre em UTF-8. Um parâmetro inválido devolve 400 com a lista dos parâmetros aceites dentro da própria resposta.

Cada evento traz as colunas do cartão e, ao lado dos identificadores, o que eles querem dizer: municipality_name, category_name, venue_name, o updated_at e as sessions com data, hora de início e hora de fim. Sem isso, quem integra ficava com venue_id e sem forma de saber de que espaço se trata.

https://mediotejo.coreto.org/api/events?municipality=tomar&limit=10

{
  "events": [
    {
      "id": "…",
      "slug": "…",
      "title": "…",
      "municipality_id": "tomar",
      "venue_id": "…",
      "location_name": null,
      "category_slug": "musica",
      "category_confidence": 0.95,
      "category_source": "alias",
      "date_start": "2027-01-01",
      "date_end": "2027-01-01",
      "is_ongoing": false,
      "is_free": true,
      "price_display": null,
      "image_url": "…",
      "image_alt": "…",
      "series_id": null,
      "image_miniatura": "…",
      "image_width": 600,
      "image_height": 848,
      "wheelchair_accessible": true,
      "has_sign_language": false,
      "has_audio_description": false,
      "has_subtitles": false,
      "is_relaxed_performance": false,
      "audience": "all_ages",
      "url": "https://mediotejo.coreto.org/evento/…",
      "municipality_name": "Tomar",
      "category_name": "Música",
      "venue_name": "…",
      "updated_at": "2026-12-20T03:12:44.000Z",
      "sessions": [{ "date": "2027-01-01", "start_time": "21:30", "end_time": null }]
    }
  ],
  "total": 37,
  "page": 1,
  "limit": 10
}

Sem nos deitar abaixo

• Os feeds são recalculados de hora a hora. Ir buscá-los mais vezes do que isso não traz nada de novo.
• Não há limite publicado nem chaves a distribuir. Há bom senso: um pedido por minuto por feed é muito mais do que suficiente.
• Identifique-se no User-Agent com um nome e um contacto. É o que nos deixa avisar em vez de bloquear.
• Precisa da exportação completa e não de uma janela dos próximos eventos? Escreva — é mais barato para os dois lados do que percorrer a paginação toda.

Licença