Zum Inhalt springen
SEO Uptr
SEO UptrRegistrieren

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.

Stone bridge over river with a small boat sailing underneath

Aktionen nach Kreditkosten

1 Kredit = $0,0001. Jeder Aufruf wird einmal abgerechnet, unabhängig von der Anzahl der Zeilen, bis zu 1.000 Zeilen pro Aufruf.
KostenAktionenHinweise
Kostenlos, kein Key erforderlichdomain, overview, stats, suggestGut für Dashboards und den DR-Checker
1 Kreditbulk_dr, compare, top, dr_distribution, tld_breakdownbulk_dr verarbeitet bis zu 2.000 Domains (GET domains= oder POST-Body); compare bis zu 20
2 Krediterefdomains, backlinks, anchors, toppages, anchor_cloud, intersectintersect benötigt 2 bis 10 Domains
3 Kreditesearch, keywordVolltextsuche ü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.

bash
# 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" ;;
esac

Parameter und Fehler

ElementWertBedeutung
qeine DomainDas Ziel der Abfrage
page, perper von 10 bis 5000Paginierung; Zeilen pro Aufruf sind auf 1.000 begrenzt, tiefe Paginierung auf 50.000
sort, orderorder=asc oder descSortierung der zurückgegebenen Zeilen
okin jeder AntwortOb der Aufruf erfolgreich war
_creditsnur bei authentifizierten AntwortenKosten des Aufrufs und verbleibender Saldo
HTTP 401fehlender oder falscher KeyPrüfen Sie den Key oder Header
HTTP 402Kredite aufgebrauchtAufladen mit USDT (TRC-20)
Carpenter measuring wood and selecting tools on a workshop bench

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.

Kostenlose Aktionen zuerst

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.
Gardener arranging plants in neat rows in a garden

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 overview oder domain. 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ür refdomains oder anchors aus, 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, einen anchors-Aufruf und einen tld_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 page mit per. 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.