Performance-Historie

API + MCP

GET/v3/gsc/performance-history

Anfragen an diesen Endpunkt sind kostenlos und verbrauchen keine API-Einheiten.

Query-Parameter

project_idinteger

Projekt-ID. Erforderlich, wenn portfolio_id nicht angegeben ist.

portfolio_idinteger

Portfolio-ID. Wenn angegeben, werden Daten aus allen mit GSC verbundenen Projekten im Portfolio aggregiert.

date_fromstring (date)Erforderlich

Das Startdatum des historischen Zeitraums im Format YYYY-MM-DD.

date_tostring (date)

Das Enddatum des historischen Zeitraums im Format YYYY-MM-DD.

history_groupingstring

Das Zeitintervall, das zum Gruppieren historischer Daten verwendet wird.

Zulässige Werte:dailyweeklymonthly

Standard:monthly

search_typestring

Die Art der zurückzugebenden Suchergebnisse (web, image, video, news).

Zulässige Werte:webimagevideonews

Standard:web

countrystring

Ein aus zwei Buchstaben bestehender Ländercode (ISO 3166-1 alpha-2).

Zulässige Werte:adaeafagaialamaoarasatauawazba…

devicestring

Nach Gerätetyp filtern (DESKTOP, MOBILE, TABLET). Falls nicht angegeben, werden alle Geräte einbezogen.

Zulässige Werte:desktopmobiletablet

wherestring

Unterstützte Felder:

outputstring

Das Ausgabeformat.

Zulässige Werte:jsoncsvxmlphp

metricsarray<object>

clicksinteger

ctrnumber (float)

datestring (date-time)

impressionsinteger

positionnumber (float)

Durchschnittliche Position (Dezimalzahl, z. B. 4,7)