Seiten-Verlauf

API + MCP

GET/v3/gsc/page-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

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

pagesstring

Eine durch Kommas getrennte Liste von Seiten-URLs, für die Verlaufsdaten abgerufen werden sollen.

outputstring

Das Ausgabeformat.

Zulässige Werte:jsoncsvxmlphp

metricsarray<object>

clicksinteger

ctrnumber (float)

datestring (date-time)

impressionsinteger

pagestring (url)

positionnumber (float)

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