Zum Inhalt springen
SEOCheck
SEOCheckRegistrieren

Dokumentation

Endpunktreferenz und Preisgestaltung

Eine URL, viele Aktionen. Dies ist die gesamte Oberfläche.

SEOCheck-Research-Team ·

Eine robuste Steinbrücke, die ein nebliges Tal überspannt, repräsentiert einen zuverlässigen API-Endpunkt

Aktionen und Kosten

AktionKrediteWas es zurückgibt
domainkostenlosBasisdatensatz und DR für eine Domain
übersichtkostenlosZusammenfassung des Linkprofils einer Domain
statskostenlosIndexweite Statistiken
vorschlagenkostenlosDomain-Vorschläge während der Eingabe
bulk_dr1DR für bis zu 2.000 Domains
vergleichen1Nebeneinander für bis zu 20 Domains
top1Top-Domains
dr_distribution1Verteilung des DR unter verlinkenden Domains
tld_breakdown1Links nach Top-Level-Domain
refdomains2Verweisende Domains
backlinks2Einzelne Backlinks
anchors2Ankertexte
toppages2Am häufigsten verlinkte Seiten
anchor_cloud2Anker-Gewichtungen
intersect2Gemeinsame Linker für 2 bis 10 Domains
search3Volltextsuche über Anker, Titel und URLs
keyword3Wer ist mit einem exakten Anker verlinkt

Auth und Struktur

Basis-URL: https://seocheck.dev/api.php?action=<action>&q=<domain>&key=sk_.... Bevorzugen Sie Header? Senden Sie stattdessen Authorization: Bearer sk_....

Diese Backlink-Analyse-API antwortet mit JSON und ermöglicht Cross-Origin-Aufrufe, sodass ein Browser sie direkt ansprechen kann. Jede Antwort enthält ein ok-Feld. Authentifizierte Antworten enthalten zudem _credits, das die Kosten dieses Aufrufs und Ihren verbleibenden Saldo enthält.

Fehler sind direkt. HTTP 401 bedeutet, dass der Schlüssel fehlt oder falsch ist. HTTP 402 bedeutet, dass der Saldo aufgebraucht ist. Beide sind einfach zu behandeln, und beide sollten nicht in einer Schleife wiederholt werden.

Vor dem ersten kostenpflichtigen Aufruf

  • Führen Sie overview für eine Domain aus, die Sie kennen. Sie ist kostenlos.
  • Überprüfen Sie, ob Ihr Schlüssel mit einem 1-Kredit-Aufruf wie compare funktioniert.
  • Lesen Sie _credits in der Antwort und bestätigen Sie, dass die Kosten mit der obigen Tabelle übereinstimmen.
  • Legen Sie einen Skript-Alarm für HTTP 402 fest, damit ein leerer Saldo nicht stillschweigend fehlschlägt.

Paginierung und Sortierung

Die Zeilen pro Aufruf gehen bis zu 1.000. Fordern Sie weniger oder mehr mit per an, von 10 bis 5000, navigieren Sie mit page und sortieren Sie mit sort und order.

bash
curl -s "https://seocheck.dev/api.php?action=backlinks&q=example.com&per=500&page=2&sort=dr&order=desc&key=sk_live_..." | jq '._credits'
Ein Gärtner, der sorgfältig einen Bonsaibaum mit spezialisierten Scheren beschneidet, veranschaulicht präzise Anpassungen

Parameter, die die Antwort ändern

Jede Aktion benötigt dieselben beiden Grundlagen, action und q, sowie eine kurze Reihe von Optionen. Lesen Sie diese zuerst. Die meisten Fehler entstehen durch Optionen, die optional erscheinen, aber die Kosten oder die Struktur der Zeilen ändern. Lesen Sie die Optionen, bevor Sie einen Aufruf aus einem Forum oder Blog kopieren.

Die folgenden Beispiele gehen von einem Schlüssel im Parameter key aus. Ersetzen Sie den Platzhalter durch Ihren eigenen. Bewahren Sie den Schlüssel in einer Umgebungsvariable auf, nicht in einer Datei, die Sie committen. Jedes Beispiel in dieser Backlink-Analyse-API-Referenz verwendet dieselbe Basis-URL.

Paginierung mit page und per

Die Option per legt fest, wie viele Zeilen zurückgegeben werden, von 10 bis 5000. Die Option page bewegt Sie durch die Menge. Ein Aufruf, der 500 Zeilen und dann Seite 2 anfordert, gibt den nächsten Block zurück, nicht den nächsten Abruf derselben Zeilen.

Tiefe Paginierung endet bei 50.000 Zeilen. Wenn ein Job mehr benötigt, schränken Sie die Abfrage mit sort ein oder teilen Sie die Arbeit nach Domains auf, damit jeder Aufruf innerhalb der Grenze bleibt.

Sortierung mit sort und order

Sortieren Sie auf dem Server, nicht in Ihrem Skript. Die Anfrage nach sort=dr&order=desc gibt die stärksten verlinkenden Domains zuerst zurück, sodass die Zeilen, die Sie interessieren, auf der ersten Seite ankommen. Das Filtern nach einem vollständigen Download verschwendet sowohl Zeit als auch Kredite.

Verwenden Sie order=asc, wenn Sie die schwächsten Zeilen wünschen, z. B. um Links zu finden, die dünn sind, oder um einen plötzlichen Rückgang in einem Profil zu erkennen.

Listen: bulk_dr, compare und intersect

Die Listenaktionen übernehmen mehrere Domains in einem Aufruf. bulk_dr akzeptiert bis zu 2.000 Domains für einen Kredit, mit einer GET-Abfragezeichenfolge oder einem POST-Body. compare nimmt bis zu 20 Domains auf, und intersect zwei bis zehn.

Da der Preis nicht von der Zeilenanzahl abhängt, ist eine lange Liste in einem Aufruf günstiger als viele kurze Aufrufe. Wenn Sie am Montag 1.500 Prospekt-Sites prüfen, ist das ein Aufruf, nicht 1.500.

Such- und Keyword-Aufrufe kosten mehr

Die Aktion search führt eine Volltextsuche über Anker, Titel und URLs durch. Die Aktion keyword fragt, wer mit einem exakten Anker verlinkt ist. Beide kosten drei Kredite pro Aufruf, verwenden Sie sie also, um eine spezifische Frage zu beantworten, statt zu browsen.

Auswahl von per und page für einen ersten Abruf

Für einen ersten Blick auf eine neue Domain beginnen Sie mit einem kleinen per, z. B. 50. Sie sehen die Struktur der Zeilen, die Feldnamen und die Kosten in einer kurzen Antwort. Erhöhen Sie per erst, wenn Sie wissen, dass die Zeilen das sind, was Sie benötigen. Dieselbe Gewohnheit funktioniert für jede Aktion in der obigen Tabelle.

Ein häufiger Fehler ist, beim ersten Versuch 5.000 Zeilen anzufordern und die meisten davon zu verwerfen. Die Antwort ist größer, die Wartezeit länger und die erhoffte Ersparnis bleibt aus.

Den Kreditzähler lesen

Jede authentifizierte Antwort endet mit _credits, das die Kosten dieses Aufrufs und Ihren Saldo danach angibt. Protokollieren Sie es. Addieren Sie es am Monatsende, und Sie kennen Ihre tatsächliche Rechnung bis auf den Cent.

Ein grober Budgetplan hilft. Tausend refdomains-Aufrufe kosten 2.000 Kredite, das sind $0,20. Tausend search-Aufrufe kosten 3.000 Kredite, also $0,30. Ein täglicher bulk_dr-Lauf auf einer Liste mit 2.000 Domains kostet 1 Kredit, also etwa $0,003 pro Monat.

Im Vergleich zu Plänen, die bei $129 pro Monat für 200.000 API-Einheiten beginnen, wie Ahrefs sie auflistet, ist die Struktur der Rechnung anders. Siehe den Vergleich für Details.

Ein Paar vintage Messingwaagen, die zwei unterschiedliche Gewichte ausbalancieren, repräsentieren verschiedene Fehlertypen

Fehler und das _credits-Feld lesen

Eine Antwort kann auf zwei verschiedene Arten fehlschlagen, und Ihr Code sollte sie unterschiedlich behandeln. Das sind verschiedene Probleme. Ein falscher Schlüssel ist ein Konfigurationsproblem. Ein leerer Saldo ist ein Abrechnungsproblem. Beide als einen generischen Fehler zu behandeln, verbirgt, welche Korrektur Sie benötigen.

Lesen Sie zuerst das Feld ok. Lesen Sie dann den Block _credits. Erst danach sollten Sie die Zeilen prüfen, da ein fehlendes oder kurzes Ergebnis leichter zu erklären ist, wenn Sie bereits wissen, was der Aufruf gekostet hat.

401 und 402 separat behandeln

HTTP 401 bedeutet, dass der Schlüssel fehlt oder falsch ist. Stoppen Sie den Job und beheben Sie den Schlüssel. HTTP 402 bedeutet, dass der Saldo aufgebraucht ist. Laden Sie vom Konto aus auf, und fahren Sie fort. Das Wiederholen eines 401 hilft nie, und das Wiederholen eines 402 ohne Aufladen hilft auch nicht.

Den Saldo vor und nach einem Lauf protokollieren

Schreiben Sie den _credits-Saldo zu Beginn und am Ende eines Laufs auf. Die Differenz sollte mit dem übereinstimmen, was Sie von den durchgeführten Aufrufen erwartet haben. Ein größerer Sprung bedeutet, dass eine Schleife öfter gelaufen ist als beabsichtigt.

Für eine schnelle Überprüfung multiplizieren Sie die Anzahl der Aufrufe mit ihren Kreditkosten. Wenn die Antwort 40 ist und der Saldo um 4.000 gesunken ist, stimmt etwas am Skript nicht, nicht an der Preisliste.

Die angeforderten Zeilen prüfen

Eine erfolgreiche Antwort mit weniger Zeilen als erwartet ist nicht automatisch ein Fehler. Eine kleine Domain hat möglicherweise einfach wenige Links. Vergleichen Sie die Zeilenanzahl mit dem per-Wert, den Sie gesendet haben, und behandeln Sie eine Lücke als zu beantwortende Frage, nicht als zu versteckenden Fehler.

Die günstigen Aufrufe zuerst testen

Bevor Sie einen Aufruf in einen Job einbinden, führen Sie ihn einmal manuell mit den kleinsten sinnvollen Optionen aus. Prüfen Sie die Antwort, die Feldnamen und den _credits-Wert. Ein Job, der an der zweiten Zeile scheitert, ist viel schwieriger zu debuggen als ein Aufruf, der beim ersten Versuch fehlschlug.

Eine erste Sitzung mit der API

Vier Aufrufe, in Reihenfolge, sodass jeder spätere Aufruf einer ist, den Sie bereits verstehen. Nur der erste ist kostenlos, und das ist beabsichtigt.

01

Führen Sie overview für eine bekannte Domain aus

Sie ist kostenlos und benötigt keinen Schlüssel. Vergleichen Sie die Zusammenfassung mit dem, was Sie in der Search Console und auf der Website selbst sehen, damit Sie wissen, wie eine normale Antwort aussieht.

02

Testen Sie den Schlüssel mit einem 1-Kredit-Aufruf

Senden Sie compare mit Ihrer Domain und einem Konkurrenten. Bestätigen Sie, dass das Feld ok true ist und dass _credits eine Kosten von einem Kredit anzeigt.

03

Ziehen Sie eine 2-Kredit-Liste mit einem kleinen per

Fordern Sie refdomains mit per=50 und sort=dr an. Prüfen Sie, dass die Zeilenanzahl und die Kreditkosten mit der obigen Tabelle übereinstimmen.

04

Schreiben Sie die Kosten in Ihr Protokoll

Notieren Sie den Saldo vor und nach dem Lauf. Ab jetzt beginnt jedes Skript, das Sie schreiben, mit dieser Gewohnheit, und eine überraschende Rechnung wird zu einer Zeile im Protokoll statt zu einem Rätsel.

Preisgestaltung

Prepaid-Kredit. Ein Kredit ist $0,0001. Es gibt kein Abonnement und kein monatliches Minimum.

Kostenlose Aktionen

$0

  • domain, overview, stats, suggest
  • Kein Schlüssel erforderlich
  • Betreibt den Web-Checker
Checker öffnen

Bezahlung nach Verbrauch

$0.10pro 1.000 Aufrufe mit einem Kredit

  • $100 kostenloser Kredit bei der Anmeldung
  • Keine Karte erforderlich
  • Aufladen mit USDT (TRC-20)
  • Einmal pro Aufruf abgerechnet, nicht pro Zeile
Holen Sie sich $100 kostenlos

Grenzen, die Sie kennen sollten

Der Index umfasst 181.132.097 Domains und 2.774.625.913 Domain-Links. Er wird etwa monatlich aktualisiert. Das ist langsamer als ein täglicher Crawl.

Tiefe Paginierung endet bei 50.000 Zeilen. Für größere Abrufe schränken Sie die Abfrage mit sort ein oder teilen Sie nach Domain auf.

Die Anmeldung ist nur über Google möglich, und Aufladungen erfolgen in USDT. Beginnen Sie mit dem DR-Checker, testen Sie eine Konkurrenten-Audit mit dem Wettbewerbs-Guide oder lesen Sie warum einige Teams die Ahrefs-API für reine Link-Arbeit ablegen.

FAQ

Bezahle ich pro Zeile?

Nein. Ein Aufruf wird einmal abgerechnet, egal ob er 10 oder 1.000 Zeilen zurückgibt.

Was passiert, wenn die Kredite ausgehen?

Die API gibt HTTP 402 zurück. Laden Sie vom Konto aus mit USDT (TRC-20) auf, und fahren Sie fort.

Wo finde ich meinen Schlüssel?

Im Dashboard nach der Google-Anmeldung.