balados-itunes — connecteur decouverte (palier 2)
Fiche générée automatiquement par scripts/gen_connector_docs.py le 2026-08-18 16:14 — ne pas éditer à la main, régénérer.
État : actif · Famille : decouverte (discovery) · Backend : direct · Créateurs découverts : 460 · touchés : 460
Description de la source
Connecteur DÉCOUVERTE — balados québécois via l'API de recherche iTunes/Apple Podcasts (OFFICIELLE, gratuite, sans clé). Palier 2-3 (§9). Filtre conservateur : marqueur québécois requis dans le nom du balado ou de l'artiste.
- Notes (registre) : podcasteurs québécois : nom, artiste, pochette, genre, nb d'épisodes, flux RSS ; marqueur QC requis
- Signal d'identité : profil_source (0.98) (colonne
accounts.signal/confidence) - Module :
creaka/connectors/balados_itunes.py— classeBaladosItunesConnector(kind = "discovery")
Accès
- Accès (registre) : API de recherche iTunes/Apple Podcasts (officielle, gratuite, sans clé)
- Type d'accès (code) : API iTunes Search/Lookup (publique)
- Endpoint de base : https://itunes.apple.com/search
- URLs du module : https://itunes.apple.com/search
- Pagination : réponse unique (pas de pagination)
- Backend anti-bot / rendu : requests direct (session UA CreaKaBot, throttling poli)
- Politesse : 1.5 s entre requêtes, timeout 30 s, UA
CreaKaBot/1.0 (+https://www.crea-ka.com/bot) - Authentification : clé(s) API requise(s) — voir statut/registre
Champs récupérés → schéma cible
Source de découverte : produit des fiches Creator (tables creators + accounts). Complétude mesurée sur les 460 créateurs découverts par cette source (champ doc.source) ; exemple tiré d'une fiche réelle.
| Champ du doc créateur | Contenu | Renseigné | Exemple réel |
|---|---|---|---|
display_name |
Nom public | 100 % | Québec Nostalgie : le podcast |
bio |
Bio | 97 % | Fidèle à la page Instagram du même nom, Québec Nostalgie : le podcast est un véritable vo… |
region |
Région | 8 % | — |
city |
Ville | 8 % | — |
niches |
Niches (liste) | 100 % | actualite-opinion |
languages |
Langues (liste) | 100 % | fr |
creator_type |
Type de créateur | 100 % | podcasteur |
primary_platform |
Plateforme principale | 100 % | |
platforms |
Comptes sociaux (liste) | 100 % | instagram:@quebec_nostalgie, youtube:@UC10F7nTroeQocT2vqf2LoIw, podcast:@1741442896 |
avatar_url |
Avatar | 100 % | https://is1-ssl.mzstatic.com/image/thumb/Podcasts211/v4/3a/5f/12/3a5f1256-74a6-f716-ffb8-… |
total_reach |
Portée totale (abonnés cumulés) | 1 % | 109741 |
link_in_bio_url |
Lien-en-bio | 0 % | https://linktr.ee/QuebecNostalgie |
Cible d'enrichissement : colonnes de la table accounts pour la/les plateforme(s) podcast (462 comptes en BD, confiance moyenne 0.98).
Colonne accounts |
Contenu | Renseignée | Exemple réel |
|---|---|---|---|
handle |
Handle | 100 % | — |
url |
URL du profil | 100 % | — |
followers |
Abonnés | 0 % | — |
verified |
Badge vérifié | 0 % | — |
confidence |
Confiance d'identité | 100 % | — |
signal |
Signal d'identité | 100 % | — |
metrics |
Métriques détaillées (JSON) | 100 % | — |
last_checked |
Dernière vérification | 100 % | — |
Fréquence & budget
- Cadence déclarée (registre) : quotidienne (watch)
- Cadence observée (médiane sync_log) : ≈ 47 min
- Dernier passage : 2026-08-18T20:11:39Z — 460 créateurs, 460 comptes, +0 / ~460, 0 erreur(s), 224 s
- Throttling : 1.5 s entre requêtes (
request_delay)
Volumétrie & complétude
- Créateurs découverts par la source (
doc.source) : 460 · fiches touchées (source_ids) : 460 - Complétude clé (découverts) : niches 100 % · avatar 100 % · portée 1 % · région 8 %
- Comptes
podcasten BD : 462 — abonnés 0 % · métriques 100 % · dernière vérification 2026-08-18T20:11:39Z - Runs journalisés (60 derniers) : 10, dont 0 avec erreurs
Erreurs connues & dépannage
Aucune erreur ni alerte dans les 60 derniers runs journalisés.
Rejouer la source seule : python3 run.py sync balados-itunes · vérifier sync_log (SELECT * FROM sync_log WHERE source='balados-itunes' ORDER BY ts DESC LIMIT 5;).
Licence, attribution & conditions
- Cadre d'accès (registre) : API de recherche iTunes/Apple Podcasts (officielle, gratuite, sans clé)
- API publique utilisée selon ses conditions (pas de clé détournée, throttling poli) ; données limitées aux profils publics.
- Retrait sur demande : contact@spboucher.ai (opt-out honoré à la prochaine ingestion).
Historique
- 2026-08-17 — plus ancien passage journalisé dans
sync_log(fenêtre des 60 derniers). - 2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par
scripts/gen_connector_docs.py).