Histórico da página

API + MCP

GET/v3/gsc/page-history

As solicitações para este endpoint são gratuitas e não consomem unidades da API.

Parâmetros de consulta

pagesstring

Uma lista de URLs de páginas separadas por vírgula para obter dados de histórico.

devicestring

Filtre por tipo de dispositivo (DESKTOP, MOBILE, TABLET). Se não for especificado, todos os dispositivos serão incluídos.

Valores permitidos:desktopmobiletablet

countrystring

Um código de país com duas letras (ISO 3166-1 alpha-2).

Valores permitidos:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

history_groupingstring

O intervalo de tempo usado para agrupar os dados históricos.

Valores permitidos:dailyweeklymonthly

Padrão:monthly

date_tostring

A data final do período histórico, no formato YYYY-MM-DD.

date_fromstringObrigatório

A data inicial do período histórico, no formato YYYY-MM-DD.

portfolio_idinteger

ID do Portfolio. Quando fornecido, agrega dados de todos os Projetos conectados ao GSC no portfolio.

project_idinteger

ID do Projeto. Obrigatório quando portfolio_id não é fornecido.

outputstring

O formato de saída.

Valores permitidos:jsoncsvxmlphp

Respostas

metricsarray<object>

pagestring

datestring

clicksinteger

impressionsinteger

ctrnumber

positionnumber

Posição média (decimal, ex.: 4,7)