Eventfrog-API: Schnittstellen für deine eigene Software nutzen
Mit der Eventfrog-API kannst du Eventfrog mit deinen eigenen Systemen verbinden, zum Beispiel mit deiner Vereinssoftware, einem CMS, einem CRM oder einer individuellen Branchenlösung.
So lassen sich Eventdaten, Ticketverkäufe und Käufer:innenangaben automatisch zwischen Eventfrog und deinen Systemen austauschen, ohne dass du alles doppelt pflegen musst.
Was ist die Eventfrog-API?
Eine API ist eine technische Schnittstelle, über die zwei Programme sicher miteinander kommunizieren können.
Mit der Eventfrog-API können externe Programme auf ausgewählte Daten deines Eventfrog-Kontos zugreifen, zum Beispiel um:
- Events automatisch zu erstellen oder zu aktualisieren
- Eventdaten aus Eventfrog in ein anderes System zu übernehmen
- Ticket- und Käufer:innendaten für Auswertungen oder Newsletter zu nutzen
- Eventinformationen automatisch auf einer Website, in einer App oder auf Infoscreens anzuzeigen
Der Zugriff ist über einen API-Key geschützt, den du in deinem Eventfrog-Konto erstellen und verwalten kannst. Wie du einen API-Key erstellst und verwaltest, erfährst du im Hilfeartikel API-Keys erstellen und verwalten
Welche API-Typen gibt es?
Aktuell unterscheiden wir zwei Hauptbereiche:
1. Public API (öffentliche Eventdaten)
Die Public API stellt öffentliche Eventdaten bereit, zum Beispiel für:
- Event-Agenden, Plattformen oder Medienportale
- eigene Eventübersichten auf Websites
- Tourismus- oder Stadtportale
Hier werden nur Daten ausgeliefert, die auch öffentlich auf eventfrog.ch / eventfrog.de / eventfrog.at sichtbar sind (z.B. Titel, Datum, Ort, Rubrik).
2. Organizer-API (für Veranstaltende)
Die Organizer-API ist speziell für Veranstalter:innen gedacht. Sie ermöglicht, abhängig vom API-Typ einen lesenden oder lesenden + schreibenden Zugriff auf deine eigenen Events und zugehörige Daten.
Mögliche API-Keys für Veranstaltende:
Organizer API (Read)
Externe Systeme können deine Eventdaten, Locations, Ticketkategorien, Käufe, Personalisierungsfelder usw. auslesen, aber nichts verändern.
Organizer API (Read/Write/Delete)
Externe Systeme können Events und bestimmte Einstellungen anlegen, ändern oder löschen – z.B. Events erstellen, Texte anpassen, Kategorien aktualisieren oder Dokumente hochladen.
Was kann ich mit der Organizer-API konkret machen?
Die Organizer-API ist so konzipiert, dass du viele Dinge, die du im Cockpit manuell machst, automatisiert über deine eigene Software steuern kannst. Zum Beispiel:
Events und Serien automatisch verwalten
- Events aus deinem eigenen System bei Eventfrog erstellen
- Eventinformationen aktualisieren (Titel, Beschreibung, Zeiten, Location, Rubrik, Zielgruppeninformationen usw.)
- Eventgruppen, Reihen oder Festivals über die API verwalten
Eventdaten nur einmal pflegen
- Events werden in deinem System gepflegt und automatisch zu Eventfrog übertragen
- Änderungen (z.B. neue Uhrzeit, anderer Ort, angepasste Beschreibung) müssen nicht mehr mehrfach eingetragen werden
- Geeignet, wenn du bereits eine Vereinssoftware, ein Club-Tool oder ein eigenes CMS im Einsatz hast
Ticketkategorien und Preise steuern
- Ticketkategorien und Kontingente für Events per API verwalten
- Preise, Mindest- und Maximalabnahmen oder Verkaufszeiträume automatisiert anpassen
- Informationen zu Tickets (z.B. Ticketcodes oder Flex-Tickets) auslesen
Käufer- und Bestelldaten nutzen
- Bestellungen und Käuferangaben (inkl. Personalisierungsfelder) auslesen
- Daten für eigene Auswertungen, CRM-Systeme oder Newsletter-Tools verwenden
- Check-in-Informationen (Einlass-Scans) abrufen
Codes & Zugänge verwalten
- Rabattcodes, Zugangscodes und Ticketcodes zu Ticketkategorien auslesen
- Eigene Systeme zur Code-Verwaltung oder Friendslists anbinden
Locations & Adressen synchronisieren
- Veranstaltungsorte (Locations) und Adressen über die API auslesen
- Adressen von Veranstalter:innen oder Bankverbindungen in deinem System mit Eventfrog abgleichen
Was macht die API nicht?
Damit es nicht zu falschen Erwartungen kommt:
- Die API ist kein «Drag & Drop»-Tool, sondern eine technische Schnittstelle – es braucht jemanden mit Entwickler:innen-Know-how.
- Die API berechnet keine Preise oder Modellwechsel für dich. Welche Funktionen du nutzt und welche Kosten dadurch entstehen, werden weiterhin im Eventfrog-System und im Cockpit bestimmt.
- Die API ersetzt nicht das Cockpit, sondern ergänzt es.
Sicherheit & Zugriffskontrolle
Der Zugriff auf die API ist über einen API-Key geschützt:
- Du kannst API-Keys in deinem Kundenkonto erstellen, bearbeiten und deaktivieren.
- Jeder Key ist einem bestimmten Typ zugeordnet (z.B. Public oder Organizer-API).
- Du kannst API-Keys zeitlich befristen und auf bestimmte IP-Adressen einschränken.
- Bei der Organizer-API können nur Events und Daten abgerufen oder verändert werden, die zu deinem Account gehören.
Wenn ein API-Key deaktiviert oder abgelaufen ist, können darüber keine Anfragen mehr gestellt werden.
Voraussetzungen für die Nutzung
Um die Eventfrog-API zu nutzen, brauchst du:
- ein Eventfrog-Konto
- mindestens einen API-Key (im Kundenkonto erstellbar)
- technische Unterstützung durch eine Entwickler:in oder eine technische Dienstleister:in, die die Integration in dein System übernimmt
Die technische Beschreibung der Schnittstellen findest du in der API-Dokumentation. Dort sind alle Endpunkte, Felder und Beispiele für Entwickler:innen detailliert beschrieben.