API und KI-Agenten
Lassen Sie Ihren KI-Agenten Veranstaltungen, Vorstellungen und Tarife auf ticketick anlegen, oder durchsuchen Sie unseren Katalog von Konzerten und Festivals in der Schweiz.
MCP-Server
Verbinden Sie Claude, ChatGPT, Cursor oder jeden MCP-fähigen Agenten: Er legt Ihre Veranstaltungen in natürlicher Sprache an und veröffentlicht sie.
REST-API
JSON, ein Schlüssel pro Veranstalter, OpenAPI-3.1-Spezifikation. Dieselben Operationen wie der MCP-Server.
Öffentlicher Katalog
Suche nach Veranstaltungen im Verkauf, ohne Schlüssel: Daten, Orte, Preise, Verfügbarkeit und Buchungslinks.
In drei Schritten starten
- 1Erstellen Sie im ticketick-Admin, Seite «API & KI-Agenten», einen Schlüssel. Aktivieren Sie «Darf veröffentlichen» nur, wenn der Agent selbst veröffentlichen soll.
- 2Fügen Sie den MCP-Server mit dem Schlüssel im Authorization-Header zu Ihrem Agenten hinzu.
- 3Bitten Sie ihn zum Beispiel: «Lege das Weihnachtskonzert am 5. Dezember um 20 Uhr im Temple in Rougemont an, 300 Plätze, CHF 45 Vollpreis und CHF 20 für Studierende.»
MCP
https://ticketick.ch/api/mcp
claude mcp add --transport http ticketick https://ticketick.ch/api/mcp \ --header "Authorization: Bearer tt_…"
{
"mcpServers": {
"ticketick": {
"type": "http",
"url": "https://ticketick.ch/api/mcp",
"headers": {
"Authorization": "Bearer tt_…"
}
}
}
}Regeln
- Eine vom Agenten angelegte Veranstaltung ist ein Entwurf, den Sie vor der Veröffentlichung prüfen, ausser der Schlüssel darf veröffentlichen.
- Ein Schlüssel handelt nur für seinen Veranstalter. Sie können ihn jederzeit widerrufen.
- Nichts mit verkauften Tickets kann über die API gelöscht werden, und eine Vorstellung mit Verkäufen behält Datum und Ort.
- Schweizer Ortszeit, Preise in Franken, Texte auf Französisch, Englisch, Deutsch und Italienisch.
Verfügbare Werkzeuge
whoamiGET /api/v1/me
Organizer account and permissions of the API key. Call it first: it states the rules (drafts, publish permission, time zone, currency).
list_eventsGET /api/v1/events
Events of the organizer (drafts included), newest first, with status, next session and tickets sold.
get_eventGET /api/v1/events/{eventId}
Full event: texts, payment, sessions, venues, ticket types, sales counters and links (public page, admin).
create_eventPOST /api/v1/events
Create an event with, in the same call, its sessions (dates, venue, capacity) and ticket types (prices in CHF). It is a draft unless publish is true and the key may publish. Times without offset are Swiss local time. Texts are per language ({ fr, en, de, it }); give at least one. Returns the event with its admin link for review.
update_eventPATCH /api/v1/events/{eventId}
Change texts, categories, visibility, payment methods, contact or cover image. Only the given fields change. A key without publish permission may only change drafts.
delete_eventDELETE /api/v1/events/{eventId}
Delete a draft event without sales, with its sessions and ticket types.
publish_eventPOST /api/v1/events/{eventId}/publish
Put the event online (status PUBLISHED). Needs a key with publish permission, an upcoming session and, for online sale, a ticket type.
unpublish_eventPOST /api/v1/events/{eventId}/unpublish
Turn an event without sales back into a draft. Needs a key with publish permission.
add_sessionPOST /api/v1/events/{eventId}/sessions
Add a dated session (performance) to an event, with its venue, capacity and ticket types.
update_sessionPATCH /api/v1/sessions/{sessionId}
Change a session's times, label, venue or capacity. A session with sold tickets keeps its date and venue (use « Programme modifié » in the admin). null clears an optional field.
delete_sessionDELETE /api/v1/sessions/{sessionId}
Delete a session without sales.
add_ticket_typePOST /api/v1/sessions/{sessionId}/ticket-types
Add a ticket type (price in CHF, quantity) to a session.
update_ticket_typePATCH /api/v1/ticket-types/{ticketTypeId}
Change a ticket type's name, price, quantity (not below sold), limit per order or sales window.
delete_ticket_typeDELETE /api/v1/ticket-types/{ticketTypeId}
Delete a ticket type without sales.
list_venuesGET /api/v1/venues
Venues already used by the organizer, or search all ticketick venues by name or city with q. Reuse a venueId rather than creating a duplicate venue.
list_categoriesGET /api/v1/categories
Event categories (slug and names) to use in create_event.
search_eventsGET /api/v1/public/eventsohne Schlüssel
Public catalogue of ticketick.ch: upcoming concerts, festivals, theatre and shows in Switzerland, with dates, venues, prices, availability and booking links. No API key needed.
get_public_eventGET /api/v1/public/events/{slug}ohne Schlüssel
Public details of an event on ticketick.ch: full description, upcoming sessions, ticket prices, availability and booking link. No API key needed.