Search Console API · REST v1 · Live-Doku

Google Search Console API für Ihren eigenen Stack

Ihre Search-Console-Performancedaten über einen sauberen REST-Endpunkt.

Holen Sie Klicks, Impressionen, CTR und durchschnittliche Position — nach Suchanfrage, Seite und Zeitraum — direkt aus der Google Search Console in Ihr Produkt, Ihr Dashboard oder Ihr Data Warehouse. Verbinden Sie GSC einmal in SEOcrawl AI, erstellen Sie einen Bearer-Schlüssel in Ihrem Dashboard und rufen Sie die REST /v1 auf — ganz ohne selbst gebautes Google-OAuth. Es ist dieselbe kanonische Datenschicht, die auch das MCP von SEOcrawl AI antreibt, Ihre Zahlen stimmen also immer überein. Indexabdeckung und URL-Prüfung kommen als Nächstes auf REST; über das MCP sind sie bereits live.

Claude
Codex CLI
Cursor
Google Search Console API von SEOcrawl AI — eine curl-Anfrage und die typisierte JSON-Antwort mit Klicks, Impressionen, CTR und Position.
Beispielanfragen an die Google Search Console API in cURL, JavaScript und Python.

Property ermitteln. GSC-Daten abrufen.

Erstellen Sie ein Bearer-Token in Ihrem Dashboard und übergeben Sie es im Authorization-Header. Ermitteln Sie einmal die id Ihrer Search-Console-Property und fragen Sie deren Performance danach per REST ab. Derselbe Schlüssel funktioniert bei der REST-API und beim MCP-Server.

Basis-URL

https://api.seocrawl.ai/v1

Authorization-Header

Authorization: Bearer sca_live_your_token_here

Jede Search-Console-Metrik, per REST

Klicks, Impressionen, CTR und durchschnittliche Position — nach Suchanfrage, Seite, Zeitraum und Periode zu Periode. Jeder Endpunkt ist an eine Property gebunden: erst die id der Property ermitteln, dann deren Search-Console-Daten lesen. Diese GSC-Gruppen sind in v1 live; Indexabdeckung und URL-Prüfung liefert heute das MCP und landen als Nächstes auf REST.

Properties

Listet die Search-Console-Properties auf, die mit Ihrem Konto verbunden sind. Verwenden Sie die id jeder Property im Pfad jedes GSC-Endpunkts.

  • GET/v1/propertiesLive

Performance

Klicks, Impressionen, CTR und durchschnittliche Position als Summe für einen Zeitraum — plus die Veränderung gegenüber der Vorperiode für dasselbe Fenster.

  • GET/v1/properties/{id}/gsc/summaryLive
  • GET/v1/properties/{id}/gsc/compareLive

Suchanfragen

Die Suchanfragen, für die Sie ranken, mit Metriken je Anfrage — und die vollständige Tageshistorie zu jedem einzelnen Keyword.

  • GET/v1/properties/{id}/gsc/top-keywordsLive
  • GET/v1/properties/{id}/gsc/keywords/detailLive

Seiten

Ihre stärksten URLs samt Search-Console-Metriken — und die vollständige tägliche Aufschlüsselung zu jeder einzelnen Seite.

  • GET/v1/properties/{id}/gsc/top-pagesLive
  • GET/v1/properties/{id}/gsc/pages/detailLive

Indexabdeckung

Was Google tatsächlich indexiert: Abdeckungsstatus und Indexierungsverlauf. Heute im MCP verfügbar; die REST-Endpunkte werden gerade ausgerollt.

  • GET/v1/properties/{id}/indexation/summaryBald

URL-Prüfung

Prüfung URL für URL — Abdeckung, letzter Crawl und Indexierungsstatus einer einzelnen Seite. Über das MCP schon jetzt verfügbar; REST folgt.

  • GET/v1/properties/{id}/url-inspectionBald

Echte Search-Console-Daten, gebaut für Produkte

Ihre tatsächliche Google-Search-Console-Performance — keine Schätzungen von Drittanbietern — über eine saubere REST-API mit Bearer-Auth und Rate Limits, auf einer gemeinsamen kanonischen Datenschicht mit dem MCP, damit die Zahlen nie auseinandergehen.

Direkt aus der Search Console

Klicks, Impressionen, CTR und durchschnittliche Position aus Ihrer eigenen GSC-Property — die echten Zahlen, die Google meldet, keine modellierten oder gescrapten Schätzwerte. Vorhersagbare Ressourcen, Standard-Verben, typisiertes JSON und RFC-konforme Fehler.

Kein eigenes Google-OAuth

Verbinden Sie die Search Console einmal in SEOcrawl AI und lesen Sie sie mit einem einzigen sca_live_ Bearer-Schlüssel. Kein Google-Cloud-Projekt, kein Zustimmungsbildschirm, kein Token-Refresh — Schlüssel erstellen und widerrufen Sie in Sekunden in Ihrem Dashboard.

Eine kanonische Datenschicht

Die REST-GSC-Endpunkte und die GSC-Tools des MCP sind Geschwister über demselben Provider, mit in CI getesteter Parität. Ihr Dashboard und Ihre KI-Agenten sehen immer identische Klicks, Impressionen und Positionen.

Granular nach Anfrage und Seite

Lesen Sie die Summen einer Property oder gehen Sie ins Detail: Top-Suchanfragen, Top-Seiten, der Tagesverlauf eines einzelnen Keywords oder die Historie einer einzelnen URL — dieselben Dimensionen wie in der Search Console, adressierbar per HTTP.

Periodenvergleich schon eingebaut

Fragen Sie einen range (last_7_days, last_28_days, last_3_months, last_year) oder explizite from/to-Daten an und erhalten Sie den Periodenvergleich direkt mit — ohne zweiten Aufruf und ohne Datumsrechnerei im Client, um Veränderungen abzugleichen.

Dokumentierte Rate Limits

60 Anfragen pro Minute und 1.000 pro Stunde je Token, mit klaren 429-Antworten plus Retry-After. Die REST-Limits sind ein eigener Topf, getrennt vom MCP-Verbrauch — keiner nimmt dem anderen das Kontingent weg.

Starten in 3 Schritten

Von null zum ersten Search-Console-Aufruf in wenigen Minuten.

1

Schlüssel erstellen

Verbinden Sie die Search Console in SEOcrawl AI, öffnen Sie API-Tokens und erzeugen Sie ein Bearer-Token. Kopieren Sie es einmalig — es beginnt mit sca_live_.

2

Property ermitteln

Rufen Sie GET /v1/properties mit Authorization: Bearer sca_live_… auf, um die id (eine UUID) der Search-Console-Property zu erhalten, die Sie lesen möchten.

3

GSC-Daten abrufen

Rufen Sie /v1/properties/{id}/gsc/summary?range=last_28_days für die Summen auf, oder /gsc/top-keywords, /gsc/top-pages und die /detail-Endpunkte — und leiten Sie das JSON direkt in Ihr Produkt, Ihr Dashboard oder Ihr Warehouse.

Drei Wege zu Ihren Search-Console-Daten

Dieselben GSC-Zahlen, andere Oberfläche — wählen Sie, was zu Ihrer Arbeitsweise passt.

REST-API

Für Produkte, Dashboards und Datenpipelines. Bearer-Auth, typisiertes JSON, Rate Limits. Sie sind gerade hier — die vollständige SEO-API ergänzt mit demselben Schlüssel Ranking- und KI-Sichtbarkeitsendpunkte.

MCP-Server

Für KI-Agenten — Claude, ChatGPT und jeder MCP-Client befragen Ihre Search-Console-Daten in natürlicher Sprache.

Das MCP erkunden

Terminal & CLI

Für Skripte und CI/CD — steuern Sie Ihre GSC-Daten aus jedem MCP-fähigen Terminal-Agenten.

Zur CLI

Wer auf der Search Console API entwickelt

Teams, die echte GSC-Performancedaten in ihren eigenen Systemen brauchen.

Agenturen

Leiten Sie die Search-Console-Daten jedes Kunden in ein eigenes Portal, nach Looker Studio oder in Ihre Reporting-Schicht — ein Schlüssel, alle Properties, keine manuellen GSC-Exporte.

SaaS & Partner

Betten Sie Live-Metriken aus der Search Console direkt in Ihre eigene Produktoberfläche ein. Geben Sie Ihren Nutzern Klicks, Impressionen und Positionen, ohne Googles API selbst zu verdrahten.

Datenteams

Laden Sie GSC-Klicks, -Impressionen, -CTR und -Position planmäßig in Ihr Warehouse. Verknüpfen Sie sie mit Umsatzdaten und bauen Sie die Modelle, die Ihre Dashboards brauchen.

Entwickler

Automatisieren Sie das Monitoring von Suchanfragen und Seiten, lassen Sie sich bei Ranking-Einbrüchen alarmieren und verdrahten Sie Search-Console-Daten mit den Apps und Workflows, die Sie ohnehin betreiben.

Häufige Fragen

Ist das die offizielle Search Console API von Google?

Nein. Das ist die eigene, Bearer-authentifizierte REST-API von SEOcrawl AI auf den Search-Console-Daten, die Sie bereits mit Ihrem Konto verbunden haben. Sie verbinden GSC einmal in SEOcrawl AI und lesen danach Klicks, Impressionen, CTR und Position über einen einzigen sca_live_-Schlüssel — ohne Google-Cloud-Projekt, OAuth-Zustimmungsbildschirm oder eigenen Token-Refresh. Die Zahlen sind Ihre echten Search-Console-Zahlen; die API und die Authentifizierung sind unsere.

Welche Search-Console-Daten kann ich heute abrufen?

Summen für einen Zeitraum (Klicks, Impressionen, CTR, durchschnittliche Position), Periodenvergleiche, Ihre Top-Suchanfragen und Top-Seiten mit Metriken sowie das vollständige Tagesdetail zu einem einzelnen Keyword oder einer einzelnen Seite — dazu die Liste Ihrer verbundenen Properties. Indexabdeckung und die Live-URL-Prüfung sind heute schon über das MCP verfügbar; die zugehörigen REST-Endpunkte folgen als Nächstes. Wenn Sie das Konto lieber lesen als abfragen möchten, deckt das Google-Search-Console-Audit dieselben Daten in einem einzigen Prompt ab.

Wie authentifiziere ich mich?

Mit einem Bearer-Token. Erstellen Sie einen sca_live_-Schlüssel in Ihrem Dashboard und senden Sie ihn als Authorization: Bearer <schlüssel> bei jedem Request. Für Ihr eigenes Konto gibt es keinen OAuth-Tanz — nur den Header.

Welche Zeiträume werden unterstützt?

Jeder GSC-Endpunkt akzeptiert entweder einen range (last_7_days, last_28_days, last_3_months oder last_year) oder ein explizites from/to-Paar. Der Endpunkt gsc/compare liefert dasselbe Fenster im Vergleich zur Vorperiode, Sie erhalten die Veränderungen also ohne zweiten Aufruf.

Wie sehen die Rate Limits aus?

60 Anfragen pro Minute und 1.000 pro Stunde je Token. Wer sie überschreitet, bekommt ein 429 mit Retry-After-Header. Die REST-Limits werden getrennt vom MCP-Verbrauch gezählt, die beiden konkurrieren also nie um dasselbe Budget.

Sind das derselbe Schlüssel und dieselben Daten wie beim MCP?

Ja. Dasselbe sca_live_-Token authentifiziert sowohl die REST-API als auch den MCP-Server, und beide lesen aus einer kanonischen Datenschicht — die Search-Console-Zahlen, die Sie per REST abrufen, sind also identisch mit dem, was Ihre KI-Agenten über das MCP sehen. Ein Credential, zwei Oberflächen.

Bereit, auf Ihren Search-Console-Daten aufzubauen?

GSC einmal verbinden, Bearer-Schlüssel im Dashboard erstellen und in Minuten den ersten Search-Console-REST-Aufruf absetzen — oder das MCP für KI-Agenten erkunden.