REST API Guide: Search Console Daten automatisiert abrufen

Voraussetzungen

Die REST API ist ab dem Agency-Plan (249 €/Monat) verfügbar. Du findest deinen API-Key in den Einstellungen unter „API-Zugang".

Authentifizierung

Jeder API-Request benötigt deinen API-Key im Header:

Authorization: Bearer dein-api-key-hier

Der API-Key identifiziert dich und gewährt Zugriff auf alle Properties deines Accounts. Behandle ihn wie ein Passwort.

Rate-Limits

120 Anfragen pro Minute je Schlüssel. Jede Antwort trägt die Header X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset – dein Client kann das verbleibende Kontingent also auslesen, statt zu raten. Bei Überschreitung kommt 429 mit Retry-After.

Beispiel: Performance-Daten abrufen

Mit cURL

curl -X GET \
  "https://tool.search-console.pro/api/v1/properties/12/performance?dimension=query.com&start=2025-01-01&end=2026-01-31" \
  -H "Authorization: Bearer dein-api-key"

Mit Python

import requests

API_KEY = "dein-api-key"
BASE_URL = "https://tool.search-console.pro/api/v1"

response = requests.get(
    f"{BASE_URL}/performance",
    headers={"Authorization": f"Bearer {API_KEY}"},
    params={
        "property": "example.com",
        "start": "2025-01-01",
        "end": "2026-01-31"
    }
)

data = response.json()
print(f"Klicks: {data['totals']['clicks']}")
print(f"Impressions: {data['totals']['impressions']}")

Verfügbare Endpoints

Sieben Endpunkte, alle lesend. Die vollständige Referenz mit Parametern und Beispielantworten steht in der API-Dokumentation.

Properties

GET /properties und GET /properties/{id} – alle verbundenen Properties mit Metadaten wie Berechtigungsstufe und letztem Abgleich.

Performance

GET /properties/{id}/performance – Klicks, Impressionen, CTR und Position. Über den Parameter dimension wahlweise nach Datum, Suchanfrage, Seite, Land oder Gerät. Hier liegt der eigentliche Vorteil: Du kommst an Daten jenseits der 16 Monate, die Google vorhält.

Keywords

GET /properties/{id}/keywords – die beobachteten Keywords mit ihrer jeweils jüngsten Position.

SCI Index

GET /properties/{id}/sci – Verlauf des Search Console Index inklusive Aufschlüsselung nach den sechs Faktoren.

Crawls

GET /crawls und GET /crawls/{id} – Liste der Onpage-Crawls und Detailansicht mit den nach Typ gruppierten Problemen.

Typische Anwendungsfälle

Automatisierte Kunden-Reports

Rufe Performance-Daten per API ab, verarbeite sie in deinem Reporting-Tool (Google Data Studio, eigenes Dashboard, Excel) und versende sie automatisch an Kunden. Kein manueller Export mehr.

Monitoring & Alerting

Prüfe täglich per Cronjob den SCI Score aller Properties. Bei Abweichungen über einem Schwellenwert: Slack-Benachrichtigung oder E-Mail. So erkennst du Ranking-Einbrüche, bevor der Kunde anruft.

Daten-Integration

Kombiniere Search Console Daten mit anderen Quellen: Google Analytics, CRM, E-Commerce-Backend. So kannst du Fragen beantworten wie „Welche organischen Keywords führen zu den meisten Käufen?"

Fehlerbehandlung

Fehler kommen immer als JSON im Format {"error":{"code":"…","message":"…"}}. Neben den üblichen Statuscodes gibt es sprechende Codes: insufficient_scope, wenn dem Schlüssel eine Berechtigung fehlt, plan_required unterhalb des Agency-Plans und rate_limited bei zu vielen Anfragen. Fremde IDs beantwortet die API bewusst mit 404 statt 403 – sonst ließe sich durch Ausprobieren herausfinden, welche IDs existieren.

Vollständige Dokumentation

Die komplette API-Referenz mit allen Endpoints, Parametern und Response-Formaten findest du in unserer API-Dokumentation.