Wie verwende ich die Google Search Console API?

Q: Wie verwende ich die Google Search Console API?

Richten Sie ein Cloud-Projekt ein, aktivieren Sie die API, autorisieren Sie per OAuth und fragen Sie dann Leistungsdaten, URL-Prüfung und Sitemaps ab. Hier finden Sie die Schritte und die Kontingente.

Erstellen Sie in der Google Cloud Console ein Projekt, aktivieren Sie die Google Search Console API, legen Sie OAuth-2.0-Zugangsdaten an und melden Sie sich mit einem Google-Konto an, das Zugriff auf die Property hat. Anschließend können Sie Anfragen an vier Ressourcen senden: Search Analytics für Klicks, Impressionen, CTR und Position, URL Inspection für den Indexstatus, Sitemaps und Sites. API-Schlüssel allein funktionieren nicht: Jeder Aufruf braucht ein OAuth-Token, und Kontingente begrenzen, wie viele Daten Sie abrufen können.

Was die API abdeckt und was nicht

Ressource	Methoden	Verwendung
Search Analytics	`query`	Leistungszeilen nach Suchanfrage, Seite, Land, Gerät, Darstellung in der Suche, Datum oder Stunde
URL Inspection	`index.inspect`	Die indexierte Version einer einzelnen URL: Abdeckung, letzter Crawl, Canonicals
Sitemaps	`list`, `get`, `submit`, `delete`	Verwaltung der Sitemaps, die für eine Property eingereicht wurden
Sites	`list`, `get`, `add`, `delete`	Die Properties des angemeldeten Kontos

Das ist die gesamte API. Für Links, Crawling-Statistiken, den Bericht „Seitenindexierung“ und den Bericht „Core Web Vitals“ gibt es keinen Endpunkt, sie bleiben daher der Search Console-Oberfläche vorbehalten. URL Inspection zeigt, was im Google-Index steht, und ist kein Live-Test der Seite.

Zugriff einrichten

Erstellen oder wählen Sie in der Google Cloud Console ein Projekt aus.
Aktivieren Sie die Google Search Console API für dieses Projekt.
Konfigurieren Sie den OAuth-Zustimmungsbildschirm und erstellen Sie eine OAuth-Client-ID.
Fordern Sie einen Scope an: https://www.googleapis.com/auth/webmasters.readonly zum Lesen oder https://www.googleapis.com/auth/webmasters, um zusätzlich Sitemaps einzureichen oder zu löschen.
Melden Sie sich mit einem Konto an, das Berechtigungen für die Property besitzt. Zum Lesen der Leistungsdaten genügt mindestens Leserecht; die API sieht genau das, was dieses Konto sieht.

Ihre erste Search-Analytics-Abfrage

POST https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "startDate": "2026-09-01",
  "endDate": "2026-09-30",
  "dimensions": ["query", "page"],
  "type": "web",
  "rowLimit": 25000,
  "startRow": 0
}

Die Website steht URL-codiert im Pfad: sc-domain:example.com für eine Domain-Property bzw. das exakte Präfix mit abschließendem Schrägstrich, etwa https://www.example.com/, für eine URL-Präfix-Property. Die wichtigsten Felder:

Datumsangaben sind inklusiv und beziehen sich auf die Pacific Time.
type ist standardmäßig web; weitere Werte sind image, video, news, googleNews und discover. Jeder braucht eine eigene Anfrage.
Filter stehen in dimensionFilterGroups, mit Operatoren von equals und contains bis includingRegex und excludingRegex (RE2-Syntax).
rowLimit reicht von 1 bis 25.000 (Standard 1.000); mit startRow blättern Sie durch den Rest.
dataState ist standardmäßig final; all enthält zusätzlich aktuelle, noch unvollständige Tage, und hourly_all funktioniert mit der Dimension hour.

Jede Zeile liefert keys, clicks, impressions, ctr (0 bis 1) und position, nach Klicks sortiert, sofern Sie nicht nach Datum gruppieren.

Die Limits, die Ihren Code prägen

50.000 Zeilen pro Tag und Suchtyp. Blättern Sie mit startRow in Schritten von 25.000 und hören Sie bei einer leeren Antwort auf. Um das Maximum herauszuholen, fragen Sie jeweils einen Tag ab.
Lastkontingent. Das Gruppieren oder Filtern nach Seite und Suchanfrage zugleich ist die teuerste Anfrage, und lange Zeiträume kosten mehr als kurze. Überschreiten Sie das kurzfristige Kontingent, fordert Google Sie auf, 15 Minuten zu warten.
Anfragerate. 1.200 Abfragen pro Minute je Website und Nutzer; 40.000 pro Minute und 30.000.000 pro Tag je Projekt.
URL-Inspection-Kontingent. 2.000 Prüfungen pro Tag und 600 pro Minute für jede Property.
16 Monate Verlauf; die Daten sind in der Regel zwei bis drei Tage nach Ende des jeweiligen Tages verfügbar.
Die Zeilen ergeben nicht die Summen. Seltene Suchanfragen fehlen in den Zeilen auf Suchanfrageebene, und bei der Gruppierung nach Seite werden Impressionen anders gezählt als bei der Gruppierung nach Property. Lesen Sie Gesamtwerte daher aus einer Anfrage ohne die Dimension „query“.

Häufige Fehler

Wenn Sie http:// verwenden, obwohl die Property https:// ist, oder den abschließenden Schrägstrich weglassen, erhalten Sie einen Berechtigungsfehler, selbst wenn das Konto Zugriff hat.
Eine URL außerhalb der Property wird bei URL Inspection abgelehnt: Die URL muss unterhalb der übergebenen siteUrl liegen.
Ein Monat, in einem Aufruf nach Suchanfrage und Seite gruppiert, liefert nur die obersten Zeilen. Tägliche Anfragen liefern mehr.

So hilft AutoPSEO

Wenn Sie OAuth und Paginierung lieber nicht selbst pflegen möchten: AutoPSEO verbindet sich über die Google-Anmeldung und stellt dieselben Daten über die eigene REST API unter /v1 (mit einem OpenAPI-3.1-Dokument) und einen MCP-Server bereit, autorisiert durch einen API-Schlüssel unter Account → API keys. Schreibgeschützte Schlüssel sind verfügbar, der Search-Analytics-Endpunkt liefert bis zu 5.000 Zeilen pro Aufruf, und die URL-Inspection-Werkzeuge der App zählen das Google-Kontingent von 2.000 pro Tag für Sie mit. Siehe MCP und API-Schlüssel. Wie Sie Daten länger als 16 Monate aufbewahren, ohne eine Pipeline zu schreiben, erfahren Sie unter wie lange Search Console Daten speichert.

Quellen: Googles API-Referenz, Search-Analytics-Methode „query“, Nutzungslimits, Abruf aller Ihrer Daten und Autorisierungsleitfaden.