Bandsintown — dates de concerts par artiste (bandsintown)
Fiche générée le 2026-08-19 01:27 EDT par
scripts/gen_connector_docs.py— ne pas éditer à la main, relancer le script.
Statut : actif · Type : agregateur · Connecteur : sortika/connectors/bandsintown.py
Description
- Source : Bandsintown — dates de concerts par artiste
- Couverture : Concerts au Québec des artistes en tournée connus de la base
- Extraction : API publique /artists/{artiste}/events (app_id format widget « js_www.sorti-ka.com », testé accepté 2026-08 ; un app_id arbitraire simple est refusé) — pas de recherche géographique : on interroge les artistes déjà extraits de la base (evenko/lepointdevente/ticketmaster, événements à venir), plafond 100 artistes/sync avec rotation et cache data/bandsintown_cache.json (re-visite 3 j) ; on ne garde que les dates au Québec (venue.region=QC) : datetime local (date+heure), salle géolocalisée, lineup → artistes, free → gratuité, lien billets
Accès
- Type : agregateur
- Endpoint (
API) :https://rest.bandsintown.com/artists/{artist}/events - Auth :
app_idd'identification (BANDSINTOWN_APP_ID, format widget accepté) - Pagination : aucune (flux unique)
- Backend : GET direct
requests(throttlé, UASortiKa/1.0identifié) - Throttle : 0.5 s entre requêtes
- Accès légal : API publique Bandsintown (app_id d'identification) — usage index + lien vers la fiche originale
En-tête documentaire du connecteur
connectors/bandsintown.py : connecteur Bandsintown (API publique par artiste) Source : rest.bandsintown.com/artists/{artiste}/events — API publique (app_id d'identification ; le format « js_ » des widgets officiels est accepté, testé 2026-08 — un app_id arbitraire simple est refusé « not authorized »). Approche : l'API ne permet pas de recherche géographique → on interroge les artistes déjà connus de la base (colonne
artistsextraite d'evenko / lepointdevente / ticketmaster, événements à venir) et on ne garde que leurs dates au QUÉBEC (venue.region = QC). Volume : plafond BIT_ARTIST_MAX artistes/sync (défaut 100), rotation par ancienneté via cache disque (data/bandsintown_cache.json) ; les événements des artistes déjà sondés sont ré-émis depuis le cache entre deux visites (re-visite après 3 jours). Champs : datetime local (date + heure), salle géolocalisée (lat/lng), lineup → artistes,free→ is_free, offres/billets → url, image de l'artiste.
Champs récupérés → schéma
Complétude mesurée sur les 370 événements actifs de la source ; exemples tirés d'un événement réel (bandsintown:108747079).
Champ (events.*) |
Description | Complétude | Exemple réel |
|---|---|---|---|
title — Titre |
titre de l'événement | 100 % | Doug St-Louis & Dj Chuck / Ptit Gros Bison à Grenville en Fête |
description — Description |
texte descriptif (source ou fiche détail) | 18 % | Au Parc Normand-Woodbury à Grenville. Spectacle Gratuit Ils seront en duo pour vous faire danser… |
url — URL |
lien vers la fiche originale / billetterie | 100 % | https://www.bandsintown.com/e/108747079?app_id=js_www.sorti-ka.com&came_from=267&utm_medium=api&… |
categories — Catégories |
taxonomie canonique Sorti-Ka (JSON) | 100 % | ["musique"] |
venue — Salle (venue) |
nom du lieu | 100 % | Doug St-Louis & Dj Chuck / Ptit Gros Bison à Grenville en Fête |
address — Adresse |
adresse civique | 98 % | 21 Rue Tri Jean |
city — Ville |
municipalité | 100 % | Grenville |
region — Région |
région administrative | 99 % | Laurentides |
lat — GPS (lat/lng) |
coordonnées géographiques | 100 % | 45.630063, -74.600568 |
start_date — Date début |
date locale AAAA-MM-JJ | 100 % | 2026-08-22 |
end_date — Date fin |
date locale AAAA-MM-JJ | 100 % | 2026-08-22 |
start_time — Heure (start_time) |
heure locale HH:MM (Québec) | 100 % | 20:30 |
end_time — Heure de fin (end_time) |
heure locale HH:MM (Québec) | 0 % | ∅ |
status — Statut |
cancelled / postponed / soldout (NULL = prévu) | 0 % | ∅ |
is_free — Gratuité (is_free) |
1 gratuit / 0 payant / NULL inconnu | 1 % | 1 |
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) | 100 % | ["Doug St-Louis", "P'tit Gros Bison"] |
organizer — Organisateur |
promoteur / organisme | 0 % | ∅ |
image — Image |
visuel (og:image ou média source) | 7 % | https://photos.bandsintown.com/large/25853181.jpeg |
website — Site web |
site officiel de l'événement | 0 % | ∅ |
Fréquence & budgets
- Cadence : horaire (watcher PM2, rotation d'artistes)
- Budgets / plafonds (variables d'environnement) :
| Variable | Défaut | Rôle |
|---|---|---|
BANDSINTOWN_APP_ID |
js_www.sorti-ka.com |
— |
BIT_ARTIST_MAX |
100 |
artistes/sync |
- 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-19 01:27 EDT dans data/sortika.db)
- Événements en base : 372 (dont 370 actifs)
- GPS : 370/370 actifs (100 %)
- Prix : 4/370 actifs (1 %)
- Heure (start_time) : 369/370 actifs (100 %)
- Heure de fin : 0/370 actifs (0 %)
- Statut (annulé/reporté/complet) : 0/370 actifs (0 %)
- Artistes : 370/370 actifs (100 %)
- Image : 27/370 actifs (7 %)
- Salle (venue) : 370/370 actifs (100 %)
- Dernier sync : 2026-08-19 01:16 — fetched 371, +0 ajoutés, ~371 mis à jour, -0 retirés
- Syncs enregistrés (sync_log) : 23
Erreurs & dépannage
Aucune erreur dans sync_log pour cette source. ✅
- L'API n'accepte que certains formats d'
app_id: le format widgetjs_www.sorti-ka.comest testé accepté (2026-08) ; un app_id arbitraire simple est refusé. - Rejouer un sync isolé :
python3 run.py sync --source bandsintown(ou via le watcher PM2) ; inspecter ensuitesync_log:sqlite3 data/sortika.db "SELECT * FROM sync_log WHERE source='bandsintown' ORDER BY ts DESC LIMIT 5;"
Licence / attribution
- API publique Bandsintown (app_id d'identification) — usage index + lien vers la fiche originale
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). - 2026-08-19 — Phase 2 (travail de moine) : colonnes additives
end_time,status(annulé/reporté/complet) etquarantine(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/bandsintown.py :
65d2d332026-08-18 Vague 2 d'enrichissement : heure précise, artistes, 3 nouveaux connecteurs