Construisez votre billetterie
dans tout.

Diffusez l'agenda, sans clé requise

Les sites d'agenda, agrégateurs et applications de sorties peuvent récupérer chaque événement public de tickts directement depuis GET /api/v1/feed/events. Une ligne par date à venir, de la plus proche à la plus lointaine, encapsulée dans une { data, meta } enveloppe comportant meta.next pour la page suivante. Interrogez avec since= pour ne recevoir que ce qui a changé, y compris les annulations sous forme de marqueurs status: "cancelled" d'annulation, pour que votre copie ne soit jamais périmée.

Les événements non répertoriés et les brouillons n'apparaissent jamais. Les événements à lieu privé n'exposent que le secteur. Les événements en ligne ne portent aucun lieu physique. Toutes les heures sont au format ISO 8601 Europe/London ; les prix sont dans la devise de l'organisateur (currency sur chaque ligne : GBP ou EUR). Limité à 60 requêtes par minute ; interrogez avec since= plutôt que de tout récupérer à nouveau.

Le flux ne nécessite aucune clé et n'en nécessitera jamais. Si vous diffusez les événements tickts de façon régulière, demandez-nous tout de même une clé partenaire et envoyez-la en tant que X-TK-Feed-Key (or Authorization: Bearer). Elle relève votre limite au-delà des 60 requêtes anonymes par minute, vous identifie dans nos journaux pour que nous puissions vous prévenir avant tout changement, et enregistre automatiquement l'adresse de votre importateur auprès de notre protection anti-bots, pour qu'une récupération nocturne planifiée depuis un datacenter ne tombe jamais sur une page de vérification. Écrivez à [email protected].

Récupérer la page suivante des événements musicaux

curl "https://tickts.co.uk/api/v1/feed/events?genre=music&per_page=200"

{
  "data": [{
    "id": "SE-kb759-20260912-2000",
    "event_id": 1041,
    "status": "scheduled",
    "title": "Hidden Jazz Club: Late Session",
    "description": "An intimate late-night set...",
    "url": "https://tickts.co.uk/events/hidden-jazz-club",
    "date_url": "https://tickts.co.uk/events/hidden-jazz-club?sub_event_id=SE-kb759-20260912-2000",
    "image": "https://tickts.co.uk/storage/events/card.jpg",
    "start_at": "2026-09-12T20:00:00+01:00",
    "doors_at": "2026-09-12T19:00:00+01:00",
    "timezone": "Europe/London",
    "venue": { "id": 812, "name": "The Bell Inn", "address": "12 High St", "city": "Bath",
               "postcode": "BA1 5AQ", "country": "GB", "lat": 51.38, "lng": -2.36 },
    "artists": [{ "name": "Ada Quartet", "headliner": true, "slug": "ada-quartet" }],
    "genres": [{ "name": "Jazz", "slug": "jazz", "parent": "Music" }],
    "category": "Music",
    "organiser": { "id": 812, "name": "Hidden Jazz Club" },
    "tickets": { "currency": "GBP", "sold_out": false, "cheapest": 12.5,
                 "types": [{ "name": "General Admission", "price": 12.5, "available": true }] },
    "sales_state": "on_sale",
    "updated_at": "2026-08-20T09:14:02+01:00"
  }],
  "meta": { "page": 1, "per_page": 200, "total": 1893, "total_pages": 10,
            "next": "https://tickts.co.uk/api/v1/feed/events?genre=music&per_page=200&page=2" }
}

Clés à portée limitée, privilège minimal

Chaque clé porte une liste explicite de portées autorisées et n'accorde rien au-delà (une clé sans portée ne peut rien faire : elle échoue en mode fermé). Envoyez-la en tant que X-Api-Key ou un Authorization: Bearer header.

En temps réel, signés, réessayés

Abonnez un point d'accès via l'API et tickts vous envoie les événements dès qu'ils se produisent, sans interrogation régulière. Chaque charge utile est signée avec X-Tickts-Signature (HMAC-SHA256) pour que vous puissiez vérifier qu'il vient bien de nous ; les envois sont mis en file d'attente et réessayés.

curl -X POST https://tickts.co.uk/api/v1/webhooks \
  -H "X-Api-Key: sk_live_your_key" \
  -d '{ "url": "https://you.com/hook",
       "events": ["order.created"] }'

Connectez un assistant IA avec MCP

tickts fournit un Model Context Protocol serveur, pour que des assistants comme Claude et Cursor puissent piloter directement votre billetterie : consulter les ventes, émettre des invitations, répondre à « comment s'est passé vendredi ? », avec votre propre clé à portée limitée. Votre API est prête pour le web agentique dès le départ.

Endpoint: https://tickts.co.uk/api/mcp

Les détails qui comptent

Versioned (/api/v1), HTTPS-only, rate-limited with clear headers, consistent JSON errors, cursor pagination, and a machine-readable Spécification OpenAPI 3.0.3 à partir de laquelle vous pouvez générer un client. Conçue en pensant aux développeurs (comme nous).