Dokumentation
Endpunktreferenz und Preisgestaltung
Eine URL, viele Aktionen. Dies ist die gesamte Oberfläche.
SEOCheck-Research-Team ·

Aktionen und Kosten
| Aktion | Kredite | Was es zurückgibt |
|---|---|---|
| domain | kostenlos | Basisdatensatz und DR für eine Domain |
| übersicht | kostenlos | Zusammenfassung des Linkprofils einer Domain |
| stats | kostenlos | Indexweite Statistiken |
| vorschlagen | kostenlos | Domain-Vorschläge während der Eingabe |
| bulk_dr | 1 | DR für bis zu 2.000 Domains |
| vergleichen | 1 | Nebeneinander für bis zu 20 Domains |
| top | 1 | Top-Domains |
| dr_distribution | 1 | Verteilung des DR unter verlinkenden Domains |
| tld_breakdown | 1 | Links nach Top-Level-Domain |
| refdomains | 2 | Verweisende Domains |
| backlinks | 2 | Einzelne Backlinks |
| anchors | 2 | Ankertexte |
| toppages | 2 | Am häufigsten verlinkte Seiten |
| anchor_cloud | 2 | Anker-Gewichtungen |
| intersect | 2 | Gemeinsame Linker für 2 bis 10 Domains |
| search | 3 | Volltextsuche über Anker, Titel und URLs |
| keyword | 3 | Wer 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
overviewfür eine Domain aus, die Sie kennen. Sie ist kostenlos. - Überprüfen Sie, ob Ihr Schlüssel mit einem 1-Kredit-Aufruf wie
comparefunktioniert. - Lesen Sie
_creditsin 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.
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'
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.

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.
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.
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.
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.
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
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
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.