Docs
Dokumentation durchsuchen...⌘K

Ranking-Historie

API + MCP
GET/v3/gsc/positions-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

Antworten

metricsarray<object>
datestring (date-time)
position_11_to_20integer
position_1_to_3integer
position_21_to_50integer
position_4_to_10integer
position_51_plusinteger
totalinteger