# palmares-apple — 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 : 0 · touchés : 0

# Description de la source

Connecteur DÉCOUVERTE — balados québécois dans le TOP 100 canadien d'Apple Podcasts. Mode d'accès : API marketing officielle d'Apple (rss.marketingtools.apple.com, gratuite, sans clé) + lookup iTunes groupé + tête de flux RSS pour l'attribution QC. Palier 2 (§9). V3.

• Notes (registre) : vague 3 — balados QC qui percent dans le top 100 CA (metrics.chart_rank_ca). Palmarès évalués 2026-08-18 : Spotify podcastcharts → API morte (HTTP 500) ; ADISQ → SPA JavaScript + artistes sans liens sociaux ; Bible urbaine → articles en prose sans handles (liaison ambiguë interdite §12) → Apple retenu. Fusion naturelle avec balados-itunes (même clé podcast:collectionId)
• Signal d'identité : profil_source (0.98) (colonne accounts.signal / confidence)
• Module : creaka/connectors/palmares_apple.py — classe PalmaresAppleConnector (kind = "discovery")

# Accès

• Accès (registre) : API marketing OFFICIELLE d'Apple (rss.marketingtools.apple.com, top 100 podcasts Canada, sans clé) + lookup iTunes groupé + tête de flux RSS pour l'attribution QC
• Type d'accès (code) : API iTunes Search/Lookup (publique)
• Endpoint de base : https://itunes.apple.com/lookup
• URLs du module : https://rss.marketingtools.apple.com/api/v2/ca/podcasts/ · https://itunes.apple.com/lookup
• Pagination : réponse unique (pas de pagination)
• Backend anti-bot / rendu : requests direct (session UA CreaKaBot, throttling poli)
• Politesse : 1.0 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

Cible d'enrichissement : colonnes de la table accounts pour la/les plateforme(s) podcast (462 comptes en BD, confiance moyenne 0.98).

# Fréquence & budget

• Cadence déclarée (registre) : quotidienne (watch) — le palmarès bouge chaque jour
• Cadence observée (médiane sync_log) : ≈ 21 min
• Dernier passage : 2026-08-18T10:35:47Z — 0 créateurs, 0 comptes, +0 / ~0, 0 erreur(s), 209 s
• Throttling : 1.0 s entre requêtes (request_delay)

# Volumétrie & complétude

• Créateurs découverts par la source (doc.source) : 0 · fiches touchées (source_ids) : 0
• Comptes podcast en BD : 462 — abonnés 0 % · métriques 100 % · dernière vérification 2026-08-18T20:11:39Z
• Runs journalisés (60 derniers) : 3, dont 0 avec erreurs

# Erreurs connues & dépannage

Rejouer la source seule : python3 run.py sync palmares-apple · vérifier sync_log (SELECT * FROM sync_log WHERE source='palmares-apple' ORDER BY ts DESC LIMIT 5;).

# Licence, attribution & conditions

• Cadre d'accès (registre) : API marketing OFFICIELLE d'Apple (rss.marketingtools.apple.com, top 100 podcasts Canada, sans clé) + lookup iTunes groupé + tête de flux RSS pour l'attribution QC
• 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-18 — date mentionnée au registre (voir notes/statut).
• 2026-08-18 — 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).