REST API Guide: Search Console Daten automatisiert abrufen

Voraussetzungen

Die REST API ist ab dem Agency-Plan (65 €/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

Die API ist auf eine bestimmte Anzahl Requests pro Minute limitiert, um die Stabilität für alle Nutzer zu gewährleisten. Bei Überschreitung erhältst du einen HTTP 429 Response mit einem Retry-After Header. Implementiere in deinen Scripts ein exponentielles Backoff.

Beispiel: Performance-Daten abrufen

Mit cURL

curl -X GET \
  "https://tool.search-console.pro/api/v1/performance?property=example.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

Performance

Abruf von Klicks, Impressions, CTR und Position – gefiltert nach Datum, Property, URL oder Query. Unterstützt Aggregation nach Tag, Woche oder Monat. Hier liegt der große Vorteil: Du kannst Daten über 16 Monate hinaus abrufen, weil wir sie unbegrenzt speichern.

Properties

Liste aller verbundenen Properties mit Metadaten (letzter Sync, Anzahl Datensätze, SCI Score).

SCI Index

Aktueller und historischer SCI Score für jede Property. Ideal für automatisierte Reportings und Monitoring-Dashboards.

URL Inspection

Indexierungsstatus einzelner URLs abfragen. Nützlich für automatisierte Workflows: Neue Seite veröffentlicht → API-Call → Status prüfen → ggf. Indexierung beantragen.

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

Die API gibt Standard-HTTP-Statuscodes zurück: 200 für Erfolg, 401 für fehlende/ungültige Authentifizierung, 429 für Rate-Limit, 500 für Serverfehler. Jeder Error-Response enthält eine Request-ID, die du bei Support-Anfragen angeben kannst.

Vollständige Dokumentation

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