Melhores páginas

API + MCP

GET/v3/site-explorer/top-pages

Parâmetros de consulta

timeoutinteger

Um tempo limite manual em segundos.

limitinteger

O número de resultados a retornar.

Padrão:1000

order_bystring

Uma lista de colunas separadas por vírgula para ordenar os resultados, com direção opcional. Consulte o schema de resposta para ver identificadores de coluna válidos.

Example:field_a,field_b:asc,field_c:desc

wherestring

A expressão de filtro. Os seguintes identificadores de coluna são reconhecidos (isso difere dos identificadores reconhecidos pelo parâmetro select).

selectstringObrigatório

Uma lista de colunas separadas por vírgulas a serem retornadas. Consulte o Schema de resposta para ver identificadores de coluna válidos.

protocolstring

O protocolo do seu alvo.

Valores permitidos:bothhttphttps

Padrão:both

targetstring (url)Obrigatório

O alvo da busca: um domínio ou uma URL.

modestring

O escopo da pesquisa com base no alvo que você informou.

Valores permitidos:exactprefixdomainsubdomains

Padrão:subdomains

countrystring

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

Valores permitidos:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

date_comparedstring (date)

Uma data para comparar as métricas, no formato YYYY-MM-DD.

datestring (date)Obrigatório

A data de referência das métricas, no formato AAAA-MM-DD.

volume_modestring

O modo de cálculo do volume de pesquisa: mensal ou média. Ele afeta o volume, o tráfego e o valor do tráfego.

Valores permitidos:monthlyaverage

Padrão:monthly

outputstring

O formato de saída.

Valores permitidos:jsoncsvxmlphp

Respostas

pagesarray<object>

keywordsinteger or null

O número total de palavras-chave para as quais seu alvo ranqueia entre os 100 melhores resultados de busca orgânica.

keywords_diffinteger

A mudança nas palavras-chave entre as datas selecionadas.

keywords_diff_percentinteger

A mudança nas palavras-chave entre as datas selecionadas, em porcentagem.

keywords_mergedinteger

O número total de palavras-chave otimizado para ordenação.

keywords_previnteger or null

A palavra-chave para a qual seu alvo se classifica na data de comparação.

page_typestring or null

Lista separada por vírgulas de caminhos hierárquicos de tipo de página previstos por IA. Cada valor é um caminho com barra inicial (por exemplo, /Article/How_to).

raw_urlstring

A URL da página no ranking em formato codificado.

raw_url_prevstring or null

A URL da página no ranking na data de comparação, em formato codificado.

referring_domainsinteger or null

(5 unidades) O número de domínios exclusivos que apontam links para uma página.

statusstring

O status de uma página: a nova página que começou a ranquear recentemente ("left"), a página perdida que desapareceu dos resultados de pesquisa ("right") ou sem alterações ("both").

Allowed values:leftrightboth

sum_trafficinteger or null

(10 unidades) Uma estimativa do tráfego orgânico mensal de busca que uma página recebe de todas as palavras-chave para as quais ela está ranqueada.

sum_traffic_mergedinteger

(10 units) O campo de tráfego otimizado para ordenação.

sum_traffic_previnteger or null

(10 units) O tráfego na data de comparação.

top_keywordstring or null

A palavra-chave que gera mais tráfego orgânico a uma página.

top_keyword_best_positioninteger or null

A posição de ranqueamento que uma página detém para a sua palavra-chave principal.

top_keyword_best_position_diffinteger or null

A mudança na melhor posição entre as datas selecionadas.

top_keyword_best_position_kindstring or null

O tipo da melhor posição: orgânica, paga ou um dos Recursos da SERP.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping

top_keyword_best_position_kind_prevstring or null

O tipo da primeira posição na data de comparação.

top_keyword_best_position_previnteger or null

A primeira posição na data de comparação.

top_keyword_best_position_titlestring or null

O título exibido para a página na SERP da sua Principal palavra-chave.

top_keyword_best_position_title_prevstring or null

O título exibido para a página na SERP da sua Principal palavra-chave na data de comparação.

top_keyword_countrystring or null

O país em que uma página ranqueia para a sua Principal palavra-chave.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

top_keyword_country_prevstring or null

O país em que uma página ranqueia para a sua Principal palavra-chave na data de comparação.

top_keyword_prevstring or null

A palavra-chave que gera mais tráfego orgânico para uma página na data de comparação.

top_keyword_volumeinteger or null

(10 unidades) Uma estimativa do número médio mensal de buscas pela Principal palavra-chave no último mês ou nos últimos 12 meses conhecidos de dados, dependendo do parâmetro "volume_mode".

top_keyword_volume_previnteger or null

(10 unidades) O volume de pesquisa na data de comparação.

traffic_diffinteger

A alteração no tráfego entre as datas selecionadas.

traffic_diff_percentinteger

A alteração no tráfego entre as datas selecionadas, em porcentagem.

urnumber (float) or null

A Classificação de URLs (UR) mostra a força do perfil de links de entrada da página alvo em uma escala logarítmica de 100 pontos.

urlstring (url) or null

A URL da página ranqueada.

url_prevstring (url) or null

O URL da página no ranking na data de comparação.

valueinteger or null

(10 units) O valor estimado do tráfego orgânico de pesquisa mensal de uma página, em centavos de dólar (USD).

value_diffinteger

A alteração no valor do tráfego entre as datas selecionadas.

value_diff_percentinteger

A alteração no Valor do tráfego entre as datas selecionadas, em porcentagem.

value_mergedinteger or null

(10 unidades) O campo de Valor do tráfego otimizado para ordenação.

value_previnteger or null

(10 unidades) O Valor do tráfego na data de comparação.