Zum Hauptinhalt springen

Weil ich neulich mal wieder unnötig viel Zeit damit verbracht habe, Diskrepanzen zwischen einer GSC-API-Abfrage und der Darstellung im GSC Frontend zu debuggen, sei es hier noch einmal notiert:

Die GSC-API gibt die exakt gleichen Daten aus wie das GSC-Frontend. Immer. Keine Ausnahmen. Nicht mal klitzekleine.

Wenn es einen Unterschied gibt, dann weil die Filter unterschiedlich gesetzt sind.

Weil es an dieser Aussage doch immer mal wieder Zweifel gibt, habe ich eine Liste von Prüfschritten geschrieben, um die Quelle für Abweichungen zu finden., Die Liste ist nach der gefühlten Häufigkeit und Prüf-Einfachheit der Abweichungen sortiert, gewichtet nach Behrends besonders berufserfahrenem Bauchgefühl (höchst zuverlässige Metrik, wenn ihr mich fragt):

1. Parallele Property-Paare

Vergleichst Du gerade versehentlich eine Domain-Property mit einer URL-Prefix-Property? Oder eine Folder-Property mit einem URL-Filter?

Ja? Ärgere Dich nicht, das passiert ständig. Andernfalls gucken wir weiter:

2. Defekte Daten

Insbesondere tückisch, wenn Du das Frontend auf Englisch benutzt und Daten in den ersten 12 Tagen des Monats abrufst, weil die Amis ja darauf bestehen, das Datum falsch herum zu notieren. Merke: 05.06.2025≠ 05/06/2025. Warum das Frontend nicht konsequent das universelle, von der ISO 8601 empfohlene "YYYY-MM-DD"-Format verwendet, ist mir ein Rätsel.

Und auch sonst kommt es schnell mal vor, dass der Zeitraum nicht exakt gleich abgefragt wurde.

Du erkennst Dich in diesem Szenario wieder und glaubst, dass ich an die Situation gedacht habe, als ich Dich das eine mal auf genau diesen Fehler hingewiesen habe? Damit liegst Du vielleicht richtig, aber es gibt mehrere Menschen, die ich schon einmal auf diesen Fehler hingewiesen habe. Du bist also in guter Gesellschaft.

3. Filter Fauxpas

Sind ansonsten die gleichen Filter eingestellt? Also wirklich exakt die gleichen? Gleicher Query Filter, gleicher Page Filter, gleiche Filter für Country, Search Appearance, Device?

Auch nicht der Fehler? Na gut, nächster Punkt:

4. Dimensions-Debakel

Fragst Du die gleichen Dimensionen ab? Wenn Du Dir die Queries ausgeben lässt, oder einen Filter auf Queries setzt, werden die anonymized Queries von der Ausgabe ausgeschlossen.

Achtung: Wenn Du im Frontend die Keyword Tabelle anguckst, sind ohne einen Query-Filter die aggregierten Zahlen oben noch ungefiltert, während in der Tabelle nur die ersten 1000 Keywords ausgegeben werden. In der API werden alle Keywords ausgegeben (bis zum API Limit von 50000 Zeilen).

Analog gilt das Gleiche für die Page-Dimension: Beliebt ist hier zum Beispiel der Vergleich eines Page-Filters auf einen Folder mit einer Folder-Property.

Die Daten passen natürlich auch hier nicht zusammen, denn wir vergleichen byProperty- mit byPage-Logik (es sei denn, Du setzt in der Folder-Property zusätzlich einen Page-Filter…).

Aber eigentlich ist Dir das ja schon beim ersten Check aufgefallen, oder?

Dimensionen stimmen alle überein? Dann wars vielleicht:

5. Fehlende Finalität

Vergleichst Du Daten der letzten Tage? Dann sind die vorläufigen Daten der GSC vielleicht das Problem. Das Frontend zeigt, wenn das gestrige oder heutige Datum  in der date-Range ausgewählt wurden, preliminary data an.

Die API dagegen zeigt per default nur die finalisierten Daten an und lässt die Daten von gestern und heute weg, selbst wenn Du als endDate ein aktuelles Datum vergeben hast. Um hier Preliminary Data mit einzubeziehen, musst Du "dataState" extra mit angeben.

Auch nicht der Grund für Deine Daten-Diskrepanz? Nächster Check:

6. Untypische Types

Das kommt zugegebenermaßen selten vor/merkt man schnell, aber vergleichst zufällig gerade Äpfel mit Birnen Websuche mit Bildersuche, oder Discover mit googleNews, oder sowas? Dann passt natürlich vorne und hinten nix zusammen.

Gut, der ist ziemlich offensichtlich... wenns das war, kommst Du Dir vermutlich gerade blöd vor. Mir geht es zumindest immer so, wenn mir das passiert :D

Wenn es das auch nicht war, ist es dann vielleicht das hier:

7. Big Query-Banalitäten

Exakt gleich sind nur GSC-API und GSC-Frontend. Der BigQuery Bulk Data Export der GSC weist tatsächlich mehr Daten aus. Über die Unterschiede zwischen GSC Frontend/API-Daten und denen aus Big Query könnte ich einen eigenen Artikel schreiben...

Ups, das ist ja gar kein Checklisten Item sondern ein Teaser für den nächsten Newsletter... Naja, was soll ich sagen... ¯\_(ツ)_/¯

Aber wenn Du wirklich API-Daten mit dem Frontend vergleichst und nicht Bulk Export Daten…, dann:

8. Behrend behauptet Bockmist

Du hast alles geprüft und Deine GSC-API-Daten passen wirklich nicht mit den Frontend-Zahlen zusammen? Es scheint Dir, dass Ich falsch liegen könnte (so unrealistisch Du es auch findest)?

Dann melde Dich gerne bei mir! Ich nehme mir gerne die Zeit, um mit Dir auf Deine Daten zu gucken, alles zu prüfen und Dich eines Besseren zu belehren (oder vielleicht mich? Wollen wir wetten? Wenn wir doch eine Diskrepanz finden, die sich nicht erklären lässt, dann schulde ich Dir ein Bier/Kaffee/Keks/eins der letzten 403 Forbidden SEO-Spiele/o.Ä. und eine Richtigstellung im Newsletter).

Das ist ein Artikel aus unserem Newsletter. Wenn Du jeden Dienstag Morgen schlauer werden möchtest, melde jetzt kostenfrei für den SEO-Newsletter an

Kurze, praxisnahe SEO-Tipps – maximal 1× pro Woche. Keine Werbung, kein Spam.

Deine Daten sind bei uns in guten Händen und werden ausschließlich für diesen Newsletter genutzt.