API pre vývojárov

Program podujatí z Pútač.sk môžete zdarma použiť vo svojej aplikácii, na webe mesta alebo v informačnom kiosku. Kľúč netreba. Odpovede sú v JSON, dajú sa volať priamo z prehliadača (CORS) a obnovujú sa každých 5 minút.

Podmienka: pri každom podujatí uveďte zdroj Pútač.sk s odkazom na jeho stránku (pole url).

Podujatia

GET https://putac.sk/api/v1/events/?city=presov&category=koncert&from=2026-10-01&to=2026-10-31

Parametre (všetky nepovinné):

city: mesto, napríklad poprad, alebo viac miest oddelených čiarkou, napríklad presov,sabinov,bardejov (zoznam je na /api/v1/cities/)
category: kategória, napríklad divadlo (zoznam je na /api/v1/categories/)
from, to: rozsah dátumov vo formáte RRRR-MM-DD. Bez nich dostanete všetky nadchádzajúce podujatia.
q: hľadaný text (diakritika nie je potrebná)
free=1: len podujatia zadarmo
page, per_page: stránkovanie, najviac 100 na stranu

Každé podujatie je v zozname iba raz, a to s najbližším termínom. Všetky termíny vráti detail:

GET https://putac.sk/api/v1/events/123/

Príklad odpovede

{
  "count": 42,
  "next": "https://putac.sk/api/v1/events/?city=presov&page=2",
  "results": [{
    "id": 123, "title": "Jesenný jarmok", "url": "https://putac.sk/podujatie/jesenny-jarmok-123/",
    "start": "2026-10-17T09:00:00+02:00", "end": null, "status": "scheduled",
    "category": {"slug": "trhy", "name": "Trhy"}, "city": {"slug": "presov", "name": "Prešov"},
    "venue": {"name": "Hlavná ulica", "address": "", "url": "…"}, "location": {"lat": 49.0, "lng": 21.24},
    "is_free": true, "price": null, "tickets_url": null, "image": "…", "ical": "…"
  }],
  "attribution": "Zdroj: Pútač.sk – …"
}

Nepotrebujete API? Stačí widget alebo iCal feed mesta (https://putac.sk/presov/kalendar.ics).