Competitor Analysis

Competitor Analysis décompose un domaine concurrent sur deux niveaux : sur quoi rankent-ils que tu ne rankes pas (content gaps), et dans quels topic clusters sont-ils forts, dans lesquels sont-ils faibles. Tu obtiens une liste priorisée de gaps avec volume de recherche, difficulté et un opportunity score, plus une carte des topic clusters qui montre où la concurrence bâtit son autorité thématique. C'est le pont entre le pull pur de mots-clés (Keyword Explorer & Research) et la planification stratégique de contenu — tu vois non pas que des mots-clés, mais où ton univers thématique a des trous.

Ce qu'il peut faire

• Domain Deep Scan — pull complet de visibilité par domaine concurrent y compris les top URLs rankées.
• Détection de content gaps — mots-clés sur lesquels la concurrence rank et toi non.
• Opportunity Score — ranking pondéré issu de Volume × Difficulté × Position concurrent.
• Topic Cluster Mapping — les gaps sont regroupés en thèmes, pas servis en liste plate de mots-clés.
• Filtres — réduire les gaps par topic cluster, score minimum, volume minimum.
• Re-Rank — réévaluer les concurrents au sein d'une analyse sans nouveau pull.
• Pipeline async — le pull tourne en queue job, les grands domaines prennent plusieurs minutes.

Quand l'utiliser

• Tu planifies une stratégie de contenu et tu veux savoir où la concurrence te dépasse.
• Tu as besoin d'une liste priorisée de nouveaux thèmes d'articles avec potentiel de trafic prouvé.
• Tu veux dériver des topic clusters pour tes Storylines à partir de vraies données SERP.
• Tu démarres dans une nouvelle niche et tu as besoin d'une carte de la concurrence.

Workflow

1. Lancer l'analyse — POST /competitor-analyses avec {project_id, domain}. Réponse 202.
2. Le pull tourne en background — DataForSEO + moteur de cluster interne, dure 2–10 minutes selon la taille du domaine.
3. Lire le détail — GET /competitor-analyses/{id} montre l'aperçu + top clusters.
4. Driller les gaps — GET /competitor-analyses/{id}/gaps avec ?topic_cluster= et ?min_score= pour filtrer.
5. Re-Rank optionnel — POST /competitor-analyses/{id}/rerank-competitors si tu veux ajuster la pondération.
6. Suite — étendre les top gap-keywords dans Keyword Explorer & Research ou directement en briefings dans AI Content Editor.

API

Exemple de body POST /competitor-analyses :

{
  "project_id": 42,
  "domain": "konkurrenz-domain.de"
}

Crédits et limites

• Démarrage : 20 crédits par run d'analyse.
• Le pull est async — 202 direct, résultat par polling.
• Le re-rank est gratuit (recalcul purement interne).
• Les très grands domaines (sites enterprise) sont cappés sur les top N mots-clés — le cap dépend du plan.

Modules associés

• Content Audit — confronter ton inventaire de site à la liste de gaps.
• Keyword Explorer — vérifier volume / KD des gap-keywords trouvés et les étendre.
• Storylines — condenser les topic clusters en plans de contenu structurés.
• Rank Tracker — observer les nouveaux mots-clés après publication.