# `instagram-decouverte` — connecteur decouverte (palier 4)

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

Connecteurs Apify MAISON — acteurs KA (~/Desktop/ka-apify-actors, compte gorgeous_thistle) exécutés sur la plateforme Apify avec proxy RÉSIDENTIEL : enrichissement ULTRA DÉTAILLÉ (abonnés, bio, badges, contenu récent avec métriques, engagement) pour Instagram, TikTok, X, Facebook, Threads et Snapchat + découverte Instagram (topsearch). Un passage = UN run d'acteur par plateforme (lot de handles), au lieu d'une requête Scrapfly par profil — moins cher, plus fiable (IP résidentielles + empreinte TLS Chrome côté acteur).

Notes (registre) : découverte de créateurs IG par mots-clés québécois
Signal d'identité : profil_source (0.98) (colonne accounts.signal / confidence)
Module : creaka/connectors/apify_social.py — classe InstagramDecouverteApify (kind = "discovery")

# Accès

Accès (registre) : acteur Apify maison ka-instagram mode recherche (topsearch web public, proxy résidentiel)
Type d'accès (code) : API JSON
Endpoint de base : https://api.apify.com/v2
URLs du module : https://api.apify.com/v2 · https://instagram.com/{} · https://x.com/{} · https://youtube.com/{}
Pagination : pagination par offset
Backend anti-bot / rendu : requests direct (session UA CreaKaBot, throttling poli)
Politesse : 0.8 s entre requêtes, timeout 30 s, UA CreaKaBot/1.0 (+https://www.crea-ka.com/bot)
Authentification : aucune — contenu public / API anonyme

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

Aucune donnée attribuable à cette source en BD pour l'instant (clés manquantes ou source en attente) — schéma cible : creators + accounts.

# Fréquence & budget

Cadence déclarée (registre) : quotidienne (40 requêtes tournantes sur ~160 combinaisons thème x QC)
Cadence observée (médiane sync_log) : —
Throttling : 0.8 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
Runs journalisés (60 derniers) : 0, 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 instagram-decouverte · vérifier sync_log (SELECT * FROM sync_log WHERE source='instagram-decouverte' ORDER BY ts DESC LIMIT 5;).

# Licence, attribution & conditions

Cadre d'accès (registre) : acteur Apify maison ka-instagram mode recherche (topsearch web public, proxy résidentiel)
Profils publics uniquement : UA identifiable CreaKaBot/1.0 (+https://www.crea-ka.com/bot; contact@spboucher.ai), throttling poli, respect des opt-out (data/optout.json) et du volet éthique (creaka/ethics.py — mineurs exclus via is_minor).
Retrait sur demande : contact@spboucher.ai (opt-out honoré à la prochaine ingestion).

# Historique

2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par scripts/gen_connector_docs.py).

# instagram-decouverte — connecteur decouverte (palier 4)