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