Is Townbase a single product or a platform?

Townbase is a platform — a suite of products built on shared infrastructure. You can use a single component like a widget or API, or deploy a full white-label city guide. Most customers start with one product and expand over time.

Do I need a developer to get started?

Not necessarily. A full branded city guide can be up and running in around two days with no development work. If you want to build custom experiences using our API or embed widgets into an existing site, a developer will be useful — but the barrier is low.

Is this only for cities and municipalities?

No. Cities and municipalities are a core customer segment, but Townbase powers event discovery for media organisations, tourism boards, destination marketing organisations, regional portals, and businesses of all sizes. If your audience needs to find out what's happening locally, Townbase is built for you.

How is Townbase different from Eventbrite or Facebook Events?

Eventbrite and Facebook Events are tools for individual event organisers. Townbase is infrastructure for the organisations that aggregate, curate and publish local content at scale — cities, media houses, and platforms. We don't sell tickets and we don't compete with your existing ticketing provider. We make your entire local event ecosystem discoverable in one place, under your brand.

Can I use just the API, or do I have to take the full platform?

You can use just the API. Or just a widget. Or just a branded guide. Townbase is modular by design — you take what fits your use case and can add more as your needs grow.

Is Townbase GDPR-compliant and EU-hosted?

Yes. Townbase is built and operated in Northern Europe, data is stored within the EU, and the platform is designed to be GDPR-compliant by default. For public sector and municipal customers, this is a core requirement — not an afterthought.

How quickly can we get started?

A branded event guide can be live in approximately two days. Widget integrations can be done in under an hour. API access is available immediately upon request. There are no lengthy procurement cycles or heavy implementation projects.

Townbase API-alusta

Paikallinen sisältö-API, joka muuttaa kuluttajapalvelumme kaupunki-infrastruktuuriksi

Yhdestä sisältölähteestä kaikkiin kaupungin näyttöihin.

Ota yhteyttä ja aloita

Close-up of hands typing on a laptop displaying code, with a coffee mug in the background.

Kaikki mitä tarvitset paikallisen löytämiskokemuksen rakentamiseen — yhdessä API:ssa

Close-up of hands typing on a laptop displaying code.

Kehittäjille

Ohita screippaus ja datan siivous. Saat jäsenneltystä datastamme kuratoituja tapahtuma paikka ja aktiviteettilistauksia kotisivullesi. Käytä kategorioita, aihetunnisteita, alueita ja kohderyhmiä; saat alati päivittyvät sisältölistaukset, jotka ovat aina ajan tasalla. API tarjoaa sisällöt myös monikielisinä. Käytä samaa rajapintaa web-sivustoihin, sovelluksiin, digitaalisiin näyttöihin, tekoälyavusteisiin chat-botteihin, hotellipalveluihin tai kalenteri-widgetteihin.

Three business professionals discussing on a laptop during a meeting in a modern office setting.

Kaupungeille, matkailualueille, brändeille ja medialle

Sisältösi muuttuu infrastruktuuriksi. Julkaise kerran - tehosta kaiken löytämistä yhdestä paikasta. Kumppanit ja kehittäjät voivat rakentaa datasi pohjalle ilman lisätyötä sinulta. Taksonomiasi — alueet, kategoriat, kohderyhmit — on saatavilla live-API:n avulla. Voit unohtaa staattiset listat ja viennit ja noudot. Sisällöntuottajiesi työ on uudelleenkäytettävissä niin sinulle kuin kumppaneillesi kolmansien osapuolten verkkosivustoille, sovelluksiin, digitaalisiin opastekarttoihin kuin tekoälyavustesiin sovelluksiin.

Townbase API kehittäjille

Unohda screippaus ja datan siivous — saat jäsenneltyä ja kuratoitua sisältöä valmiiksi liitettäväksi palveluusi ja tuotteeseesi
Käytä kategorioita, tunnisteita, alueita ja kohderyhmiä sivustojen end-pointteja ja käyttöliittymäsi päivittyy automaattisesti itse sisältämassan kasvaessa
Hae tapahtumalistauksia johtavilta alustoilta, valitse haluamasi syötteet ja pidä omat palveusi ajan tasalla rikkailla aina päivitetyillä sisällöillä
Sovita omaan muotoiluusi (CSS), asenna omaan verkkotunnukseesi ja tyyliisi samalla kun Townbase hoitaa sisältökerroksen kulissien takana
Tavoita oikeat kohderyhmit moniportaisten suodatinvalintojen avulla ja voit seurata sitoutumistrendejä, koontien ja viikoittaisten tilannekatsausten avulla
Monikielinen valmiiksi — Kun saat sisällöt host-ID:n mukaan rajattuna, yksi integrointi toimii kaikkien Townbase-palvelujen kanssa saumattomasti yhteen yhdellä rajapintaratkaisulla.
Käytä sovelluksia, digitaalisia näyttöjä, AI-assistentteja, botteja ja kalenteri-widgettejä yhdellä integraatiolla

A close-up of hands typing code on a laptop with a coffee mug in the background, indicating a workspace setting.

Miten pääsen alkuun?

Kenelle Townbase Discovery API on suunniteltu?

API on suunniteltu kahdelle pää-kohderyhmälle: kehittäjille, jotka haluavat sisällyttää paikallisen löytämisen ja paikalliset sisällö tuotteisiinsa, sekä organisaatioille kuten kunnille, matkailulaualueille (DMO), brändeille ja medioille, jotka haluavat hyödyksikäyttää olemassa olevia sisältöjä ja jakaa sisältöjä omiin tai yhteistyökumppaneiden tai asiakkaidensa verkkosivustoille.

Miten saan API:n käyttööni?

Ota yhteyttä Townbasen asiakaspalveluun. Kun sinulla on avain, voit alkaa tehdä hakuja valitsemiisi sivustoihin. Sinun täytyy allekirjoittaa myös käyttöehdot ennen avaimen saamista.

Onko API:sta saatavilla sandbox- tai testiympäristöä?

Kyllä — testaus-API-avain on saatavilla kehitys- ja testauskäyttöön. Ota yhteyttä asiakaspalveluumme.

Kuinka kauan integrointi tyypillisesti kestää?

Perustason integrointi, kuten tapahtumasyötteen upottaminen olemassa olevalle verkkosivustolle, voi olla toiminnassa muutamassa tunnissa. Täysin räätälöity kuluttajakokemus kestää tyypillisesti muutamasta päivästä muutamaan viikkoon riippuen riippuen toteutuksen laajuudesta.

Kaupungeille ja organisaatioille

Tarvitsenko kehittäjän API:n käyttöön?

API on luotu kehittäjille, mutta organisaatiosi ei tarvitse omaa kehittäjää hyötyäkseen siitä. Townbase työskentelee integraatiokumppaneiden verkoston kanssa, ja monille yleisille käyttötapauksille voi löytyä jo valmiita ratkaisuja.

Kuka hallitsee mitä sisältöä API:n kautta näytetään?

Sinä päätät. API tarjoaa vain sisällön, joka on julkaistu ja hyväksytty Townbase-palvelussasi tai valitsemasi asiakkaamme palvelussa. Pidät täyden toimituksellisen hallinnan kaikissa aikoina kun käytössäsi on myös Townbase portaaliratkaisu.

Mitä tapahtuu API-syötteelle jos päivitän sisältöä alustalla?

Muutokset heijastuvat API:ssa reaaliajassa. Kun julkaiset, muokkaat tai poistat sisältöä Townbase-portaaliratkaisussasi, API-syöte päivittyy automaattisesti ilman manuaalista synkronointitarvetta.

Voiko API auttaa tavoittamaan yleisöjä joita en vielä palvele?

Kyllä. API mahdollistaa sisältösi upottamisen sovelluksiin, alustoihin ja palveluihin, joilla on jo vakiintuneita yleisojä — hotellien concierge-sovelluksiin, uutissivustoihin, alueellisiin matkailuportaaleihin, digitaalisiin näyttöihin ja muuhun — ilman lisätyötä sinulta.

Millaiset kaupungit ja organisaatiot käyttävät API:a?

Townbase tarjoaa kaupunkiopas-, tapahtuma- ja aktiviteettikalentereita kunnille, medialle ja yliopistoille Suomessa, Ruotsissa ja Iso-Britanniassa. Tällä hetkellä yli 50 000 organisaatiota on rekisteröitynyt luomaan sisältöä. Tampereen kaupunki (tapahtumat.tampere.fi) on yksi julkisesti saatavilla oleva esimerkki.

Kehittäjille

Missä muodossa API palauttaa dataa?

API tarjoaa datan JSON-muodossa.

Miten pyynnöt todennetaan?

Autentikointi tapahtuu GET kyselyparametriin sisällytetyn API-avaimen avulla, kuten API-dokumentaatiossa on määritelty.

Sisältyykö API:n käyttöön nopeusrajoituksia?

Kyllä, nopeusrajoitukset ovatasetettu väärinkäytösten estämiseksi ja luotettavuuden varmistamiseksi. Tiedot annetaan API-lisenssiehtojesi yhteydessä ja ovat aina neuvoteltavissa.

Kuinka usein sisältö päivittyy — onko se reaaliaikaista?

Kyllä, sisältö päivittyy reaaliajassa. Heti kun julkaisija päivittää tapahtuman alustalla, muutos heijastuu välittömästi API-rajapinnassa.

Mitä tyypillinen kohdevastaus sisältää?

Tyypillinen kohde sisältää mm. otsikon, kuvauksen, päivämäärät ja ajat, sijainnin (pituus-/leveysaste), osoitteen, kategoriat, tunnisteet, kohderyhmätiedot, kuvat, järjestäjätiedot ja kieliversioinnin.

Voinko yhdistää useita suodattimia hakukyselyyy?

Kyllä. Hakupäätepiste tukee useiden suodatinten, kuten kategoria, alue, tunniste, kohderyhemä ja aika-alue, yhdistämistä yhdessä pyynnossa.

Tukeeko API webhookeja?

Webhookit eivät ole tällä hetkellä saatavilla. Reaaliaikaisiin päivityksiin suosittelemme asianmukaisia end-pointteja käyttötapauksellesi sopivalla tavalla.

Onko API versioitu?

Kyllä. Uudet muutokset otetaan aina käyttöön uuden version alla, ja olemassa olevia versioita tuetaan tietyn aikaa päivitysten jälkeen.

Missä voin löytää täydelliset API-dokumentit?

Täydellinen dokumentaatio, mukaan lukien end-point viittaukset, parametrit ja esimerkkivastaukset, ovat saatavilla API alustan dokumentaatiosivulta.

Käyttötapaukset

Mitä kehittäjät voivat rakentaa Townbase API:lla?

Yleisiä integrointeja ovat kaupunki- ja kuntasovellukset, matkailu- ja kohdeportaalit, hotellien concierge- ja hospitality-sovellukset, alueelliset uutis- ja mediasivustot automaattisilla tapahtumaluetteloilla, digitaaliset näytöt ja julkiset näytöt, AI-assistentit ja chatbotit paikallisen tapahtumantietoisuuden kanssa, sekä kalenterisovellukset rikastettuna paikallisella sisällöllä. Jos meiltä puuttuu tärkeä lähde, harkitsemme aina mielellämme sen lisäämistä kumppanilistallemme.

Voinko upottaa live-tapahtumasyötteen suoraan verkkosivustolleni?

Kyllä. /api/public/content-by-host end-point palauttaa jäsennellyn listan kaikesta julkaistusta sisällöstä, mikä helpottaa live-tapahtumasyötteen renderöintiä verkkosivustolla tai sovelluksessa.

Voinko rakentaa täysin brändätyn mukautetun tapahtumaoppaan API:n avulla?

Kyllä. API on suunniteltu tukemaan täysin mukautettuja front-end-kokemuksia. Kaikki taksonomia-data — kategoriat, alueet, tunnisteet, kohderyhmit — on saatavilla dynaamisesti site/* päätepisteiden kautta, joten käyttöliittymäsi voi heijastaa alustan sisältöä ilman kovakoodausta.

Sopiiko API AI- ja chatbot-integrointeihin?

Kyllä. Jäsennellyt JSON-vastaukset ja hakuominaisuudet tekevät Townbase API:sta hyvin soveltuvat AI-assistenttien, ääni- käyttöliittymien ja chatbottien tukemiseen kun niiden tulisi kyetä vastaamaan kysymyksiin paikoista, tapahtumista ja aktiviteeteista.

Valmis rakentamaan paikallisella tapahtumadatalla?

Ota yhteyttä saadaksesi API-avaimesi ja aloita rakentaminen tunneissa, ei viikoissa.

Ota yhteyttä Varaa tapaaminen