Performance nach Position

API + MCP

GET/v3/gsc/performance-by-position

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.

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>

clicksinteger

clicks_percentnumber (float)

impressionsinteger

impressions_percentnumber (float)

keyword_countinteger

keyword_count_percentnumber (float)

position_rangestring

{ "metrics": [ { "clicks": 0, "clicks_percent": 0.0, "impressions": 0, "impressions_percent": 0.0, "keyword_count": 0, "keyword_count_percent": 0.0, "position_range": "string" } ] }