Module Backlinks

Le module Backlinks est l'outil off-page de Rankion adossé à DataForSEO. Tu analyses ton propre profil de backlinks ou celui de n'importe quel domaine externe, tu détectes les liens toxiques, tu exportes une liste de désaveu prête pour Google et tu observes la velocity dans le temps. Il y a deux modes : Project-Mode (lié à un tracking-project, pull delta quotidien) et Quick-Pull / Lookup-Mode (domaine ad-hoc sans setup).

Ce qu'il peut faire

• Projets de backlinks (Project-Mode) — Un conteneur par tracking-project. Pull delta quotidien, event-log (gained/lost/attribute_changed), distribution-charts (dofollow/nofollow, distribution des ancres, qualité des referring domains).
• Quick-Pull avec Analyse complète — Saisis un domaine, la checkbox optionnelle « Analyse complète » (par défaut ON) dispatch en plus le job d'enrichissement spam-score. Fast-Path : si DfsBacklinkSummary < 1h, retour immédiat au lieu d'un nouveau pull.
• Enrichissement spam-score — EnrichSpamScoresJob vérifie les spam-scores en chunks de 1000 via DFS Bulk-API. Recheck après 30 jours. Threshold 80 = is_toxic=true. Mode dual : BacklinkProject OU target+team ad-hoc.
• Détection de pages toxiques + export désaveu — Tableau UI de tous les domaines toxiques avec filtre min_spam, plus téléchargement disavow.txt (format Google) et export CSV/Excel pour ton outillage.
• Trigger d'enrichissement manuel — L'empty-state affiche un bouton « Lancer l'analyse spam », l'indicateur in-progress poll toutes les 10 s. Fonctionne en Lookup et Project-Mode.
• Charts timeseries — velocity historique (gained/lost) sur 12 mois, switchable daily/weekly/monthly. Source : DFS, pas la DB d'event interne.
• Detailed Anchors — métadonnées par ancre (split dofollow/nofollow, first_seen, last_seen) au lieu d'une agrégation heuristique.

Quand l'utiliser

• Tu as une chute de ranking inexpliquée et tu veux exclure que des liens toxiques en soient la cause.
• Tu veux comprendre la liste de désaveu de ton concurrent ou actualiser la tienne.
• Tu planifies un sprint de linkbuilding et tu as besoin d'une baseline.
• Tu veux vérifier un domaine ad-hoc (recherche fournisseur, target d'acquisition) sans setup.

Workflow

1. Activer Project-Mode — POST /backlinks pour un tracking-project existant (subscription requise).
2. Lancer les premiers pulls — POST /backlinks/{project}/full-refresh (coûte 5000 crédits DFS, charge jusqu'à 10k referring domains).
3. Enrichissement spam — POST /backlinks/{project}/spam-scores/refresh queue le EnrichSpamScoresJob.
4. Anchors détaillés — POST /backlinks/{project}/anchors/refresh remplace l'heuristique par les vraies données DFS.
5. Vérifier toxic — UI sous /backlinks/{project}/toxic ou GET /backlinks/{project}/spam-scores?min_spam=60.
6. Télécharger disavow — GET /backlinks/{project}/disavow-export?threshold=80 livre le disavow.txt Google.

Variante Quick-Pull : POST /backlinks/by-domain/{domain}/pull pour n'importe quel domaine — pas besoin de tracking-project. Drilldown sous /backlinks/by-domain/{domain}/toxic.

API

Crédits et limites

• Activate / endpoints de lecture : pas de crédits Rankion, mais une subscription Backlinks au niveau équipe est requise (le tier définit les limites).
• Full-Refresh : ~5000 crédits DFS par pull (10 pages × 1000 referring domains). Déclencher manuellement, pas via cron.
• Delta-Pull : tourne quotidiennement automatiquement via le scheduler DispatchDueBacklinkDeltasJob. Coûts faibles.
• Enrichissement spam : par chunks de 1000. Recheck uniquement tous les 30 jours par domaine.
• Quick-Pull Fast-Path : si DfsBacklinkSummary < 1h, renvoyé sans nouvel appel DFS.
• Un pull sans résultat ne coûte rien. Si le fournisseur de données ne trouve aucun backlink pour un domaine — parce qu'il ne le connaît pas, parce qu'il a été mal orthographié, ou parce que le site est si récent que personne n'y a encore fait de lien —, aucun crédit ne t'est débité. Au lieu d'un tableau vide sans explication, le Backlink Monitor indique alors la raison ; la même mention reste affichée dans la liste « Domaines surveillés », même après avoir rechargé la page. Il en va de même si un pull échoue techniquement, par exemple parce que le quota du fournisseur de données est épuisé.
• Statut subscription : vérifié via BacklinksSubscriptionDetector. 40204 access-denied bascule le statut sur inactive.

Modules associés

• AI-Visibility Tracking — corrélation cross-modules : GET /tracking-projects/{id}/correlation lie la velocity backlink au trend AVI (Pearson, 30j) — corrélation positive modérée = les backlinks influencent l'AVI.
• Agentic Chat — « Quels backlinks ont été perdus en 30 jours et sont toxiques ? ».
• Aperçu plateforme — interaction entre modules.