Townbase API

Townbase API är ett REST-API som ger utvecklare och organisationer programmatisk tillgång till strukturerad, kurerad lokal evenemangs- och innehållsdata. Det låter dig bädda in live-evenemangflöden, sökning och discovery-funktioner i vilken app, webbplats eller digital tjänst som helst.

API:et är utformat för två målgrupper: utvecklare som vill bygga in lokala discovery-funktioner i sina produkter, och organisationer såsom kommuner, turistbyråer, DMO:er och mediegrupper som vill distribuera sitt innehåll bortom sina egna webbplatser och tjänster.

Kontakta Townbase för att begära en API-nyckel. När du har din nyckel kan du börja göra förfrågningar till alla publika endpoints. Du behöver signera ett avtal innan du får nyckeln.

Ja – en test-API-nyckel finns tillgänglig för utvecklings- och teständamål. Kontakta oss för att begära en.

En grundläggande integration – som att bädda in ett evenemangflöde på en befintlig webbplats – kan vara igång på några timmar. En fullständig skräddarsydd discovery-upplevelse tar vanligtvis några dagar till några veckor beroende på omfattning.

API:et är utvecklarorienterat, men din organisation behöver inte ha en intern utvecklare för att dra nytta av det. Townbase arbetar med ett nätverk av integrationspartners och många vanliga användningsfall har färdiga lösningar.

Det gör du. API:et exponerar bara det innehåll som är publicerat och godkänt på din Townbase-deployment. Du behåller full redaktionell kontroll hela tiden.

Ändringar återspeglas i API:et i realtid. När du publicerar, redigerar eller tar bort innehåll på din Townbase-plattform uppdateras API-flödet automatiskt – ingen manuell synkronisering krävs.

Det beror på licensavtalet. Townbase tillhandahåller den tekniska infrastrukturen och de kommersiella användningsvillkoren för ditt innehåll, men du bestämmer alltid vad som publiceras.

API-åtkomst är tillgänglig som en del av utvalda Townbase-planer. Kontakta oss för att bekräfta vad som ingår i ditt nuvarande avtal.

API-nycklar utfärdas per integration, vilket ger dig insyn i vem som har tillgång till ditt innehållsflöde. Användningsrapportering finns tillgänglig via din Townbase-dashboard.

Ja. API:et låter utvecklare bädda in ditt innehåll i appar, plattformar och tjänster som redan har etablerade målgrupper – hotellkoncierg-appar, nyhetssajter, regionala turismportaler, digital skyltning och mer – utan något extra arbete från din sida.

Townbase driver stadsguide-, lokal guide-, evenemangs- och aktivitetsguide-plattformar för kommuner, medier och andra organisationer som universitet i Finland, Sverige och Storbritannien. För närvarande har mer än 50 000 organisationer registrerat sig för att skapa innehåll. Tammerfors stad (tapahtumat.tampere.fi) är ett offentligt tillgängligt exempel på en Townbase-driven deployment.

Alla API-svar är i JSON-format.

Autentisering hanteras via en API-nyckel. Inkludera din nyckel i förfrågningshuvudet eller som en frågeparameter enligt API-dokumentationen.

Ja, hastighetsbegränsningar gäller för att förhindra missbruk och säkerställa tillförlitlighet för alla användare. Detaljer tillhandahålls med dina API-licensvillkor och är alltid förhandlingsbara.

Ja, innehållet uppdateras i realtid. Så snart en utgivare uppdaterar ett evenemang på plattformen återspeglas förändringen omedelbart i API-svaret.

Ett typiskt objekt inkluderar titel, beskrivning, datum och tider, plats (long/lat), adress, kategorier, taggar, målgrupper, bilder, arrangörsinformation och språkvarianter där sådana finns.

Endpointen /api/public/search stöder datumintervallfiltrering, vilket gör att du kan fråga enbart framtida evenemang.

Ja. Sök-endpointen stöder kombinationer av filter som kategori, område, tagg, målgrupp och datumintervall i en enda förfrågan.

Site/*-endpunkterna – som täcker områden, kategorier, taggar, språk, målgrupper och arrangörssamlingar – exponerar hela taxonomin för en deployment. Det låter dig bygga helt dynamiska gränssnitt som inte kräver hårdkodade värden och anpassar sig automatiskt när plattformens innehåll förändras.

För närvarande är API:et enbart REST-baserat utan officiellt SDK. Det är kompatibelt med vilket språk eller ramverk som helst som kan göra HTTP-förfrågningar.

Webhooks är för närvarande inte tillgängliga. För realtidsuppdateringar rekommenderar vi att du pollar relevanta endpoints med ett lämpligt intervall för ditt användningsfall.

Fel returneras som JSON med ett error_type- och error_message-fält, vilket gör dem enkla att hantera programmatiskt.

Ja. Icke bakåtkompatibla ändringar introduceras alltid under en ny version, och befintliga versioner stöds med förvarning om avveckling.

Fullständig dokumentation inklusive endpunktreferenser, parametrar och exempelsvar finns tillgänglig på /api/docs/.

API:et exponerar evenemang, aktiviteter och lokala innehållsobjekt – inklusive kulturevenemang, sport, samhällsaktiviteter, utställningar, konserter med mera, samt platser som arenor, restauranger, hotell osv – beroende på vad som är publicerat på varje deployment.

Ja. Endpointen /api/public/site/languages returnerar tillgängliga språk för en given deployment, och innehållsobjekt inkluderar språkvarianter där utgivaren har tillhandahållit sådana. För mer avancerade användningsfall erbjuder Townbase dynamiska översättningar.

Ja. Endpointen /api/public/site/targets returnerar alla tillgängliga målgruppssegment för en deployment, och dessa kan användas som filter i sök- och innehållsfrågor.

Ja. Endpointen /api/public/site/areas returnerar alla definierade geografiska områden (geoJSON polygonrutor) för en deployment, vilka kan användas för att filtrera innehåll efter plats.

Både tidigare och kommande innehåll är tillgängligt via API:et. Datumintervallparametrar i sök-endpointen ger dig full kontroll över det tidsfönster du frågar mot. Åtkomst till historiska evenemang kräver att ytterligare parametrar aktiveras.

Vanliga integrationer inkluderar stads- och kommunappar, turism- och destinationsportaler, hotellkoncierg- och hospitality-appar, regionala nyhets- och mediesajter med automatiserade evenemanglistor, digital skyltning och publika skärmar, AI-assistenter och chattbotar med lokal evenemangsmedvetenhet, samt kalenderapplikationer berikade med lokalt innehåll som aktivitets- och hobbyguider. Om vi saknar en viktig kontaktpunkt är vi glada att ta en titt på att lägga till den i vår partnerlista.

Ja. Endpointen /api/public/content-by-host returnerar en strukturerad lista med allt publicerat innehåll för en given deployment, vilket gör det enkelt att rendera ett live-evenemangflöde på vilken webbplats eller app som helst.

Ja. API:et är utformat för att stödja helt anpassade frontend-upplevelser. All taxonomidata – kategorier, områden, taggar, målgrupper – finns tillgänglig dynamiskt via site/*-endpunkterna, så ditt gränssnitt kan återspegla plattformens innehåll utan någon hårdkodning.

Ja. De strukturerade JSON-svaren och sökfunktionerna gör Townbase API väl lämpat för att driva AI-assistenter, röstgränssnitt och chattbotar som behöver svara på frågor om lokala evenemang och aktiviteter. Vissa kunder använder det för röstassistenter av tillgänglighetsskäl, andra vill erbjuda en lokal guide via ett agentbaserat gränssnitt. Be om exempel.