Search-Console-API und SEO

TL;DR — Die Search Console API ermöglicht es Ihnen, Ihre Google Search Console-Daten mit Code abzurufen, anstatt durch die Oberfläche zu klicken. So erhalten Sie mehr als die Benutzeroberfläche bietet – der Export in der Oberfläche ist auf etwa 1 000 Zeilen begrenzt, während die API bis zu 25 000 pro Anfrage liefert. Sie melden sich mit Google an (OAuth, kein einfacher API-Schlüssel) und erhalten nur Daten für Websites, die Sie verifiziert haben.

Was die Search Console API ist

Search Console zeigt Ihnen, wie Ihre Website bei Google abschneidet – für welche Suchanfragen Sie ranken, wie viele Klicks und Impressionen Sie erhalten, ob Ihre Seiten indexiert sind. Die API bietet Ihnen programmatischen Zugriff auf einen Großteil dieser Daten und dieser Steuerungsmöglichkeiten, sodass Sie sie in eine Tabellenkalkulation, ein Dashboard oder ein Skript einbinden können, das nach Zeitplan läuft. Es ist jedoch keine vollständige Parität mit der Benutzeroberfläche – einige Dinge (wie das Live-Testen einer URL) gibt es nur in der Oberfläche, und API-Zugriff oder Automatisierung garantieren für sich genommen keine Indexierung, Rankings, Verkehrsdiagnose oder Sichtbarkeit in der KI-Suche.

Es gibt vier Komponenten:

1. Search Analytics API – Ihre Leistungsbericht-Zahlen (Klicks, Impressionen, CTR, durchschnittliche Position), aufgeschlüsselt nach Suchanfrage, Seite, Land, Gerät und Datum.
2. URL Inspection API – der Indexstatus einer einzelnen URL. Sie meldet die Version, die sich derzeit im Google-Index befindet; das URL Inspection-Tool in der Oberfläche kann auch einen Live-Test durchführen, was die API nicht kann.
3. Sitemaps API – Sitemaps auflisten, einreichen oder löschen.
4. Sites API – die Properties auf Ihrem Konto auflisten, hinzufügen oder entfernen.

Grenze der Plattform-Properties: Search Console verfügt jetzt über separate Instagram-, TikTok-, X- und YouTube-Properties, aber Googles aktuelle Plattformdokumentation beschreibt ihre Oberflächenberichte und den Berichtsexport – nicht einen siteUrl-Bezeichner oder einen Support- vertrag für diese Legacy-Endpunkte. Der API-Workflow in diesem Artikel deckt daher nur Website-Properties ab. LinkedIn ist keine unterstützte Plattform-Property.

Warum es statt der Oberfläche verwenden

Der große Punkt: Zeilen. Wenn Sie den Leistungsbericht aus der Search Console-Oberfläche exportieren, erhalten Sie ungefähr 1 000 Zeilen. Die API gibt bis zu 25 000 Zeilen pro Anfrage zurück, und Sie können für mehr blättern. Wenn Sie eine Website mit Tausenden von Suchanfragen oder Seiten haben, zeigt Ihnen die Oberfläche einfach nicht die meisten Ihrer Daten.

Der andere Grund ist die Automatisierung. Sobald es ein API-Aufruf ist, können Sie ihn jeden Morgen ausführen, in ein Dashboard laden oder sich benachrichtigen lassen, wenn die Klicks sinken.

Der Haken

Sie können nur Daten für Properties abrufen, die Sie in Search Console verifiziert haben. Wenn Sie die API auf eine Website richten, die Ihnen nicht gehört, erhalten Sie nichts zurück – das ist der häufigste Anfängerfehler.

And the API doesn’t give you everything. It returns the top rows, not the full list, and it never shows you the queries Google anonymizes for privacy. For a big site that wants the complete picture, the better tool is the bulk data export to BigQuery — more on that in the Advanced version.

TL;DR — Die Search Console API besteht aus vier REST-APIs unter webmaster-tools/v1 – Search Analytics, URL Inspection, Sitemaps, Sites – alle OAuth 2,0, alle nur auf verifizierte Properties beschränkt. Search Analytics gibt 1–25 000 Zeilen pro Anfrage zurück (Standard 1 000), “garantiert jedoch nicht, alle Datenzeilen zurückzugeben, sondern eher die obersten”, sodass Sie für Vollständigkeit in großem Maßstab zum BigQuery-Bulk-Daten- export übergehen. URL Inspection ist hart auf 2 000 QPD / 600 QPM pro Website begrenzt – diese Arithmetik ist es, die die groß angelegte Indexüberwachung begrenzt.

Dieser API-Leitfaden ist auf Website-Properties beschränkt. Gehen Sie nicht davon aus, dass die Sites-, Search Analytics-, URL Inspection- oder Sitemaps-Endpunkte Instagram-, TikTok-, X- oder YouTube-Plattform-Properties unterstützen, bis Google den Bezeichner- und Endpunkt- vertrag dokumentiert.

Die vier APIs im Überblick

Googles eigene Beschreibung dessen, was die API tut: Sie ermöglicht es Ihnen, “view, add, or remove properties and sitemaps, run advanced queries for Google Search results data for the properties that you manage in Search Console, and test individual pages.” (Übersetzung) „Eigenschaften und Sitemaps anzeigen, hinzufügen oder entfernen, erweiterte Abfragen für Google-Suchergebnisdaten der Eigenschaften ausführen, die Sie in der Search Console verwalten, und einzelne Seiten testen.“ Das passt sauber auf die vier Ressourcen, alle unter webmaster-tools/v1:

• Search Analytics API – der Performance-Bericht, programmatisch: Klicks, Impressionen, CTR, Position nach Dimension (Suchanfrage, Seite, Land, Gerät, Suchdarstellung, Datum, Stunde).
• URL Inspection API – der Indexstatus einer einzelnen URL, das programmatische Pendant zum URL Inspection-Tool.
• Sitemaps API – Sitemaps auflisten, abrufen, einreichen und löschen.
• Sites API – verifizierte Eigenschaften auflisten, hinzufügen und entfernen.

Sie macht vieles von dem, was Sie bereits in der Oberfläche nutzen – den Performance- Bericht und das URL Inspection-Tool – als Endpunkte verfügbar, gegen die Sie Skripte schreiben können. Es ist jedoch kein 1:1-Spiegel: Die API garantiert keine vollständige UI-Parität (der Live-Test der URL Inspection ist beispielsweise nur über die UI verfügbar – siehe unten), und weder API-Zugriff noch Automatisierung garantieren für sich genommen Indexierung, Rankings, Traffic-Diagnose oder Sichtbarkeit in KI-Suchen.

Authentifizierung: OAuth 2,0, zwei Scopes, nur verifizierte Eigenschaften

Es gibt keinen API-Schlüssel. Jeder Aufruf erfolgt über OAuth 2,0 – Google stellt klar: “all requests to the Google Search Console API must be authorized by an authenticated user.” (Übersetzung) „Alle Anfragen an die Google Search Console API müssen von einem authentifizierten Benutzer autorisiert sein.“ Sie registrieren eine App in Google Cloud, fordern einen Scope an und erhalten ein kurzlebiges Zugriffstoken. Es gibt zwei Scopes:

• https://www.googleapis.com/auth/webmasters – Lese-/Schreibzugriff.
• https://www.googleapis.com/auth/webmasters.readonly – Nur-Lesezugriff.

Für Server-zu-Server-Automatisierung (einen nächtlichen Reporting-Job, einen Index-Monitor) gewähren Sie einem Dienstkonto Zugriff auf die Eigenschaft und überspringen den interaktiven Zustimmungsablauf.

Für Website-Eigenschaften sind auch hier zwei Eigenschaftsbezeichner-Formate relevant: Eine URL-Präfix-Eigenschaft wird als vollständige Eigenschafts-URL übergeben (Googles eigenes Beispiel ist http://www.example.com/), und eine Domain-Eigenschaft verwendet die Form sc-domain:example.com – Sie müssen die Form übergeben, die der Verifizierung der Eigenschaft in der Search Console entspricht. In jedem Fall muss dem Dienstkonto (oder Benutzer) Zugriff auf diese exakte Eigenschaft gewährt werden; es ist kein Umgehen der Inhaberschaft oder eine pauschale Freigabe für alle Eigenschaften des Kontos.

Und die Hürde, über die alle stolpern: “You must have appropriate access (owner, full, read) to any Google Search Console account that you wish to access using the API.” (Übersetzung) „Sie müssen über entsprechenden Zugriff (Inhaber, voll, lesend) auf jedes Google Search Console-Konto verfügen, auf das Sie über die API zugreifen möchten.“ Rufen Sie die API für eine Eigenschaft auf, für die Sie nicht verifiziert sind, und sie gibt nichts zurück – kein Fehler, den Sie unbedingt bemerken, sondern nur leere Daten.

Search Analytics API – der Performance-Bericht, in großem Maßstab

Beginnen Sie mit der Obergrenze, nicht mit der Bequemlichkeit: Googles eigener Hinweis lautet: “The API is bounded by internal limitations of Search Console and does not guarantee to return all data rows but rather top ones.” (Übersetzung) „Die API ist durch interne Grenzen der Search Console beschränkt und garantiert nicht, alle Datenzeilen zurückzugeben, sondern eher die obersten.“ Paginierung erweitert, wie weit Sie in diese Liste der obersten Zeilen blättern können – sie entfernt die Obergrenze nicht. Wenn Sie jede Zeile benötigen, ist das der Hinweis, auf den BigQuery-Massenexport (unten) zurückzugreifen, nicht auf ein größeres rowLimit.

Innerhalb dieser Obergrenze ist dies dennoch die API, wegen der die meisten kommen. Der Grund, warum sie die Oberfläche schlägt, ist der rowLimit-Parameter: „[Optional; gültiger Bereich ist 1–25 000; Standard ist 1 000].“ Der Export der Oberfläche liegt bei etwa 1 000 Zeilen; die API liefert bis zu 25 000 pro Anfrage, und Sie paginieren darüber hinaus mit startRow. Bei einer Website mit einem langen Schwanz an Suchanfragen ist das der Unterschied zwischen dem Sehen der Spitze Ihrer Daten und dem Sehen von mehr davon – immer noch nicht alles davon.

Zwei weitere Dinge bestimmen, was zurückkommt. Erstens steuert dataState die Aktualität: final (die Standardeinstellung) gibt nur finalisierte Daten zurück, all umfasst frische, kürzlich erhobene Daten, und hourly_all liefert stündliche Aufschlüsselungen, die ausdrücklich unvollständig sind – die Antwortmetadaten kennzeichnen ein first_incomplete_date oder first_incomplete_hour, und Google weist darauf hin, dass sich Werte nach diesem Zeitpunkt noch ändern können. Zweitens sind die Search-Analytics-Kontingente keine einzelne Zahl: Die Seite mit den Nutzungslimits unterteilt sie in Lastgrenzen (ein ressourcenbasiertes Kontingent, gemessen in 10-Minuten- und 1-Tages-Blöcken – breitere Datumsbereiche, mehr Dimensionen und stärkere Filterung zehren schneller daran) und die unten behandelten Anfrageratenlimits (QPS/QPM/QPD). Sie können die Lastgrenze erreichen, bevor Sie die Anfrageratengrenze erreichen.

URL Inspection API — und das Kontingent, das Sie tatsächlich einschränkt

Die URL-Inspektion-API “zeigt den indexierten oder indexierbaren Status der angegebenen URL an. Derzeit ist nur der Status der Version im Google-Index verfügbar; Sie können die Indexierbarkeit einer Live-URL nicht testen.” (Übersetzung) „Die URL-Inspektion-API zeigt den indexierten oder indexierbaren Status der angegebenen URL an. Derzeit ist nur der Status der Version im Google-Index verfügbar; Sie können die Indexierbarkeit einer Live-URL nicht testen.” Dieser letzte Satz ist eine echte Einschränkung des Anwendungsbereichs und keine Formalität: Das URL-Inspektionstool der Oberfläche kann einen Live-Test gegen die Seite ausführen, wie sie gerade existiert; die API kann nur über die Version berichten, die Google bereits indexiert hat. Nutzen Sie die API, um eine Index-Abdeckungsüberwachung über viele URLs hinweg aufzubauen – nicht als Ersatz für den Live-Test der Oberfläche.

Hier kommt es auf die Mathematik an. Pro Website erhalten Sie 2 000 Abfragen pro Tag und 600 pro Minute. (Pro Projekt liegt die Obergrenze weit höher – 10 000 000/Tag und 15 000/Minute –, aber die Obergrenze pro Website ist das, was wirklich zählt.) Wenn Sie den Indexstatus einer Website mit 50 000 URLs überwachen möchten, können Sie nicht alle an einem Tag prüfen; Sie bündeln und planen über mehrere Tage oder Sie priorisieren. Nur wenige Beiträge rechnen das durch, und es ist die mit Abstand größte Planungsbeschränkung für die Indexüberwachung in großem Maßstab.

Im Gegensatz dazu ist die Search Analytics großzügig – 1 200 QPM pro Website und pro Benutzer – und die anderen Ressourcen (Sitemaps, Sites) liegen bei 20 QPS / 200 QPM pro Benutzer. URL Inspection ist die restriktivste.

Sitemaps- und Sites-APIs

Die Sitemaps-API ist die Verwaltungsebene für Ihre Sitemaps: Sie „übermittelt eine Sitemap für eine Website”, „löscht eine Sitemap von dieser Website”, „ruft Informationen über eine bestimmte Sitemap ab” und „listet die für diese Website übermittelten Sitemap-Einträge auf, oder solche, die in der Sitemap-Indexdatei enthalten sind”. Die Sitemap-Ressource, die sie zurückgibt, enthält Felder wie path, lastSubmitted, isPending, isSitemapsIndex, lastDownloaded, warnings, errors und ein contents-Array – praktisch für die Überwachung der Sitemap-Gesundheit in großem Maßstab.

Die Sites API listet, fügt hinzu und entfernt verifizierte Properties – nützlich, wenn Sie viele Properties verwalten und diese programmatisch bereitstellen oder prüfen möchten.

Wann Sie den BigQuery-Bulk-Export verwenden sollten

Für große Websites wird das Modell der API mit 25 000 Zeilen pro Anfrage und nur den Top-Zeilen zum Limit. Googles Antwort ist keine fünfte API-Ressource, die dieselbe Datenform zurückgibt – sondern eine separate, geplante Export-Pipeline: der Bulk-Datenexport zu BigQuery. Betrachten Sie die Wahl als Pull vs. geplanter Push, nicht als „API A vs. API B.“ Googles eigene Formulierung: „Schedule a daily export of your Search Console performance data to BigQuery, where you can run complex queries over your data or export it to an external storage service. Using the bulk data export feature, you’ll see all the performance data available to Search Console for your property, with the exception of anonymized queries.” (Übersetzung) „Planen Sie einen täglichen Export Ihrer Search Console-Leistungsdaten zu BigQuery, wo Sie komplexe Abfragen über Ihre Daten ausführen oder sie an einen externen Speicherdienst exportieren können. Mit der Bulk-Datenexport-Funktion sehen Sie alle Leistungsdaten, die Search Console für Ihre Property zur Verfügung stehen, mit Ausnahme anonymisierter Abfragen.“

Das ist die Entscheidungsregel:

• Interfacexport – ca. 1 000 Zeilen, schnelle einmalige Ansicht.
• Search Analytics API – bis zu 25 000 Zeilen/Anfrage, paginierbar, skriptbar; ideal für moderate On-Demand-Abrufe und Dashboards.
• BigQuery-Massenexport – alle verfügbaren Leistungsdaten, täglich, ohne Zeilenlimit; das richtige Werkzeug, sobald Sie Zehntausende von Seiten oder Suchanfragen haben.

Das Einzige, was Ihnen keines davon liefert, sind anonymisierte Suchanfragen – die Begriffe, die Google aus Datenschutzgründen verbirgt. Das ist eine echte Lücke, kein Fehler, den man umgehen kann. Ich kenne das Ausmaß aus erster Hand: Als Ahrefs’ Markenbotschafter habe ich dazu beigetragen, eine Studie bekannt zu machen, in der wir alle über die API verfügbaren Daten über eine sehr große Stichprobe von Websites abgerufen haben und feststellten, dass Google den Suchbegriff bei einem großen Teil der Klicks verbirgt. Wir haben das später in den Ahrefs Rank Tracker eingebaut – vollständige Historie Ihrer GSC-Daten, den Prozentsatz der Klicks auf anonymisierte Suchanfragen und eine individuelle CTR-Kurve, die aus Ihren eigenen Zahlen erstellt wurde. Wenn Ihnen jemand sagt, die API liefere „alle Ihre Daten“, dann ist dieser anonymisierte Teil das ehrliche Sternchen.

Häufige Anwendungsfälle

• Automatisierte Berichte – geplante Abrufe in Sheets oder ein Data Warehouse.
• BI-Dashboards – Looker Studio oder BigQuery auf Basis der Performance-Daten.
• Index-/Abdeckungsüberwachung in großem Umfang – URL Inspection, innerhalb des Kontingents von 2 000/Tag gebündelt.
• CTR-Kurven-Erstellung – Modellierung der erwarteten CTR nach Position anhand Ihrer eigenen Daten.
• Anomalie-Warnungen – automatische Kennzeichnung von Klick-/Impressionseinbrüchen.

So funktionieren auch Tools von Drittanbietern: Wenn Ahrefs oder ein Looker-Studio-Connector „Search Console integriert“, rufen sie in Ihrem Namen genau diese APIs auf (und zunehmend den BigQuery-Export).

KI-Zusammenfassung

Eine komprimierte Darstellung der erweiterten Version:

• Die Search Console API = vier REST-APIs unter webmaster-tools/v1: Search Analytics (Performance-Daten), URL Inspection (Indexstatus), Sitemaps und Sites. Es ist keine vollständige UI-Parität – einige Dinge, wie der Live-Test von URL Inspection, existieren nur in der Oberfläche, und alleiniger API-Zugriff garantiert keine Indexierung, Rankings oder Verkehrsdiagnose.
• Die Authentifizierung erfolgt über OAuth 2,0, kein API-Schlüssel. Zwei Bereiche (webmasters, webmasters.readonly); Dienstkonten für Server-zu-Server, aber sie benötigen weiterhin expliziten Zugriff auf die genaue Property. siteUrl akzeptiert entweder eine URL-Präfix-Property oder eine sc-domain:example.com-Domain-Property – passen Sie sie an die Verifizierungsmethode an. Die API gibt nur Daten für Properties zurück, die Sie verifiziert haben – der häufigste Anfängerfehler.
• Search Analytics gibt zuerst die obersten Zeilen zurück, keinen vollständigen Export – „does not guarantee to return all data rows but rather top ones“, unabhängig von der Paginierung. Innerhalb dieser Grenze: 1–25 000 Zeilen pro Anfrage (Standard 1 000), gegenüber ~1 000 im Oberflächenexport, und Kontingente, die in Lastgrenzen und QPS/QPM/QPD-Anfrageratenlimits aufgeteilt sind.
• URL Inspection: 2 000 Abfragen/Tag, 600/Minute pro Website, und sie meldet nur die indexierte Version – sie kann keinen Live-Test durchführen. Dieses Kontingent ist die eigentliche Einschränkung für die Indexüberwachung in großem Umfang – bündeln und planen Sie entsprechend.
• Sitemaps-API listet/ruft ab/sendet/löscht Sitemaps; Sites-API listet/fügt hinzu/entfernt Properties.
• Für große Websites verwenden Sie den BigQuery-Massenexport – eine separate geplante Pipeline (keine fünfte API-Ressource), die täglich alle verfügbaren Leistungsdaten liefert, ohne Zeilenlimit, außer anonymisierte Suchanfragen.
• Anonymisierte Suchanfragen sind eine echte Lücke, die keine API oder kein Export füllt – Patricks Ahrefs-Arbeit hat quantifiziert, wie groß dieser versteckte Teil ist.

Offizielle Dokumentation

Primärquellen-Dokumentation von Google.

Search Console-API-Referenz

• Search Console-API – Übersicht/Info – was die API tut und die Anforderung an verifizierte Properties.
• Search Analytics: Abfrage-Referenz – die Parameter rowLimit (1–25 000) und Dimensionen.
• URL Inspection-API-Referenz – welche Indexstatus-Daten die inspect-Methode zurückgibt.
• Sitemaps-API-Referenz – auflisten, abrufen, einreichen, löschen.
• Sites-API-Referenz – verifizierte Properties auflisten, hinzufügen, entfernen.
• Nutzungslimits – die vollständige Kontingenttabelle pro Website, pro Benutzer und pro Projekt.
• Autorisieren von Anfragen (OAuth 2,0) – Bereiche und der Authentifizierungsablauf.

Massenexport von Daten

• Über den Massenexport von Daten (Search Console-Hilfe) – planen Sie einen täglichen BigQuery-Export aller Leistungsdaten mit Ausnahme anonymisierter Suchanfragen.
• Ankündigung zum Massenexport von Daten (Search Central-Blog) – der Einführungsbeitrag, der den Massenexport für große Websites positioniert.

Zitate aus der Quelle

Offizielle Aussagen aus der Google-Dokumentation. Jeder Link ist ein Deep Link, der zum zitierten Abschnitt auf der Quellseite springt.

Google – was die API tut und wer sie nutzen kann

• “view, add, or remove properties and sitemaps, run advanced queries for Google Search results data for the properties that you manage in Search Console, and test individual pages.” (Übersetzung) „Properties und Sitemaps anzeigen, hinzufügen oder entfernen, erweiterte Abfragen für Google-Suchergebnisdaten der Properties ausführen, die Sie in der Search Console verwalten, und einzelne Seiten testen.“ – Google Search Console-API-Dokumentation (Übersicht). Zum Zitat springen
• “You must have appropriate access (owner, full, read) to any Google Search Console account that you wish to access using the API.” (Übersetzung) „Sie müssen über entsprechenden Zugriff (Besitzer, Vollzugriff, Lesezugriff) auf jedes Google Search Console-Konto verfügen, auf das Sie über die API zugreifen möchten.“ – Google Search Console-API-Dokumentation (Übersicht). Zum Zitat springen
• “All requests to the Google Search Console API must be authorized by an authenticated user.” (Übersetzung) „Alle Anfragen an die Google Search Console-API müssen von einem authentifizierten Benutzer autorisiert werden.“ – Anleitung zum Autorisieren von Anfragen. Zum Zitat springen

Google – Search Analytics-API

• “[Optional; Valid range is 1–25,000; Default is 1 000]” – der Parameter rowLimit. – Search Analytics: Abfrage-Referenz. Zum Zitat springen
• “The URL of the property as defined in Search Console.” – der Parameter siteUrl, dessen Beispiele sowohl die URL-Präfix-Form (http://www.example.com/) als auch die Domain-Property-Form (sc-domain:example.com) angeben. (Übersetzung) „Die URL der Property, wie sie in der Search Console definiert ist.“ – Search Analytics: Abfrage-Referenz. Zum Zitat springen
• “The API is bounded by internal limitations of Search Console and does not guarantee to return all data rows but rather top ones.” (Übersetzung) „Die API unterliegt internen Beschränkungen der Search Console und garantiert nicht, alle Datenzeilen zurückzugeben, sondern vielmehr die wichtigsten.“ – Search Analytics: Abfrage-Referenz. Zum Zitat springen

Google – URL Inspection-API

• “View the indexed, or indexable, status of the provided URL. Presently only the status of the version in the Google index is available; you cannot test the indexability of a live URL.” (Übersetzung) „Zeigen Sie den indexierten oder indexierbaren Status der angegebenen URL an. Derzeit ist nur der Status der Version im Google-Index verfügbar; Sie können die Indexierbarkeit einer Live-URL nicht testen.“ – URL Inspection-API-Referenz. Zum Zitat springen

Google – Sitemaps-API

• “Submits a sitemap for a site.” / “Deletes a sitemap from this site.” / “Lists the sitemaps-entries submitted for this site, or included in the sitemap index file.” — Sitemaps API reference. (Übersetzung) „Reicht eine Sitemap für eine Website ein.“ / „Löscht eine Sitemap von dieser Website.“ / „Listet die für diese Website eingereichten Sitemap-Einträge auf, die in der Sitemap-Indexdatei enthalten sind.“ Zum Zitat springen

Google – Massendatenexport

• “Schedule a daily export of your Search Console performance data to BigQuery… you’ll see all the performance data available to Search Console for your property, with the exception of anonymized queries.” — Search Console Help: About bulk data export. (Übersetzung) „Planen Sie einen täglichen Export Ihrer Search Console-Leistungsdaten nach BigQuery … Sie sehen alle Leistungsdaten, die Search Console für Ihre Property zur Verfügung stehen, mit Ausnahme anonymisierter Suchanfragen.“ Zum Zitat springen

OAuth-Einrichtung & Checkliste für den ersten Aufruf

Von null zu einem funktionierenden Search Console-API-Aufruf:

• Stellen Sie sicher, dass Sie verifizierten Zugriff (Eigentümer, Vollzugriff oder Lesezugriff) auf die Property in Search Console haben – die API gibt für nicht verifizierte Properties nichts zurück.
• Erstellen Sie ein Projekt in der Google Cloud Console.
• Aktivieren Sie die Search Console API für dieses Projekt.
• Erstellen Sie Anmeldedaten: einen OAuth-2,0-Client (für interaktive/Benutzer-Apps) oder ein Dienstkonto (für Server-zu-Server-Automatisierung).
• Wenn Sie ein Dienstkonto verwenden, gewähren Sie ihm Zugriff auf die Property in den Search Console-Einstellungen.
• Fordern Sie den richtigen Bereich an: webmasters.readonly für Berichte, webmasters, wenn Sie Sitemaps einreichen oder Properties verwalten.
• Erhalten Sie ein Zugriffstoken über den OAuth-Ablauf (oder den Dienstkontoschlüssel).
• Stellen Sie sicher, dass das siteUrl-Format der Verifizierung der Property entspricht: eine vollständige URL für eine URL-Präfix-Property oder sc-domain:example.com für eine Domain-Property.
• Führen Sie einen Testaufruf an searchAnalytics.query mit einem kleinen Datumsbereich und rowLimit: 10 durch, um zu bestätigen, dass Daten zurückkommen.
• Planen Sie Kontingente ein: Die Anforderungsraten für Search Analytics sind großzügig, aber sie verbrauchen auch ein separates Lastkontingent; URL Inspection ist auf 2 000/Tag, 600/Min. pro Website begrenzt – planen Sie entsprechend. Erwarten Sie nicht, dass URL Inspection einen Live-Test durchführt – das ist nur über die Benutzeroberfläche möglich.
• Für Zehntausende von Zeilen richten Sie stattdessen den BigQuery-Massenexport ein, anstatt zu paginieren.

Die mentalen Modelle

1. Vier APIs, eine Authentifizierung. Search Analytics (lesen Sie Ihre Leistungsdaten), URL Inspection (lesen Sie den Indexstatus einer URL), Sitemaps (Sitemaps verwalten), Sites (Properties verwalten). Alle vier gehen durch dieselbe OAuth-2,0-Tür und respektieren dieselbe Regel für verifizierte Properties.

2. Die Datenskalenleiter. Wählen Sie das Werkzeug nach Volumen:

• Schneller Blick → Export über die Benutzeroberfläche (~1 000 Zeilen).
• Skriptbar, moderat → Search Analytics API (bis zu 25 000/Anfrage, paginieren).
• Große Website, vollständig → BigQuery-Massenexport (alle Daten, täglich, keine Zeilenbegrenzung). Bewegen Sie sich auf der Leiter nach oben, wenn die untere Sprosse nicht mehr zu Ihren Daten passt.

3. Top-Zeilen, nicht alle Zeilen. Verinnerlichen Sie, dass die API „Top-Zeilen“ und nicht alles zurückgibt und dass anonymisierte Suchanfragen sowohl von der API als auch vom Export ausgeschlossen sind. Wenn Vollständigkeit wichtig ist, ist BigQuery näher dran – aber der anonymisierte Teil fehlt in jedem Fall.

4. Kontingentarithmetik, bevor Sie bauen. Bevor Sie einen Index-Monitor entwerfen, rechnen Sie: URL Inspection ist 2 000/Tag pro Website. Eine Website mit 50 000 URLs kann nicht täglich überprüft werden – also bündeln, priorisieren oder über mehrere Tage planen. Entwerfen Sie um das Limit herum, entdecken Sie es nicht erst in der Produktion.

Search Console API – Spickzettel

Die vier APIs und ihre wichtigsten Grenzen

Authentifizierung

• Nur OAuth 2,0 – kein API-Schlüssel.
• Bereiche: webmasters (Lesen/Schreiben), webmasters.readonly (Lesen).
• Dienstkonten für Server-zu-Server-Kommunikation (gewähren Sie ihnen Property-Zugriff).
• Nur verifizierte Properties liefern Daten.

Kurz und bündig

• Die API liefert nur Top-Rows – nicht garantiert vollständig – unabhängig von der Paginierung.
• Der Export über die Benutzeroberfläche ist bei etwa 1 000 Zeilen gedeckelt; die API liefert bis zu 25 000/Anfrage, paginieren Sie mit startRow.
• Die Search-Analytics-Kontingente teilen sich in Lastlimits (ressourcenbasiert, 10-Minuten-/ 1-Tages-Blöcke) und die oben genannten QPS/QPM/QPD-Anfrageratenlimits.
• siteUrl akzeptiert eine URL-Präfix-Property (http://www.example.com/) oder eine Domain-Property (sc-domain:example.com) – passen Sie es an die Verifizierungsart an.
• URL Inspection meldet nur die indexierte Version – es kann keinen Live- Test durchführen; das ist nur über die Benutzeroberfläche möglich.
• Anonymisierte Suchanfragen sind von der API und vom BigQuery-Export ausgeschlossen.
• Für Zehntausende von Zeilen → BigQuery-Massenexport – eine separate geplante Pipeline, keine fünfte API-Ressource.
• Stellt einen Großteil des Performance-Berichts (Search Analytics) und des URL- Inspection-Tools bereit, ist aber keine vollständige Parität mit der Benutzeroberfläche.

Eine minimale Search-Analytics-Anfrage

Dies ist illustrativ, nicht zum Kopieren und Einfügen geeignet – Sie müssen Ihre eigenen OAuth-Anmeldedaten einrichten und die Daten und die Property anpassen. Es zeigt die Struktur eines searchAnalytics.query-Aufrufs: den Anfragetext mit einem Datumsbereich, die gewünschten Dimensionen und das rowLimit.

Der Anfragetext (der relevante Teil)

{
  "startDate": "2026-05-01",
  "endDate": "2026-05-31",
  "dimensions": ["query", "page"],
  "rowLimit": 25000,
  "startRow": 0
}

Sketch in Python (with the google-api-python-client library)

# Illustrative only — assumes you've already built an authorized `service`
# via OAuth 2.0 (scope: webmasters.readonly) or a service account.
from googleapiclient.discovery import build

service = build("searchconsole", "v1", credentials=creds)

request = {
    "startDate": "2026-05-01",
    "endDate": "2026-05-31",
    "dimensions": ["query", "page"],
    "rowLimit": 25000,   # max per request; default is 1000
    "startRow": 0,       # bump by 25000 to paginate
}

response = service.searchanalytics().query(
    siteUrl="https://example.com/",  # URL-prefix property; use "sc-domain:example.com"
                                      # instead for a Domain property — must be verified
    body=request,
).execute()

for row in response.get("rows", []):
    print(row["keys"], row["clicks"], row["impressions"])

Um über 25 000 Zeilen hinauszugehen, iterieren Sie in einer Schleife und erhöhen Sie startRow um 25 000, bis eine Anfrage keine Zeilen mehr zurückgibt. Denken Sie daran, dass das Ergebnis immer noch „Top-Rows“ sind, kein vollständiger Export – verwenden Sie dafür den BigQuery-Massenexport.

Tools, die die Search-Console-API verwenden (oder darum herum gebaut sind)

• Google Cloud Console – hier erstellen Sie das Projekt, aktivieren die API und erstellen OAuth-/Dienstkontoberechtigungen.
• Offizielle Client-Bibliotheken – Google-API-Clientbibliotheken für Python, Java, JavaScript/Node, PHP und .NET kapseln die REST-Aufrufe.
• BigQuery – das Ziel für den Massendatenexport; fragen Sie alle Ihre Leistungsdaten mit SQL ab.
• Looker Studio – verbindet sich mit der Search Console (und BigQuery) für Dashboards, die auf denselben Daten basieren.
• Ahrefs – integriert die Search-Console-API; der Rank Tracker zeigt den vollständigen GSC-Verlauf, den Anteil der Klicks auf anonymisierte Suchanfragen und eine eigene CTR-Kurve aus Ihren eigenen Daten.
• Search-Console-Oberfläche – der Leistungsbericht und das URL-Inspektionstool sind die manuellen Gegenstücke zu den Search-Analytics- und URL-Inspektions-APIs, mit einer Lücke, die die API nicht schließen kann: Nur das Oberflächentool kann einen Live-Test auf einer URL durchführen.

Prompts für die Planung von Search-Console-API-Arbeiten

Verwenden Sie diese Prompts, um Code oder einen Analyseplan zu erstellen. Halten Sie Anmeldedaten, Aktualisierungstokens und Dienstkontoschlüssel aus jeglicher Chat-Eingabe heraus.

Entwerfen Sie eine Search-Analytics-Anfrage

Fügen Sie Ihre Property-URL, den Datumsbereich, Dimensionen, Filter und das Berichtsziel ein.

Design a Google Search Console Search Analytics API request for the following reporting task.

Property: [sc-domain:example.com or exact URL-prefix property]
Date range: [start and end]
Goal: [the question the report must answer]
Dimensions: [date, query, page, country, device, searchAppearance, or hour]
Filters: [include/exclude rules]

Return:
1. The request body, including a rowLimit no higher than 25,000.
2. Pagination logic using startRow.
3. The aggregation and grouping needed after retrieval.
4. Warnings about top-rows-only data and anonymized queries.
5. A small validation query I can run before scheduling the full pull.

Do not invent credentials or assume the result is a complete census.

Planen Sie einen quotensicheren URL-Inspektionszeitplan

Fügen Sie eine CSV-Zusammenfassung oder Zählungen nach URL-Priorität ein, anstatt vertrauliche Tokens.

Create a quota-safe sampling and scheduling plan for the Search Console URL Inspection API.

Property: [property]
Total URLs: [count]
Priority groups: [critical templates, new URLs, changed URLs, long-tail sample]
Required revisit cadence: [daily, weekly, monthly]

Constraints from this article:
- 2,000 inspection queries per day per site.
- 600 inspection queries per minute per site.
- The API reports the indexed version, not a live test.

Return a daily allocation by priority group, a rotation method, retry/backoff rules,
and alerts for unexpected index or canonical states. Explain what cannot fit inside
the quota instead of silently dropping it.

Wählen Sie zwischen API und BigQuery-Export

Help me choose between the Search Console interface, Search Analytics API, and BigQuery bulk export.

Reporting need: [one-off analysis, dashboard, warehouse, anomaly alerts]
Expected rows per day: [estimate]
History required: [range]
Refresh cadence: [cadence]
Dimensions needed: [list]
Infrastructure available: [spreadsheet, script runner, BigQuery, BI tool]

Compare setup cost, row/completeness limits, automation, and maintenance. Account for
the API returning top rows and for anonymized queries being absent from every path.
End with one recommendation and the smallest proof-of-concept to validate it.

Ressourcen, die Ihre Zeit wert sind

Meine verwandten Arbeiten

• Ahrefs-Blog – meine Beiträge – einschließlich der Arbeit zu GSC-Daten in großem Umfang und anonymisierten Suchanfragen.
• Jetzt im Ahrefs Rank Tracker: vollständiger GSC-Verlauf + Anteil anonymisierter Suchanfragen – die CTR-Kurven- und GSC-Verlaufsfunktion, die ich angekündigt habe.

Dokumentation von Google

• Search-Console-API-Übersicht und die Seite Nutzungslimits – die beiden Seiten, die Sie zuerst mit einem Lesezeichen versehen sollten.
• Über den Massendatenexport – wann und wie Sie zu BigQuery wechseln.

Von anderen

• Versteckte Keywords in GSC – die Ahrefs-Studie (Berichterstattung im Search Engine Journal) – Drittanbieter-Bericht über die Ergebnisse zu anonymisierten Suchanfragen.
• Erweiterte Search-Console-Analysen mit BigQuery (SEJ) – ein praktischer Blick auf den Massenexport-Pfad.
• Massendatenexport: Eine neue und leistungsstarke Möglichkeit, auf Ihre Search-Console-Daten zuzugreifen (Google Search Central Blog) – der Beitrag vom Februar 2023 vom Search-Console-Team, der den Massenexport für große Websites positioniert.
• google-api-python-client (PyPI) – die offizielle Python-Clientbibliothek zum Aufrufen der Search-Console-API; auch für Node, Java, PHP und .NET über die Google-APIs-Clientbibliotheksfamilie verfügbar.
• r/TechSEO – die Community für API- und Datenabruf-Fehlerbehebung.

Statistiken, die sich zu zitieren lohnen

• Search Analytics Zeilengrenze: 25 000 pro Anfrage (Standard 1 000) – im Vergleich zur Exportobergrenze der Oberfläche von etwa 1 000 Zeilen. Dies ist der Hauptgrund, die API zu nutzen. Quelle
• URL Inspection Kontingent: 2 000 Abfragen/Tag und 600/Minute pro Website – die harte Obergrenze für großflächiges Index-Monitoring (10 Mio./Tag, 15 000/Minute pro Projekt). Quelle
• Anonymisierte Abfragen sind ausgeschlossen – selbst aus dem vollständigsten Pfad (BigQuery-Massenexport) – eine echte, unvermeidbare Lücke in Ihren Abfragedaten. Quelle
• Google verbirgt den Suchbegriff bei einem großen Teil der Klicks – aus der Ahrefs-Studie, die ich mit aufgedeckt habe und die alle verfügbaren Daten aus der API über eine sehr große Stichprobe von Websites abruft. Abdeckung

Testen Sie sich selbst: Search Console API

Fünf kurze Fragen zu den APIs, Authentifizierung, Datenlimits und Skalierung. Wählen Sie eine Antwort für jede Frage und überprüfen Sie dann Ihr Ergebnis.

Änderungsprotokoll