Ticketmaster — Discovery API (Québec) (ticketmaster)
Fiche générée le 2026-08-18 05:52 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
En-tête documentaire du connecteur
connectors/ticketmaster.py : connecteur Ticketmaster Canada (Québec) — SANS clé Mode principal (sans clé) : scraping léger des pages découverte publiques www.ticketmaster.ca/discover/?page=N (montreal, quebec-city, gatineau). Chaque page embarque son état Next.js (NEXT_DATA) : la requête serveur
cityEventsy est déjà résolue avec 20 événements/page (titre, date UTC + fuseau, salle géolocalisée lat/lng, adresse, code postal, ville, URL billetterie, catégorie majeure, seatmap). Pagination par ?page=N (vérifié 2026-08-18 : montreal total=1165, quebec-city=136). Aucun prix publié dans ce flux → is_free/price_* inconnus (jamais inventés). Artistes : patrons sûrs des titres (artists_from_title). robots.txt : /discover/ non interdit (seuls /api/ismds/* le sont). Anti-bot : GET direct d'abord ; si bloqué → Scrapfly ASP SANS render_js. Plafonds : TM_MAX_EVENTS (défaut 360), TM_PAGES_PER_CITY (défaut 8). Mode repli automatique (si TICKETMASTER_API_KEY apparaît dans .env) : Discovery API officielle v2 — plus riche (priceRanges, attractions → artistes, images 16:9). Les identifiants d'événements sont IDENTIQUES dans les deux modes → aucun doublon lors d'un changement de mode.
Champs récupérés → schéma
Complétude mesurée sur les 330 événements actifs de la source ; exemples tirés d'un événement réel (ticketmaster:310064A20EB06FDE).
Champ (events.*) |
Description | Complétude | Exemple réel |
|---|---|---|---|
title — Titre |
titre de l'événement | 100 % | Mardi Latin Groove |
description — Description |
texte descriptif (source ou fiche détail) | 0 % | ∅ |
url — URL |
lien vers la fiche originale / billetterie | 100 % | https://www.ticketmaster.ca/mardi-latin-groove-montreal-quebec-08-18-2026/event/310064A20EB06FDE |
categories — Catégories |
taxonomie canonique Sorti-Ka (JSON) | 100 % | ["musique"] |
venue — Salle (venue) |
nom du lieu | 100 % | Le Balcon X Terrasse |
address — Adresse |
adresse civique | 100 % | 463 Rue Sainte-Catherine Ouest |
city — Ville |
municipalité | 100 % | Montreal |
region — Région |
région administrative | 100 % | Montréal |
lat — GPS (lat/lng) |
coordonnées géographiques | 100 % | 45.505438, -73.568812 |
start_date — Date début |
date locale AAAA-MM-JJ | 100 % | 2026-08-18 |
end_date — Date fin |
date locale AAAA-MM-JJ | 100 % | 2026-08-18 |
start_time — Heure (start_time) |
heure locale HH:MM (Québec) | 96 % | 19:00 |
is_free — Gratuité (is_free) |
1 gratuit / 0 payant / NULL inconnu | 0 % | ∅ |
price_min — Prix min |
tarif minimal réel ($) | 0 % | ∅ |
price_label — Libellé prix |
étiquette tarifaire affichable | 0 % | ∅ |
artists — Artistes |
têtes d'affiche / lineup (JSON) | 0 % | [] |
organizer — Organisateur |
promoteur / organisme | 0 % | ∅ |
image — Image |
visuel (og:image ou média source) | 90 % | https://mapsapi.tmol.io/maps/geometry/3/event/310064A20EB06FDE/staticImage?type=png&systemId=HOS… |
website — Site web |
site officiel de l'événement | 0 % | ∅ |
Fréquence & budgets
- Cadence : horaire (watcher PM2)
- Budgets / plafonds (variables d'environnement) :
| Variable | Défaut | Rôle |
|---|---|---|
TM_MAX_EVENTS |
360 |
— |
TM_PAGES_PER_CITY |
8 |
— |
SCRAPFLY_API_KEY |
— |
— |
TICKETMASTER_API_KEY |
`` | — |
- 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-18 05:52 EDT dans data/sortika.db)
- Événements en base : 330 (dont 330 actifs)
- GPS : 330/330 actifs (100 %)
- Prix : 0/330 actifs (0 %)
- Heure (start_time) : 318/330 actifs (96 %)
- Artistes : 0/330 actifs (0 %)
- Image : 297/330 actifs (90 %)
- Salle (venue) : 330/330 actifs (100 %)
- Dernier sync : 2026-08-18 05:51 — fetched 330, +330 ajoutés, ~0 mis à jour, -0 retirés
- Syncs enregistrés (sync_log) : 5
Erreurs & dépannage
Aucune erreur dans sync_log pour cette source. ✅
- Sans
TICKETMASTER_API_KEYdans.env, le connecteur s'annonce « clé manquante » et ne retourne rien (statut « prêt — clé requise »). 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 ensuitesync_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, plafondSORTIKA_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 additivesevents.start_time(HH:MM locale QC) etevents.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).
Commits touchant sortika/connectors/ticketmaster.py :
65d2d332026-08-18 Vague 2 d'enrichissement : heure précise, artistes, 3 nouveaux connecteurs