Backlinks-Modul

Das Backlinks-Modul ist Rankions DataForSEO-gestütztes Off-Page-Werkzeug. Du analysierst dein eigenes Backlink-Profil oder das beliebiger fremder Domains, erkennst toxische Verlinkungen, exportierst eine fertige Disavow-Liste für Google und beobachtest die Velocity über Zeit. Es gibt zwei Modi: Project-Mode (an Tracking-Project gebunden, täglicher Delta-Pull) und Quick-Pull / Lookup-Mode (ad-hoc Domain ohne Setup).

Was es kann

• Backlink-Projekte (Project-Mode) — Pro Tracking-Project ein Container. Täglicher Delta-Pull, Event-Log (gained/lost/attribute_changed), Distribution-Charts (dofollow/nofollow, Anchor-Verteilung, Referring-Domain-Quality).
• Quick-Pull mit Komplette Analyse — Domain eingeben, optionaler Checkbox „Komplette Analyse" (default ON) dispatcht zusätzlich den Spam-Score-Enrichment-Job. Fast-Path: wenn DfsBacklinkSummary < 1h alt, wird sofort zurückgegeben statt neu zu pullen.
• Spam-Score-Enrichment — EnrichSpamScoresJob checkt Spam-Scores in 1000er-Chunks via DFS-Bulk-API. Recheck nach 30 Tagen. Threshold 80 = is_toxic=true. Dual-Mode: BacklinkProject ODER ad-hoc target+team.
• Toxic-Page Detection + Disavow-Export — UI-Tabelle aller toxischen Domains mit Filter min_spam, plus disavow.txt-Download (Google-Format) und CSV/Excel-Export für eigenes Tooling.
• Manueller Enrichment-Trigger — Empty-State zeigt „Spam-Analyse jetzt starten"-Button, In-Progress-Indicator pollt alle 10 s. Funktioniert in Lookup- und Project-Mode.
• Timeseries-Charts — historische Velocity (gained/lost) über 12 Monate, daily/weekly/monthly switchbar. Quelle: DFS, nicht eigene Event-DB.
• Detailed Anchors — per-Anker Metadaten (dofollow/nofollow Split, first_seen, last_seen) statt heuristischer Aggregation.

Wann nutzen

• Du hast einen unerklärlichen Ranking-Drop und willst ausschließen, dass toxische Links die Ursache sind.
• Du willst die Disavow-Liste deines Wettbewerbers verstehen oder deine eigene aktualisieren.
• Du planst einen Linkbuilding-Sprint und brauchst eine Baseline.
• Du willst eine Domain ad-hoc prüfen (Vendor-Recherche, Akquise-Target) ohne Setup-Aufwand.

Workflow

1. Project-Mode aktivieren — POST /backlinks für ein bestehendes Tracking-Project (Subscription required).
2. Erste Pulls anstoßen — POST /backlinks/{project}/full-refresh (kostet 5000 DFS-Credits, lädt bis zu 10k Referring Domains).
3. Spam-Enrichment — POST /backlinks/{project}/spam-scores/refresh queued den EnrichSpamScoresJob.
4. Anchors detailliert — POST /backlinks/{project}/anchors/refresh ersetzt die Heuristik durch echte DFS-Daten.
5. Toxic prüfen — UI unter /backlinks/{project}/toxic oder GET /backlinks/{project}/spam-scores?min_spam=60.
6. Disavow herunterladen — GET /backlinks/{project}/disavow-export?threshold=80 liefert die Google-Disavow.txt.

Quick-Pull-Variante: POST /backlinks/by-domain/{domain}/pull für jede Domain — kein Tracking-Project nötig. Drilldown unter /backlinks/by-domain/{domain}/toxic.

API

Credits & Limits

• Activate / Read-Endpoints: keine Rankion-Credits, aber Backlinks-Subscription auf Team-Ebene erforderlich (Tier definiert Limits).
• Full-Refresh: ~5000 DFS-Credits pro Pull (10 Pages × 1000 Referring Domains). Manuell triggern, nicht per Cron.
• Delta-Pull: läuft täglich automatisch via DispatchDueBacklinkDeltasJob Scheduler. Geringe Kosten.
• Spam-Enrichment: in 1000er-Chunks. Recheck nur alle 30 Tage pro Domain.
• Quick-Pull Fast-Path: wenn DfsBacklinkSummary < 1h alt, wird ohne neuen DFS-Call zurückgegeben.
• Ein Abruf ohne Ergebnis kostet nichts. Findet der Datenanbieter zu einer Domain keine Backlinks — weil sie ihm nicht bekannt ist, weil sie falsch geschrieben wurde oder weil die Seite so neu ist, dass noch niemand auf sie verlinkt —, werden dir dafür keine Credits abgebucht. Statt einer leeren Tabelle ohne Erklärung steht dann im Backlink Monitor, woran es lag; derselbe Hinweis bleibt in der Liste „Überwachte Domains" stehen, auch nachdem du die Seite neu geladen hast. Dasselbe gilt, wenn ein Abruf technisch scheitert, etwa weil das Kontingent beim Datenanbieter aufgebraucht ist.
• Subscription-Status: wird über BacklinksSubscriptionDetector geprüft. 40204 Access-Denied flippt Status auf inactive.

Verwandte Module

• AI-Visibility Tracking — Cross-Modul-Korrelation: GET /tracking-projects/{id}/correlation verknüpft Backlink-Velocity mit AVI-Trend (Pearson, 30d) — moderate positive Korrelation = Backlinks beeinflussen AVI.
• Agentic Chat — „Welche Backlinks sind in 30 Tagen verloren gegangen und sind toxisch?".
• Plattform-Übersicht — Modul-Zusammenspiel.