Docs
Szukaj w dokumentacji...⌘K

Historia strony

API + MCP
GET/v3/gsc/page-history

Żądania do tego punktu końcowego są bezpłatne i nie zużywają żadnych jednostek API.

Parametry zapytania

pagesstring

Lista adresów URL stron oddzielonych przecinkami, dla których mają zostać pobrane dane historyczne.

devicestring

Filtruj według typu urządzenia (DESKTOP, MOBILE, TABLET). Jeśli nie podano, uwzględniane są wszystkie urządzenia.

Dozwolone wartości:desktopmobiletablet
countrystring

Dwuliterowy kod kraju (ISO 3166-1 alpha-2).

Dozwolone wartości:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
history_groupingstring

Przedział czasu używany do grupowania danych historycznych.

Dozwolone wartości:dailyweeklymonthly
Domyślne:monthly
date_tostring (date)

Data końcowa okresu historycznego w formacie YYYY-MM-DD.

date_fromstring (date)Wymagane

Data początkowa okresu historycznego w formacie YYYY-MM-DD.

portfolio_idinteger

ID Portfolio. Jeśli podano, agreguje dane ze wszystkich projektów połączonych z GSC w ramach Portfolio.

project_idinteger

ID Projektu. Wymagane, gdy nie podano portfolio_id.

outputstring

Format wyjściowy.

Dozwolone wartości:jsoncsvxmlphp

Odpowiedzi

metricsarray<object>
pagestring (url)
datestring (date)
clicksinteger
impressionsinteger
ctrnumber (float)
positionnumber (float)

Średnia pozycja (wartość dziesiętna, np. 4.7)