May 03, 2026

Events überall einbetten: Ein öffentlicher JSON-Feed für jeden Shop

Deine Events lebten bisher auf deinem Usetix-Shop. Ab heute leben sie auch auf jeder anderen Seite, auf der du sie haben willst.

Jedes veröffentlichte Event in deinem Shop ist jetzt als JSON auf derselben URL verfügbar — einfach .json anhängen (oder Accept: application/json senden). Kein Token, keine Anmeldung, kein Proxy. Ein paar Zeilen JavaScript auf deiner Bandseite, deiner Festival-Hub-Seite oder einer Partner-Listenseite — und dein gesamtes Lineup erscheint dort, automatisch.

Was du bekommst

curl -H "Accept: application/json" \
  https://dein-subdomain.usetix.io/events

Liefert deine veröffentlichten, kommenden Events mit allem, was eine Drittseite zum Anzeigen braucht: Titel, Daten, Location (mit Lat/Lng für Karten), Bilder, Sold-out-Flag, günstigster verfügbarer Preis und eine direkte Kauf-URL.

GET /events/spring-showcase.json ergänzt Tickets, Künstler und FAQ für ein einzelnes Event.

Das war’s. Zwei Endpunkte, öffentlich, ohne Auth.

Gebaut zum Einbinden

Ein paar Entscheidungen, die wir vorab getroffen haben:

CORS für alle Origins offen. Aus jedem Browser, von jeder Domain abrufbar.
Cache-Control: public, max-age=60 — dein CDN, dein Reverse-Proxy, sogar der Browser des Besuchers cachen das gerne eine Minute lang.
ETag auf der Event-Detail-Seite — wiederholte Requests liefern 304 Not Modified mit leerem Body, wenn sich nichts geändert hat.
Absolute Bild-URLs — direkt in <img src=...> einsetzbar, von jeder Domain aus.
Geld als { amount, currency } — gleiches Format wie der Rest der API, keine Symbole, keine Floats.

<div id="next-event"></div>

<script>
  fetch("https://dein-subdomain.usetix.io/events.json")
    .then(r => r.json())
    .then(data => {
      const next = data.events[0];
      if (!next) return;
      document.getElementById("next-event").innerHTML = `
        <a href="${next.url}">
          <img src="${next.image_url}" alt="">
          <h3>${next.title}</h3>
          <p>${new Date(next.starts_at).toLocaleString()} · ${next.venue.name}</p>
        </a>`;
    });
</script>

Setz das in dein Band-WordPress, deine Venue-Squarespace, deine statische Festival-Landingpage. Es aktualisiert sich, sobald der nächste Besucher die Seite lädt — und in dem Moment, in dem du in Usetix ein neues Event veröffentlichst, ist es da.

Was nicht im Feed enthalten ist

Der öffentliche Feed zeigt nur das, was dein Shop ohnehin schon öffentlich zeigt. Entwürfe, versteckte Tickets ohne Zugangscode, Kapazitätszahlen, Ticket-Bestände, Kundendaten, Bestelldaten — nichts davon ist drin. Für all das, plus vollständigen Schreibzugriff, nutze die authentifizierte Admin-API.

Probier’s aus

Veröffentliche ein Event in deinem Account und ruf seine URL als JSON auf:

curl https://dein-subdomain.usetix.io/events.json

Die vollständige Referenz — jedes Feld, jeder Endpunkt, mit Einbettungs-Beispielen — findest du unter usetix.io/docs/api/public-events.

Du baust etwas Cooles damit? Erzähl uns davon unter [email protected].

Was du bekommst

Gebaut zum Einbinden

Ein “Nächstes Event”-Widget in 10 Zeilen

Was nicht im Feed enthalten ist

Probier’s aus