Search Console API: So erhalten Sie Zugang und das liefert sie
Von Toy Wen Da, Mitgründer · Aktualisiert · 6 Min. Lesezeit
Übersetzt aus dem englischen Original. Auf Englisch lesen
Die Search Console API ist Googles programmatische Schnittstelle zu denselben Daten, die Sie in der Google Search Console sehen. Dazu gehören Klicks, Impressionen, Position und Indexierungsstatus, abgerufen per Code statt über das Dashboard. Als Erstes aktivieren Sie die API in der Google Cloud Console und erstellen Anmeldedaten. Anschließend autorisieren Sie den Zugriff für die Property, die Sie bereits in der Search Console besitzen.
Bevor Sie etwas Eigenes bauen, prüfen Sie, ob Sie den rohen API-Zugriff überhaupt brauchen. Die Website-Traffic-Funktion von SearchBlueprint holt Ihre Search-Console-Zahlen bereits zusammen mit Google Analytics und den Besuchen von KI-Crawlern in eine Ansicht. Für die meisten Website-Betreiber beantwortet das die Frage „Was passiert gerade mit meinen Klicks und Impressionen?“, ohne dass Sie eine Zeile Code schreiben.
Was die Search Console API tatsächlich leistet
Sie ist eine von Google veröffentlichte REST-API, die den Großteil dessen abbildet, was im Search-Console-Dashboard steht. Dazu zählen die Suchleistung (Suchanfragen, Seiten, Länder, Geräte), der Sitemap-Status und die Ergebnisse der URL-Prüfung. Sie rufen die API aus einem Skript, einem Backend-Dienst oder einem Tool auf. Sie liefert strukturiertes JSON statt einer Ansicht, die Sie von Hand lesen müssen.
Sie liefert nichts, was die Search Console nicht ohnehin anzeigt. Ihr Wert liegt in Datenmenge und Automatisierung. Denken Sie an den Abruf von Daten über mehrere Jahre, an das Zusammenführen mehrerer Properties oder an einen Bericht, der sich jeden Morgen aktualisiert, ohne dass jemand einen Browser-Tab öffnet.
Zugang einrichten: API-Schlüssel, OAuth und Aktivierung der API
Ein einfacher API-Schlüssel reicht hier nicht aus. Die Search-Analytics-Endpunkte von Google benötigen einen Nutzer oder ein Dienstkonto, das für die jeweilige Property autorisiert ist. Der Grund: Die Daten sind an die Person gebunden, die die Inhaberschaft bestätigt hat. So läuft es in der aktuellen Konsole ab.
Schritt 1: Die API in der Google Cloud Console aktivieren
Öffnen Sie die Google Cloud Console, wählen Sie ein Projekt aus oder erstellen Sie eines, öffnen Sie das Menü APIs und Dienste (APIs & Services) und dann Bibliothek (Library). Suchen Sie nach „Google Search Console API“, klicken Sie darauf und dann auf Aktivieren (Enable).
Schritt 2: Anmeldedaten erstellen
Öffnen Sie weiterhin unter APIs und Dienste den Punkt Anmeldedaten (Credentials) und dann Anmeldedaten erstellen (Create Credentials). Für Skripte und Server-zu-Server-Jobs wählen Sie ein Dienstkonto (Service Account) und laden dessen JSON-Schlüssel herunter. Für eine App, die im Namen eines angemeldeten Nutzers handelt, wählen Sie stattdessen eine OAuth-Client-ID (OAuth client ID).
Schritt 3: Zugriff in der Search Console gewähren
Die API sieht nur Properties, auf die die authentifizierte Identität Zugriff hat. Wenn Sie ein Dienstkonto erstellt haben, kopieren Sie dessen E-Mail-Adresse und fügen Sie sie in der Search Console als Nutzer hinzu. Das geht unter Einstellungen > Nutzer und Berechtigungen (Settings > Users and permissions). Vergeben Sie mindestens die Berechtigung „Vollständig“ (Full) oder „Eingeschränkt“ (Restricted), je nachdem, ob das Konto Sitemaps einreichen oder nur Daten lesen soll.
Schritt 4: Den ersten Aufruf machen
Mit den Anmeldedaten in der Hand authentifizieren Sie sich und rufen die Search-Analytics-Methode query auf. Übergeben Sie ein Startdatum, ein Enddatum und Dimensionen (Suchanfrage, Seite, Land, Gerät). An dieser Stelle zeigt sich auch häufig ein Problem mit der Verifizierung. Wenn das Dienstkonto die Property nicht sehen kann, muss meist die Search-Console-Verifizierung selbst noch einmal geprüft werden. Das sollten Sie an der Wurzel beheben, bevor Sie den API-Aufruf debuggen.
Was Sie abrufen können: Die Endpunkte im Überblick
| Endpunkt | Was er liefert | Typische Verwendung |
|---|---|---|
| Search Analytics query | Klicks, Impressionen, CTR, Position nach Suchanfrage/Seite/Land/Gerät | Dashboards zu Rankings und Traffic |
| Sitemaps | Sitemap-Einträge auflisten, einreichen oder löschen | Automatisches erneutes Einreichen der Sitemap nach einem Rebuild |
| URL Inspection | Indexierungsstatus, Canonical, Nutzerfreundlichkeit auf Mobilgeräten für eine URL | Prüfen, ob eine Seite nach der Veröffentlichung indexiert wurde |
| Sites | Properties auflisten oder hinzufügen, auf die das Konto Zugriff hat | Tools für Agenturen mit mehreren Websites |
Search Console API, manueller Export oder No-Code-Tools
| Option | Am besten für | Einrichtungsaufwand | Wichtigste Einschränkung |
|---|---|---|---|
| Export über die Search-Console-Oberfläche | Eine einzelne, gelegentliche Prüfung | Keiner | Begrenzte Zeilenzahl, keine Zeitplanung, keine Automatisierung |
| Direkte API-Aufrufe | Eigene Dashboards, Entwickler | Mittel bis hoch (OAuth, Code) | Sie pflegen Authentifizierung und Code selbst |
| No-Code-API-Wrapper | Nicht-Entwickler, die dennoch JSON brauchen | Gering | Monatliche Gebühr, weniger Kontrolle über die Felder |
| Integrationsplattformen (iPaaS) | SaaS-Produkte, die GSC-Daten für ihre Kunden einbetten | Mittel | Für Anbieter gebaut, nicht für das Reporting einer einzelnen Website |
No-Code-Wrapper gibt es genau dafür, die Arbeit mit OAuth und Endpunkten zu umgehen. Einige, etwa der Search-Console-Konnektor von NoCodeAPI, machen aus Aufrufen für Search Analytics und Sitemaps einen einzigen authentifizierten JSON-Endpunkt. Am anderen Ende bewerben Anbieter wie Paragon native Search-Console-Integrationen, die mit rund 70 % weniger Entwicklungsaufwand entstehen, als wenn Sie OAuth und Synchronisierungslogik von Grund auf bauen. Diese Angebote richten sich an SaaS-Teams, die Search-Console-Daten innerhalb ihres eigenen Produkts ausliefern, nicht an Menschen, die einfach nur ihre eigenen Zahlen sehen wollen.
Wann die kostenlosen Tools genügen und wann nicht
Die Oberfläche der Search Console reicht aus, wenn Sie eine einzelne URL prüfen oder eine einmalige Frage klären („Wurde diese Seite indexiert?“). Auch für einen kurzen Blick auf die Top-Suchanfragen des letzten Monats ist sie in Ordnung. Für alles Wiederkehrende oder für mehrere Properties ist sie nicht gemacht.
Die API (oder ein Tool, das darauf aufbaut) lohnt sich, wenn Sie Folgendes brauchen:
- Einen geplanten Bericht, der sich aktualisiert, ohne dass jemand die Search Console öffnet
- Daten über mehr Properties, als Sie von Hand durchklicken können
- Einen Verlauf, der über das hinausgeht, was die Oberfläche bequem anzeigt
- Suchdaten, die mit anderen Quellen verknüpft sind. Gut zu wissen ist dabei auch der tatsächliche Unterschied zwischen Search Console und Analytics, denn beide beantworten unterschiedliche Fragen und keine ersetzt die andere
Häufige Fehler
- Einen API-Schlüssel statt OAuth oder eines Dienstkontos verwenden. Search-Analytics-Aufrufe scheitern ohne korrekte Autorisierung, egal wie gültig der Schlüssel aussieht.
- Das Dienstkonto nicht als Nutzer in der Search Console hinzufügen. Die API-Anmeldedaten und die Berechtigung für die Property sind zwei getrennte Schritte.
- Annehmen, die API liefere mehr Historie als die Oberfläche. Beide greifen auf dieselben zugrunde liegenden Daten zu; der Vorteil der API ist die Automatisierung, nicht zusätzliche Monate an Daten.
- Datumsbereiche und Dimensionen fest im Code verdrahten. Abfragen, die nicht korrekt paginieren, kürzen die Ergebnisse bei stark besuchten Websites unbemerkt ab.
Häufig gestellte Fragen
Muss ich für die Search Console API bezahlen?
Nein. Die API selbst ist im Rahmen der üblichen Google-Kontingentgrenzen kostenlos; Kosten entstehen nur, wenn Sie ein Tool darauf aufbauen oder eines kaufen.
Was ist der Unterschied zwischen einem API-Schlüssel und OAuth für die Search Console?
Ein API-Schlüssel identifiziert ein Projekt. OAuth (oder ein Dienstkonto) identifiziert und autorisiert einen bestimmten Nutzer oder ein Konto für eine Property. Für Search-Analytics-Daten ist Letzteres erforderlich.
Kann ich die API der Search Console ohne Programmieren nutzen?
Ja, über No-Code-Konnektoren, die die API in einen einfacheren JSON-Endpunkt verpacken. Sie müssen sich trotzdem bei Google authentifizieren und ein Konto bei diesem Anbieter verwalten.
Wie viele Daten kann ich pro Anfrage abrufen?
Googles Dokumentation nennt die Zeilen- und Kontingentgrenzen je Methode. Große Konten müssen Anfragen in der Regel paginieren, statt alles in einem Aufruf abzuholen.
Funktioniert die API auch für Properties, die ich nicht verifiziert habe?
Nein. Der Zugriff ist an die verifizierte Inhaberschaft in der Search Console gebunden. Die Anmeldedaten, die Sie verwenden, müssen also zuerst als Nutzer für diese Property hinzugefügt werden.
Die vollständige technische Referenz, einschließlich Kontingenten und Methodenparametern, finden Sie in Googles eigener Dokumentation zur Search Console API.
Prüfen Sie Ihre Zahlen, bevor Sie etwas bauen
Geht es Ihnen nur um Sichtbarkeit, Klicks, Impressionen und darum, wie KI-Crawler Ihre Seiten behandeln, ist die Search Console API nicht nötig. Sparen Sie sich die OAuth-Einrichtung und sehen Sie alles bereits zusammengeführt in der Website-Traffic-Ansicht von SearchBlueprint. Einen breiteren Blick darauf, wie Ihre Website in der Suche aktuell tatsächlich abschneidet, erhalten Sie, wenn Sie mit dem Team sprechen. Sie bekommen einen Beispielbericht, der auf den Daten Ihrer eigenen Website basiert.
Ressourcen / Referenzen
Quellen
Über den Autor
SearchBlueprint hat diesen Artikel mit der Content-Pipeline recherchiert, geschrieben und bewertet, die unsere Kunden auf ihren eigenen Websites einsetzen. Die Bewertung in der Autorenzeile ist die, die unsere Content-Engine dieser Seite vor der Veröffentlichung gegeben hat. Nichts davon wird von Hand geprüft, und genau das ist der Punkt: Es ist das Ergebnis des Produkts, veröffentlicht dort, wo jeder es nachprüfen kann.