Referenz
Referenz zur Backlinks-API: Aktionen, Kosten und Fehler
Eine Seite mit den Fakten, die ein Monitor benötigt: Was jede Aktion kostet, wie die Paginierung funktioniert und wie die API reagiert, wenn etwas schiefgeht.

Aktionen nach Kreditkosten
| Kosten | Aktionen | Hinweise |
|---|---|---|
| Kostenlos, kein Key erforderlich | domain, overview, stats, suggest | Gut für Dashboards und den DR-Checker |
| 1 Kredit | bulk_dr, compare, top, dr_distribution, tld_breakdown | bulk_dr verarbeitet bis zu 2.000 Domains (GET domains= oder POST-Body); compare bis zu 20 |
| 2 Kredite | refdomains, backlinks, anchors, toppages, anchor_cloud, intersect | intersect benötigt 2 bis 10 Domains |
| 3 Kredite | search, keyword | Volltextsuche über Anchors, Titel und URLs; keyword findet, wer mit einem exakten Anchor verlinkt ist |
Authentifizierung und Statuscodes
Übergeben Sie den Key als key= oder als Bearer-Header. Prüfen Sie den HTTP-Statuscode, bevor Sie den Body parsen.
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://seouptr.com/api.php?action=anchors&q=yourdomain.com&per=100"
# a cron-safe wrapper
code=$(curl -s -o out.json -w '%{http_code}' "$URL")
case "$code" in
200) jq '._credits' out.json ;; # cost and remaining balance
401) echo 'bad or missing key' ;;
402) echo 'out of credit: top up' ;;
*) echo "unexpected $code" ;;
esacParameter und Fehler
| Element | Wert | Bedeutung |
|---|---|---|
q | eine Domain | Das Ziel der Abfrage |
page, per | per von 10 bis 5000 | Paginierung; Zeilen pro Aufruf sind auf 1.000 begrenzt, tiefe Paginierung auf 50.000 |
sort, order | order=asc oder desc | Sortierung der zurückgegebenen Zeilen |
ok | in jeder Antwort | Ob der Aufruf erfolgreich war |
_credits | nur bei authentifizierten Antworten | Kosten des Aufrufs und verbleibender Saldo |
| HTTP 401 | fehlender oder falscher Key | Prüfen Sie den Key oder Header |
| HTTP 402 | Kredite aufgebraucht | Aufladen mit USDT (TRC-20) |

Den Aufruf vor der Planung vorbereiten
Die meisten API-Probleme beginnen in der Anfrage, nicht in der Antwort. Eine SEO-Backlinks-API-Integration besteht hauptsächlich aus einer Reihe kleiner Entscheidungen vor dem ersten Aufruf. Klären Sie zuerst den Key, die Seitengröße und die Sortierreihenfolge.
Halten Sie den Key aus dem Skript
Speichern Sie den Key in einer Umgebungsvariable oder einem Secret-Store, nicht in einer Datei, die Sie committen. Übergeben Sie ihn als key-Parameter oder als Bearer-Header. Der Header hält den Key aus URLs fern, die tendenziell in Logs landen.
Fügen Sie keinen Live-Key in ein Ticket oder einen Chat ein. Behandeln Sie einen Key, der in einem gemeinsamen Log erscheint, als exponiert.
Wählen Sie die Seitengröße bewusst
Der Parameter per reicht von 10 bis 5000, aber ein Aufruf wird einmal für bis zu 1.000 Zeilen abgerechnet, daher bedeuten größere Seiten weniger Gebühren. Nehmen wir an, Sie benötigen 3.400 Zeilen. Das erfordert vier Aufrufe mit 1.000 Zeilen, nicht 340 Aufrufe mit 10.
Halten Sie die Seitengröße über verschiedene Durchläufe hinweg gleich, damit die Dateien übereinstimmen.
Fixieren Sie die Sortierreihenfolge
Legen Sie sort und order explizit fest, anstatt sich auf einen Standardwert zu verlassen. Identische Parameter machen die Ausgabe von Woche zu Woche vergleichbar, sodass ein Diff echte Änderungen und nicht nur neu sortierte Zeilen anzeigt.
Eine geänderte Reihenfolge ist ein einfacher Weg, um einen Fehlalarm zu erzeugen.
Die Zahlen lesen
Die Daten stammen aus unserem eigenen Link-Graphen: 181.132.097 Domains, 2.774.625.913 Domain-zu-Domain-Links und etwa 798,5 Milliarden Backlinks. Er wird etwa einmal im Monat aktualisiert. Alles, was neuer ist, ist darin noch nicht enthalten, weshalb eine SEO-Backlinks-API am besten wöchentlich abgefragt werden sollte.
DR ist round(100 · log(ref_domains+1) / log(2·10^7)). Es ist ein Logarithmus. Daher haben 100 verweisende Domains den Wert 27, 1.000 den Wert 41 und 10.000 den Wert 55. Das Verdoppeln Ihrer Link-Anzahl fügt also nur wenige Punkte hinzu. Nutzen Sie DR, um Websites gegeneinander zu ranken, und die Rohzahl für Alerts, wie es die Schweregradtabelle tut.
Die Preisgestaltung ist prepaid. Es gibt kein Abonnement und kein Minimum. Der Anmeldebonus beträgt $100, was 1.000.000 Krediten entspricht. Vergleichen Sie dies mit Ahrefs API-Einheiten, die in Plänen ab $129/Monat für 200.000 Einheiten verkauft werden, wobei mindestens 50 Einheiten pro Anfrage anfallen.
Die Kostenplanung ist einfache Multiplikation. Ein wöchentlicher refdomains-Aufruf für eine Site kostet 2 Kredite mal 4, also 8 Kredite im Monat, was $0,0008 entspricht. Zehn Sites kosten das Zehnfache. Das Lost-Link-Rezept und der Competitor-Job verwenden nur Aktionen aus der obigen Tabelle.
Einen Fehler lesen, ohne zu raten
Ein Fehlercode sagt Ihnen, wer handeln muss. Lesen Sie ihn so. Die Antwort wird dann zu einer Routing-Entscheidung, nicht zu einem Rätsel. Die beiden Codes, die für einen Monitor am wichtigsten sind, sind 401 und 402.
401 und 402 sind unterschiedliche Probleme
Ein 401 bedeutet, dass der Key fehlt oder falsch ist, und nichts wird erfolgreich sein, bis jemand das behebt. Ein 402 bedeutet, dass dem Konto Kredite fehlen, und ein Aufladen behebt das. Leiten Sie sie an verschiedene Verantwortliche weiter, damit die richtige Person die Nachricht sieht.
Senden Sie beide an eine Person. Ein Monitor, der stillschweigend fehlschlägt, ist schlimmer als einer, der nie lief.
Den Status vor dem Body prüfen
Lesen Sie zuerst den HTTP-Status und dann das Feld ok. Eine Antwort kann als JSON parsen sein und dennoch einen Fehler enthalten, daher ist die Prüfung erst abgeschlossen, wenn beide bestanden haben. Protokollieren Sie den Status bei jedem Durchlauf, auch bei den erfolgreichen.
Nur wiederholen, was sich erholen kann
Ein 401 wiederholt zu versuchen, verschwendet Aufrufe und füllt Logs mit demselben Fehler. Ein Netzwerk-Timeout ist anders. Wiederholen Sie es eine kleine Anzahl von Malen mit einer Pause zwischen den Versuchen, und hören Sie dann auf.
Ein Durchlauf, der stoppt und alarmiert, ist nützlicher als eine Retry-Schleife, die den Fehler verbirgt, bis der Saldo aufgebraucht ist.
Den Status bei jedem Durchlauf protokollieren
Schreiben Sie den HTTP-Status und den Saldo bei jedem Durchlauf ins Log, einschließlich der erfolgreichen. Wenn ein Durchlauf drei Wochen später fehlschlägt, ist diese Zeile das Erste, was Sie sehen möchten.
domain, overview, stats und suggest benötigen keinen Key und kosten nichts. Nutzen Sie sie, um eine Domain, eine genaue Schreibweise oder eine grobe Größe zu überprüfen, bevor Sie einen Kredit für eine kostenpflichtige Aktion ausgeben.
Bevor Sie einen Aufruf in Cron einplanen
- Die Kosten der Aktion sind bekannt und werden mit der Anzahl der Durchläufe pro Monat multipliziert.
- Exit-Code und HTTP-Status werden beide geprüft.
- Ein 402 sendet einen Alert an einen Menschen.
- Antworten werden sortiert gespeichert, damit Diffs sauber bleiben.
- Die Häufigkeit entspricht der monatlichen Aktualisierung.

Hinweise zur Paginierung
Die Reihenfolge ist wichtig. Verwenden Sie per=1000 für Snapshots und behalten Sie jede Woche dieselbe sort und order bei. Wenn sich die Reihenfolge zwischen den Durchläufen ändert, zeigt ein Diff Rauschen an. Das ist eine klassische Ursache für Fehlalarme.
Größere Sites? Für eine Site mit mehr als 1.000 verweisenden Domains paginieren Sie mit page=1, page=2 usw. Jede Seite ist ein separater abgerechneter Aufruf. Die tiefe Paginierung ist auf 50.000 Zeilen begrenzt, was fast jede normale Site abdeckt.
Fragen zur Referenz
- Welche Aktion sollte ich zuerst aufrufen, wenn ich nicht sicher bin, wie eine Domain aussieht?
- Beginnen Sie mit
overviewoderdomain. Beide sind kostenlos und benötigen keinen Key, und sie zeigen eine grobe Größe und die grundlegende Struktur der Daten. Geben Sie Kredite erst fürrefdomainsoderanchorsaus, nachdem Sie das getan haben. - Was kostet eine vollständige Prüfung einer Domain?
- Addieren Sie die Kredite jeder Aktion und multiplizieren Sie sie mit der Häufigkeit der Ausführung. Stellen Sie sich einen
refdomains-Aufruf, einenanchors-Aufruf und einentld_breakdown-Aufruf für eine Domain wöchentlich vor. Das sind 2 + 2 + 1 = 5 Kredite pro Durchlauf, oder $0,0005. Über vier Wochen summiert sich das auf etwa $0,002. - Warum stimmen zwei Zählwerte für dieselbe Domain möglicherweise nicht überein?
- Vergleichen Sie Gleiches mit Gleichem: dieselbe Aktion, dieselben Parameter und denselben Aktualisierungszeitraum. Zählwerte aus verschiedenen Aktionen sind nicht austauschbar, und ein Zählwert, der während einer Aktualisierung aufgenommen wird, kann sich von einem unterscheiden, der eine Woche später aufgenommen wird.
- Wie teste ich einen Cron-Job, ohne Kredite auszugeben?
- Führen Sie zuerst die kostenlosen Aktionen aus, um die Verkabelung, die Fehlerbehandlung und das Ausgabeformat zu überprüfen. Führen Sie dann einen kostenpflichtigen Aufruf durch, um die Zahlen zu beweisen, und begrenzen Sie den Job auf einen einzelnen Durchlauf während des Tests.
- Funktioniert die Paginierung für eine Site mit mehr als 1.000 verweisenden Domains?
- Ja. Verwenden Sie
pagemitper. Jede Seite ist ein separater abgerechneter Aufruf, und die tiefe Paginierung ist auf 50.000 Zeilen begrenzt, was die meisten normalen Sites abdeckt.
Ein Monitor, der eine schlechte Woche übersteht
Ein Monitor gewinnt Vertrauen in den Wochen, in denen nichts richtig läuft. Planen Sie eine langsame Antwort, einen geänderten Saldo und ein teilweise Ergebnis ein, bevor der erste Durchlauf stattfindet. Das sind normale Ereignisse. Jedes sollte eine klare Zeile im Log hinterlassen.
Timeouts und teilweise Abrufe
Legen Sie ein Timeout für jeden Aufruf fest, damit eine langsame Antwort den gesamten Job nicht blockiert. Wenn eine Seite eines Multi-Page-Abrufs fehlschlägt, notieren Sie, welche Seite es war, und starten Sie dort neu. So vermeiden Sie, doppelt für Zeilen zu zahlen, die Sie bereits haben.
Markieren Sie eine teilweise Datei als teilweise, anstatt sie als normalen Snapshot zu speichern. Andernfalls zeigt der nächste Diff einen Verlust an, der nie stattgefunden hat.
Saldo-Prüfungen
Lesen Sie _credits bei jeder authentifizierten Antwort und schreiben Sie den verbleibenden Saldo ins Log. Ein kleines Skript kann ihn mit einem von Ihnen gewählten Schwellenwert vergleichen und eine Warnung senden, bevor der nächste Durchlauf stattfindet.
Sagen wir, der Schwellenwert beträgt 500 Kredite. Ein wöchentlicher Durchlauf, der 40 Kredite kostet, lässt Spielraum, um aufzuladen, bevor ein 402 mitten in der Nacht eintrifft.
Halten Sie jeden Job langweilig
Geben Sie jedem Job eine Datei und einen Zeitplan. Ein Cron-Eintrag, der drei Dinge tut, kann auf drei Arten fehlschlagen, und das Log kann nicht immer sagen, welcher aufgetreten ist. Zwei kleine Jobs sind vertrauenswürdiger als einer, der clever ist.
Den Zeitplan an die Aktualisierung anpassen
Passen Sie den Zeitplan des Jobs an die monatliche Aktualisierung an und nicht an die Uhrzeit. Ein täglicher Durchlauf liefert an den meisten Tagen dieselbe Datei, was Kosten und Rauschen hinzufügt, ohne Informationen hinzuzufügen. Wöchentlich ist meist ausreichend.