Open data

Otevřená data o kulturních akcích v Roudnici nad Labem — volně k použití pro vývojáře, novináře, obecní weby i mobilní aplikace.

Endpointy pro distribuci našich kulturních akcí — můžete je libovolně používat na vlastních webech, v aplikacích nebo kalendářích, pokud uvedete zdroj. Data jsou aktualizována v reálném čase z naší databáze.

RSS 2.0 feed

Standardní RSS feed s nadcházejícími akcemi. Vhodný pro RSS čtečky, newsletter aggregátory, IFTTT/Zapier automatizaci nebo embed na vlastním webu. Obsahuje název, datum, místo, popis, štítky a obrázek.

https://www.kulturaroudnice.cz/akce.rss

Alias: /api/akce.rss

JSON API

Strukturovaná data o nadcházejících akcích pro vývojáře — název, datum, místo, vstupné, štítky, plakát, popis, organizátor. Plně CORS-enabled (volání z prohlížeče funguje).

https://www.kulturaroudnice.cz/api/akce
  • ?limit=50&offset=0 — pagination (max 500)
  • ?tag=koncerty — filtr podle SEO štítku
  • ?venue=kulturni-dum-rip — filtr podle SEO místa
  • ?from=2026-07-01&to=2026-08-31 — časový rozsah

Alias: /api/akce.json

Struktura odpovědi (JSON)

Endpoint /api/akce vrací JSON ve tvaru { meta, events }. Význam jednotlivých klíčů:

meta informace o odpovědi
  • total — celkový počet akcí splňujících filtr
  • limit — max. v této odpovědi (1–500)
  • offset — pozice začátku stránky
  • returned — počet skutečně vrácených
  • date_from, date_to — časový rozsah
  • license, license_url — licenční podmínky
  • attribution — text pro uvedení zdroje
  • generated — datum a čas vygenerování (ISO 8601)
events[] pole jednotlivých akcí
  • id — interní identifikátor akce
  • title — název akce
  • description — popis (plain-text)
  • start_at — začátek (YYYY-MM-DD HH:MM:SS)
  • end_at — konec (může být null)
  • venue — místo: { id, name, seo, street_address, city, zip }
  • organizer — pořadatel: { id, name }
  • entry — vstupné: { price, surcharge, text, currency }
  • presale_start — začátek předprodeje (může být null)
  • tags — pole štítků: [{ id, name, seo }]
  • cover_url — URL plakátu/cover obrázku
  • url — odkaz na detail akce na webu

Ukázka použití — PHP

// Stáhnout a dekódovat JSON
$url  = 'https://www.kulturaroudnice.cz/api/akce?tag=divadlo&limit=5';
$json = file_get_contents($url);
$data = json_decode($json, true);

foreach ($data['events'] as $ev) {
    echo $ev['title']
       . ' @ ' . $ev['venue']['name']
       . ' (' . $ev['start_at'] . ")\n";
}

Ukázka použití — JavaScript

// Načíst akce s filtrem a vypsat do konzole
fetch('https://www.kulturaroudnice.cz/api/akce?tag=divadlo&limit=5')
  .then(r => r.json())
  .then(data => {
    data.events.forEach(ev => {
      console.log(
        ev.title +
        ' @ ' + ev.venue.name +
        ' (' + ev.start_at + ')'
      );
    });
  });

Licence: CC BY-NC 4.0

Data jsou poskytována pod licencí Creative Commons Uveďte původ – Neužívejte komerčně 4.0 Mezinárodní. Můžete je volně používat, sdílet a upravovat pro nekomerční účely — stačí uvést zdroj.

Uvedení zdroje: KulturaRoudnice.cz + odkaz na detail akce (URL url v každém záznamu).

Pro komerční využití (placené aplikace, reklama, prodej dat) je vyžadována samostatná dohoda — kontaktujte info@kulturaroudnice.cz.

Informace pro vývojáře