Für Entwickler:innen

Ö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. 1

    Abrufen

    Ein GET auf den Endpoint liefert die nächsten Events – kein Header, kein Key.

  2. 2

    Durchblättern

    Mit page und limit bis zu 100 Events pro Anfrage holen, bis total erreicht ist.

  3. 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.

GEThttps://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-title

Standard: 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_OUTCOMPLETEDCANCELLEDPOSTPONED

type

FESTIVALOPEN_AIRCONCERTCLUB_NIGHTOTHER

genres

TECHNOHOUSETRANCEPSYTRANCEDRUM_AND_BASSBASSHARD_DANCEAMBIENTELECTRONICHIP_HOPRNBAFROBEATSREGGAEPOPROCKINDIEMETALPUNKSOUL_FUNKDISCOJAZZCLASSICALSCHLAGERFOLKLATINSINGER_SONGWRITERWORLD

address.country

DEATCHNLBELUFRITESPTPLCZDKSENOGBIEHUHR

Code-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.

Kostenlos starten