Öffentliche Event-API
Event-Plattformen, Kalender und Stadtmagazine rufen Veranstaltungen von Alpha Events als JSON ab – mit Adresse und Koordinaten, Event-Art, Genres, Ticket-Shop-Link, aktuellen Preisen und Besucher-App. Ohne Anmeldung, ohne API-Key.
- REST + JSON
- Ohne API-Key
- CORS offen
- Kostenlos
$ curl "https://alphaevents.tech/api/public/events?limit=1"
{
"events": [
{
"title": "Summer Open Air 2027",
"startDate": "2027-07-16T14:00:00.000Z",
"location": "Stadtpark, 22303 Hamburg",
"ticketShopUrl": "https://…/shop/summer-open-air-2027",
…
}
],
"page": 1,
"limit": 1,
"total": 1
}Schnellstart
In drei Schritten von der ersten Anfrage zum täglichen Abgleich.
- 1
Abrufen
Ein GET auf den Endpoint liefert die nächsten Events – kein Header, kein Key.
- 2
Durchblättern
Mit
pageundlimitbis zu 100 Events pro Anfrage holen, bistotalerreicht ist. - 3
Täglich abgleichen
Einmal am Tag die volle Liste laden und alles entfernen, was nicht mehr dabei ist.
Endpoint
Liefert alle freigegebenen Veranstaltungen, die noch laufen oder bevorstehen. Laufende und bald startende Events kommen zuerst.
https://alphaevents.tech/api/public/events- Authentifizierung
- Keine
- Format
- JSON · UTF-8
- CORS
- Allow-Origin: *
- Cache
- max-age=60
Query-Parameter
Alle Parameter sind optional. Ungültige Werte beantwortet die API mit 400.
- pageinteger
Seite, ab 1.
Standard: 1
- limitinteger
Events pro Seite, 1–100.
Standard: 50
- sortstring
Sortierung. Ein „-“ davor sortiert absteigend; bei Gleichstand entscheidet die ID, damit sich Seiten nie überschneiden.
startDate-startDateupdatedAt-updatedAttitle-titleStandard: startDate
- updatedSinceISO 8601
Nur Events, die seit diesem Zeitpunkt geändert wurden – für schnelle Zwischen-Abgleiche.
Standard: —
Antwort
Jede Antwort ist ein JSON-Objekt mit der Trefferseite und der Gesamtzahl.
- eventsEvent[]
- Events dieser Seite.
- pageinteger
- Aktuelle Seite.
- limitinteger
- Events pro Seite.
- totalinteger
- Anzahl aller Treffer über alle Seiten.
Das Event-Objekt
Felder, die fehlen können, sind null – nie weggelassen.
- idstring
- Eindeutige, dauerhafte ID – der Schlüssel für euren Abgleich.
- slugstring | null
- Lesbarer Kurzname aus der URL.
- titlestring
- Name der Veranstaltung.
- descriptionstring | null
- Beschreibung als Text.
- startDateISO 8601
- Beginn (UTC).
- endDateISO 8601
- Ende (UTC).
- timeZonestring
- Zeitzone des Events (IANA, z. B. Europe/Berlin) – aus dem Land der Adresse. Ortszeit = startDate/endDate in dieser Zone.
- locationstring
- Ort als lesbarer Text, aus der Adresse gebildet.
- addressobject | null
- Postadresse der Veranstaltung.
- address.namestring | null
- Name der Location.
- address.streetstring | null
- Straße und Hausnummer.
- address.zipstring | null
- Postleitzahl.
- address.citystring | null
- Ort.
- address.countrystring
- Ländercode nach ISO 3166-1 alpha-2.
- address.latnumber | null
- Breitengrad, aus der Postleitzahl ermittelt.
- address.lngnumber | null
- Längengrad, aus der Postleitzahl ermittelt.
- typeenum
- Art der Veranstaltung.
- genresenum[]
- Bis zu drei Genres.
- statusenum
- Status der Veranstaltung.
- imageUrlstring | null
- Logo der Veranstaltung.
- organizerobject
- Veranstalter.
- organizer.namestring
- Name des Veranstalters.
- ticketShopUrlstring | null
- Link zum Ticket-Shop, solange dort verkauft wird.
- ticketsTicket[]
- Ticketarten. Leer, solange kein Shop verkauft.
- tickets.namestring
- Name der Ticketart.
- tickets.pricestring
- Preis als Dezimalzahl, z. B. „79.00“.
- tickets.currency"EUR"
- Währung.
- tickets.soldOutboolean
- true, wenn ausverkauft.
- visitorAppUrlstring | null
- Link zur Besucher-App, solange sie geöffnet ist.
- updatedAtISO 8601
- Letzte Änderung.
{
"events": [
{
"id": "6710a1b2c3d4e5f601234567",
"slug": "summer-open-air-2027",
"title": "Summer Open Air 2027",
"description": "Two days, three stages, open air.",
"startDate": "2027-07-16T14:00:00.000Z",
"endDate": "2027-07-17T22:00:00.000Z",
"timeZone": "Europe/Berlin",
"location": "Stadtpark, 22303 Hamburg",
"address": {
"name": "Stadtpark",
"street": "Saarlandstraße 1",
"zip": "22303",
"city": "Hamburg",
"country": "DE",
"lat": 53.5961,
"lng": 10.0247
},
"type": "OPEN_AIR",
"genres": [
"TECHNO",
"HOUSE"
],
"status": "UPCOMING",
"imageUrl": "https://…/logo.webp",
"organizer": {
"name": "Example Events GmbH"
},
"ticketShopUrl": "https://…/shop/summer-open-air-2027",
"tickets": [
{
"name": "Weekend Ticket",
"price": "79.00",
"currency": "EUR",
"soldOut": false
},
{
"name": "Early Bird",
"price": "59.00",
"currency": "EUR",
"soldOut": true
}
],
"visitorAppUrl": "https://…/app/summer-open-air-2027",
"updatedAt": "2027-05-02T09:30:00.000Z"
}
],
"page": 1,
"limit": 50,
"total": 1
}Feste Werte
Diese Werte sind stabil und werden nie umbenannt. Neue Werte können dazukommen – behandelt Unbekanntes bitte tolerant.
status
UPCOMINGSOLD_OUTCOMPLETEDCANCELLEDPOSTPONEDtype
FESTIVALOPEN_AIRCONCERTCLUB_NIGHTOTHERgenres
TECHNOHOUSETRANCEPSYTRANCEDRUM_AND_BASSBASSHARD_DANCEAMBIENTELECTRONICHIP_HOPRNBAFROBEATSREGGAEPOPROCKINDIEMETALPUNKSOUL_FUNKDISCOJAZZCLASSICALSCHLAGERFOLKLATINSINGER_SONGWRITERWORLDaddress.country
DEATCHNLBELUFRITESPTPLCZDKSENOGBIEHUHRCode-Beispiele
Kopierfertig für Terminal, Browser und Node.js 18+.
# Next 20 events, soonest first
curl "https://alphaevents.tech/api/public/events?limit=20&sort=startDate"
# Only events changed since a point in time
curl "https://alphaevents.tech/api/public/events?updatedSince=2027-05-01T00:00:00Z"5 Anfragen pro Minute
Pro IP-Adresse. Darüber antwortet die API mit 429 und dem Header Retry-After.
Ein Abgleich pro Tag
Reicht völlig: alle Seiten mit limit=100 nacheinander abrufen.
60 Sekunden Cache
Antworten dürfen eine Minute zwischengespeichert werden.
CORS offen
Abruf direkt aus dem Browser ist möglich – ohne Cookies, ohne Zugangsdaten.
Entfernte Events
Nicht mehr freigegebene, archivierte und beendete Events fallen einfach aus der Liste. Wer sie bei sich entfernen will, gleicht regelmäßig die vollständige Liste ab.
Fehler
Fehler kommen als JSON mit dem Feld error, z. B. { "error": "invalid-sort" }.
- 400invalid-page
- page ist keine positive ganze Zahl.
- 400invalid-limit
- limit liegt nicht zwischen 1 und 100.
- 400invalid-sort
- sort ist keiner der erlaubten Werte.
- 400invalid-updated-since
- updatedSince ist kein gültiger ISO-8601-Zeitpunkt.
- 429rate-limited
- Zu viele Anfragen – nach Retry-After Sekunden erneut versuchen.
- 503unavailable
- Vorübergehend nicht erreichbar – später erneut versuchen.
Ihr veranstaltet selbst?
In der API erscheinen nur Events, die ihr freigebt: im Backoffice unter Veranstaltung → Allgemein → „Öffentlich listen“. Dafür braucht das Event eine Event-Art, Postleitzahl und Ort.