# Ticketmaster — Discovery API (Québec) (ticketmaster)

Fiche générée le 2026-08-25 19:01 EDT par scripts/gen_connector_docs.py — ne pas éditer à la main, relancer le script.

Statut : actif · Type : billetterie · Connecteur : sortika/connectors/ticketmaster.py

# Description

• Source : Ticketmaster — Discovery API (Québec)
• Couverture : Grands spectacles, sports et concerts — Montréal/Laval/Brossard, Québec, Gatineau
• Extraction : SANS clé (mode par défaut) : scraping léger des pages découverte publiques www.ticketmaster.ca/discover/?page=N (montreal, quebec-city, gatineau) — l'état Next.js (NEXT_DATA, requête serveur cityEvents) livre 20 événements/page : titre, date UTC + fuseau → date/heure locales, salle géolocalisée (lat/lng), adresse, code postal, ville, URL billetterie, catégorie majeure, plan de salle (image) ; plafonds TM_MAX_EVENTS=360 / TM_PAGES_PER_CITY=8 ; Scrapfly ASP sans render_js en secours anti-bot ; aucun prix publié dans ce flux → jamais inventé. REPLI AUTOMATIQUE : si TICKETMASTER_API_KEY apparaît dans .env, bascule sur la Discovery API v2 officielle (priceRanges, attractions → artistes, images 16:9) — identifiants identiques, zéro doublon.
• Note : Fonctionne sans clé (scraping découverte). TICKETMASTER_API_KEY optionnelle : active le mode API riche (prix, artistes, images).

# Accès

• Type : billetterie
• Endpoint (API) : https://app.ticketmaster.com/discovery/v2/events.json
• Endpoint (DISCOVER) : https://www.ticketmaster.ca/discover/{city}?page={page}
• Auth : Clé API gratuite TICKETMASTER_API_KEY (developer.ticketmaster.com)
• Pagination : par numéro de page
• Backend : Scrapfly (anti-bot / rendu JS) via base.get_scrapfly()
• Throttle : 1.0 s entre requêtes
• Accès légal : pages découverte publiques rendues serveur — robots.txt n'interdit pas /discover/ (seuls /api/ismds/*) ; GET throttlés 1 s, lien direct vers la billetterie officielle ; API officielle (clé gratuite) utilisée dès qu'une clé est fournie

# Champs récupérés → schéma

Complétude mesurée sur les 360 événements actifs de la source ; exemples tirés d'un événement réel (ticketmaster:31006476DB368606).

# Fréquence & budgets

• Cadence : horaire (watcher PM2)
• Budgets / plafonds (variables d'environnement) :

• Budget global : géocodage Nominatim plafonné à SORTIKA_GEOCODE_MAX (défaut 120) requêtes réseau/cycle, toutes sources confondues (sortika/geocode.py, cache disque).

# Volumétrie & complétude live

(mesuré le 2026-08-25 19:01 EDT dans data/sortika.db)

• Événements en base : 437 (dont 360 actifs)
• GPS : 360/360 actifs (100 %)
• Prix : 0/360 actifs (0 %)
• Heure (start_time) : 349/360 actifs (97 %)
• Heure de fin : 0/360 actifs (0 %)
• Statut (annulé/reporté/complet) : 15/360 actifs (4 %)
• Artistes : 0/360 actifs (0 %)
• Image : 315/360 actifs (88 %)
• Salle (venue) : 360/360 actifs (100 %)
• Dernier sync : 2026-08-25 18:07 — fetched 360, +0 ajoutés, ~0 mis à jour, -0 retirés
• Syncs enregistrés (sync_log) : 160

# Erreurs & dépannage

Aucune erreur dans sync_log pour cette source. ✅

• Sans TICKETMASTER_API_KEY dans .env, le connecteur tourne en mode REPLI (scraping des pages découverte publiques) : pas de prix, pas de statut, images = plans de salle. La clé Discovery (gratuite, inscription developer.ticketmaster.com) débloque priceRanges, dates.status.code (annulé/reporté), visuels 16:9 HD et attractions → artistes. Quota API : 5 req/s (throttle 0,25 s côté connecteur).
• Rejouer un sync isolé : python3 run.py sync --source ticketmaster (ou via le watcher PM2) ; inspecter ensuite sync_log : sqlite3 data/sortika.db "SELECT * FROM sync_log WHERE source='ticketmaster' ORDER BY ts DESC LIMIT 5;"

# Licence / attribution

• pages découverte publiques rendues serveur — robots.txt n'interdit pas /discover/ (seuls /api/ismds/*) ; GET throttlés 1 s, lien direct vers la billetterie officielle ; API officielle (clé gratuite) utilisée dès qu'une clé est fournie

# Historique

• 2026-08-18 — Vague 1 d'enrichissement (commit 7d9d1b0) : géocodage Nominatim des salles (sortika/geocode.py, cache disque, plafond SORTIKA_GEOCODE_MAX), fiches détail lepointdevente (description, heure, tarifs réels /plugins/rates/<id>), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
• 2026-08-18 — Vague 2 d'enrichissement (commit 65d2d33) : colonnes additives events.start_time (HH:MM locale QC) et events.artists (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).
• 2026-08-19 — Phase 2 (travail de moine) : colonnes additives end_time, status (annulé/reporté/complet) et quarantine (règles anti-aberrations, non publié mais réintégrable) ; règle d'ARCHIVAGE des événements terminés à chaque cycle (jamais supprimés) ; dedup_key inclut désormais l'heure (les séances multiples d'un même jour ne sont plus écrasées à l'affichage) ; alerte « 0 événement futur / chute > 80 % » par source (data/future_counts.json + /api/sources) ; heure et description La Vitrine ; end_time/organisateur/statut Eventbrite ; og:description Atuvu ; premières parties + portes + tournée evenko ; offres billets Bandsintown ; taxonomie type-event + description intégrale Brossard ; image Longueuil ; géocodage par ADRESSE CIVIQUE prioritaire ; villes normalisées au Répertoire MAMH (data/villes_canon.json) ; laval consignée « morte-a-la-source ».

Commits touchant sortika/connectors/ticketmaster.py :

• 85714fd 2026-08-19 Phase 2 — connecteurs : heure+description La Vitrine, statuts, end_time, offres, taxonomies
• 86b1494 2026-08-18 Vague 3 : Ticketmaster SANS clé + Eventbrite + Longueuil + Cantons-de-l'Est
• 65d2d33 2026-08-18 Vague 2 d'enrichissement : heure précise, artistes, 3 nouveaux connecteurs