Histórico de posições
API + MCPGET/v3/gsc/positions-history
As solicitações para este endpoint são gratuitas e não consomem unidades da API.
Parâmetros de consulta
project_idinteger
ID do projeto. Obrigatório quando o portfolio_id não é fornecido.
portfolio_idinteger
ID do Portfolio. Quando fornecido, agrega dados de todos os projetos conectados ao GSC no Portfolio.
date_fromstring (date)Obrigatório
A data de início do período histórico, no formato YYYY-MM-DD.
date_tostring (date)
A data de término do período histórico, no formato YYYY-MM-DD.
history_groupingstring
O intervalo de tempo usado para agrupar os dados históricos.
Valores permitidos:dailyweeklymonthly
Padrão:monthly
search_typestring
O tipo de resultados da pesquisa a serem retornados (web, imagem, vídeo, notícias).
Valores permitidos:webimagevideonews
Padrão:web
countrystring
Um código de país de duas letras (ISO 3166-1 alpha-2).
Valores permitidos:adaeafagaialamaoarasatauawazba…
devicestring
Filtra por tipo de dispositivo (DESKTOP, MOBILE, TABLET). Se não especificado, todos os dispositivos serão incluídos.
Valores permitidos:desktopmobiletablet
wherestring
Campos compatíveis:
outputstring
O formato de saída.
Valores permitidos:jsoncsvxmlphp
Respostas
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
errorstring
errorstring
errorstring
errorstring
errorstring