# evenko — grands concerts et festivals (`evenko`)

> 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 : `promoteur` · Connecteur : `sortika/connectors/evenko.py`

## Description

- **Source** : [evenko — grands concerts et festivals](https://evenko.ca/fr/evenements)
- **Couverture** : Grands concerts (Centre Bell, Place Bell, MTELUS…), festivals (Osheaga, ÎleSoniq…)
- **Extraction** : API /api/search (proxy Algolia) — format percé : GET ?body=base64({params:[query,options],lang:'fr-CA'}), filters entity_type:evenko_show, ~5 requêtes/sync ; heure locale du spectacle via show_time (epoch → America/Montreal, respect de hide_show_time) ; artistes = champ headliners explicite ; gratuité : champ free (sondé null sur 100 % des hits, 2026-08) + étiquettes « gratuit » (event_tag/promotional_tag) ; aucun montant exposé par l'index

## Accès

- **Type** : promoteur
- **Endpoint** (`API`) : `https://evenko.ca/api/search`
- **Auth** : Aucune (accès public, identification honnête par User-Agent)
- **Pagination** : par numéro de page
- **Backend** : GET direct `requests` (throttlé, UA `SortiKa/1.0` identifié)
- **Accès légal** : robots.txt : Allow /api/search* (explicite) — lien billets = URL Ticketmaster officielle

<details><summary>En-tête documentaire du connecteur</summary>

> connectors/evenko.py : connecteur evenko — grands concerts & festivals
> Source    : evenko.ca (promoteur : Centre Bell, Place Bell, MTELUS, Osheaga…)
> Extraction: endpoint /api/search (proxy Algolia interne) — EXPLICITEMENT
> permis par robots.txt (« Allow: /api/search* »). Format percé
> dans leur bundle JS : GET ?body=base64(JSON{params:[query,
> options], lang:"fr-CA"}). ~14 requêtes/sync (100 hits/page).
> Accès     : robots.txt Allow /api/search* ; GET throttlés, identification
> honnête ; lien billets = URL Ticketmaster officielle du hit.
> Prix      : champ `free` de la source → is_free, MAIS sondé null sur
> 100 % des hits (462/462, vérifié 2026-08) et l'index ne porte
> aucun montant (additional_information.regular_ticket = libellés
> + URLs Ticketmaster seulement, filtre free:true → 0 hit).
> Complément honnête : étiquettes explicites « gratuit » dans
> event_tag / promotional_tag → is_free=True. On n'invente rien.

</details>

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

Complétude mesurée sur les **421 événements actifs** de la source ; exemples tirés d'un événement réel (`evenko:e008791`).

| Champ (`events.*`) | Description | Complétude | Exemple réel |
|---|---|---|---|
| `title` — Titre | titre de l'événement | 100 % | Disney Sur Glace présente La Magie en Famille |
| `description` — Description | texte descriptif (source ou fiche détail) | 18 % | ∅ |
| `url` — URL | lien vers la fiche originale / billetterie | 100 % | https://www.ticketmaster.ca/event/310064E3C5686712?lang=fr-ca&brand=placebell |
| `categories` — Catégories | taxonomie canonique Sorti-Ka (JSON) | 100 % | ["autre"] |
| `venue` — Salle (venue) | nom du lieu | 100 % | Place Bell |
| `address` — Adresse | adresse civique | 0 % | ∅ |
| `city` — Ville | municipalité | 100 % | Laval |
| `region` — Région | région administrative | 100 % | Laval |
| `lat` — GPS (lat/lng) | coordonnées géographiques | 77 % | 45.5558423, -73.7216633 |
| `start_date` — Date début | date locale AAAA-MM-JJ | 100 % | 2026-12-17 |
| `end_date` — Date fin | date locale AAAA-MM-JJ | 100 % | 2026-12-17 |
| `start_time` — Heure (start_time) | heure locale HH:MM (Québec) | 99 % | 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) | 99 % | ["Disney Sur Glace présente La Magie en Famille"] |
| `organizer` — Organisateur | promoteur / organisme | 100 % | evenko |
| `image` — Image | visuel (og:image ou média source) | 100 % | https://images.ctfassets.net/3yxl57nu0yl4/3sI9AuDa7Ju1B2dtmFzVtY/a977ac5c95df131068a94762069db2f… |
| `website` — Site web | site officiel de l'événement | 0 % | ∅ |

## Fréquence & budgets

- **Cadence** : horaire (watcher PM2)
- **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** : 423 (dont **421 actifs**)
- **GPS** : 326/421 actifs (77 %)
- **Prix** : 0/421 actifs (0 %)
- **Heure (start_time)** : 418/421 actifs (99 %)
- **Artistes** : 418/421 actifs (99 %)
- **Image** : 421/421 actifs (100 %)
- **Salle (venue)** : 421/421 actifs (100 %)
- **Dernier sync** : 2026-08-18 04:55 — fetched 421, +0 ajoutés, ~0 mis à jour, -2 retirés
- **Syncs enregistrés** (sync_log) : 20

## Erreurs & dépannage

Aucune erreur dans `sync_log` pour cette source. ✅

- Rejouer un sync isolé : `python3 run.py sync --source evenko` (ou via le watcher PM2) ; inspecter ensuite `sync_log` : `sqlite3 data/sortika.db "SELECT * FROM sync_log WHERE source='evenko' ORDER BY ts DESC LIMIT 5;"`

## Licence / attribution

- robots.txt : Allow /api/search* (explicite) — lien billets = URL Ticketmaster officielle

## 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).

Commits touchant `sortika/connectors/evenko.py` :

- `65d2d33` 2026-08-18 Vague 2 d'enrichissement : heure précise, artistes, 3 nouveaux connecteurs
- `7d9d1b0` 2026-08-18 Enrichissement des connecteurs + géocodage des salles
- `9164456` 2026-08-17 Sorti·Ka v1 — agrégateur de sorties & événements du Québec