B2B API · v1Business

Connexxa API Dokumentation

Zugriff auf Schweizer Event-Daten für deine Applikation. Filtere nach Datum, Stadt, Kategorie, Wochentag und mehr. Business-Plan erforderlich.

Authentifizierung

Alle Anfragen benötigen einen Bearer-Token im Authorization-Header.

Authorization: Bearer cx_live_YOUR_API_KEY

http

API-Keys beginnen mit cx_live_. Teile deinen Key nie öffentlich. Bei Verlust: sofort in den Einstellungen rotieren.

Rate Limit: 60 Anfragen/Min. pro Key. Business-Plan: 10 000 Anfragen/Monat inkl.

API-Key generieren

GET /api/v1/events

Gibt gefilterte Events zurück. Bis zu 5000 pro Anfrage, paginiert mit offset.

Query-Parameter

NameTypReq.Beschreibung

fromISO dateneinStart-Datum (default: heute)

toISO dateneinEnd-Datum (default: +90 Tage, max +365)

citystringneinStadt(e), kommagetrennt (z.B. Zürich,Bern)

cantonstringneinKanton(e), kommagetrennt (z.B. ZH,BE)

weekdaynumberneinWochentag(e): 0=So, 1=Mo, …, 4=Do, 6=Sa

sourcestringneinQuelle(n): stadt-zuerich|opendata-swiss|eth-ics|…

bboxstringneinGeo-Bounding-Box: lon1,lat1,lon2,lat2

limitnumberneinMax. Ergebnisse (default: 1000, max: 5000)

offsetnumberneinPagination-Offset (default: 0)

Beispiel-Anfrage

GET /api/v1/events?from=2026-06-01&to=2026-06-30&city=Zürich&category=musik&weekday=4&limit=50
Authorization: Bearer cx_live_YOUR_KEY

http

Antwort-Beispiel

{
  "meta": {
    "version": "v1",
    "total": 127,
    "returned": 50,
    "limit": 50,
    "offset": 0,
    "hasMore": true
  },
  "filters": { "from": "2026-06-01T00:00:00.000Z", ... },
  "data": [
    {
      "id": "evt_abc123",
      "title": "Zürich Jazz Night",
      "category": "musik",
      "startsAt": "2026-06-05T19:00:00.000Z",
      "city": "Zürich",
      "venueName": "Moods",
      "isFree": false,
      "priceMin": 25,
      "ticketUrl": "https://...",
      ...
    }
  ]
}

json

GET /api/v1/stats

Aggregierte Statistiken: Verteilung nach Kategorie, Wochentag, Stadt und Quelle.

Query-Parameter

NameTypReq.Beschreibung

fromISO dateneinStart-Datum (default: Monatsanfang)

toISO dateneinEnd-Datum (default: +90 Tage)

citystringneinStadt(e) für Einschränkung

Beispiel-Anfrage

GET /api/v1/stats?from=2026-06-01&to=2026-06-30
Authorization: Bearer cx_live_YOUR_KEY

http

Antwort-Beispiel

{
  "meta": { "version": "v1", "from": "...", "to": "..." },
  "data": {
    "totalEvents": 1842,
    "thursdayShare": 62.4,
    "freeShare": 31.7,
    "byCategory": { "musik": 412, "business": 287, ... },
    "byWeekday":  { "0": 43, "4": 1148, ... },
    "byCity": [{ "city": "Zürich", "count": 891 }, ...],
    "bySource": { "stadt-zuerich": 643, ... }
  }
}

json

Fehlercodes

200OKErfolgreiche Anfrage

400Bad RequestUngültige Parameter

401UnauthorizedFehlender oder ungültiger API-Key

403ForbiddenKey hat nicht die nötige Berechtigung (Business erforderlich)

429Too Many RequestsRate Limit überschritten. Warte kurz und versuche es erneut.

500Internal Server ErrorServer-Fehler. Bitte an support@connexxa.ch melden.

Fragen zur API?

Support kontaktieren

{ "meta": { "version": "v1", "total": 127, "returned": 50, "limit": 50, "offset": 0, "hasMore": true }, "filters": { "from": "2026-06-01T00:00:00.000Z", ... }, "data": [ { "id": "evt_abc123", "title": "Zürich Jazz Night", "category": "musik", "startsAt": "2026-06-05T19:00:00.000Z", "city": "Zürich", "venueName": "Moods", "isFree": false, "priceMin": 25, "ticketUrl": "https://...", ... } ] }

{ "meta": { "version": "v1", "from": "...", "to": "..." }, "data": { "totalEvents": 1842, "thursdayShare": 62.4, "freeShare": 31.7, "byCategory": { "musik": 412, "business": 287, ... }, "byWeekday": { "0": 43, "4": 1148, ... }, "byCity": [{ "city": "Zürich", "count": 891 }, ...], "bySource": { "stadt-zuerich": 643, ... } } }