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).

cpc
type: integer nullable

cpc_prev: A métrica de CPC na data de comparação.
type: integer nullable

has_thumbnail: A posição tem uma miniatura.
type: boolean

has_thumbnail_prev: A posição tem uma miniatura na data de comparação.
type: boolean

has_video: A posição tem um vídeo.
type: boolean

has_video_prev: A posição tem um vídeo na data de comparação.
type: boolean

keyword: A palavra-chave para a qual seu destino ranqueia.
type: string

keyword_difficulty (10 units): Uma estimativa do quão difícil é ranquear no top 10 dos resultados de pesquisa orgânica para uma palavra-chave, em uma escala de 100 pontos.
type: integer nullable

keyword_difficulty_prev (10 units): A dificuldade da palavra-chave na data de comparação.
type: integer nullable

keyword_prev: A palavra-chave para a qual seu destino ranqueava na data de comparação.
type: string

keywords: O número total de palavras-chave para as quais seu destino ranqueia entre os 100 primeiros resultados de pesquisa orgânica.
type: integer

keywords_diff: A variação no número de palavras-chave entre as datas selecionadas.
type: integer

keywords_diff_percent: A variação no número de palavras-chave entre as datas selecionadas, em porcentagem.
type: integer

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

keywords_prev: A palavra-chave para a qual seu destino ranqueava na data de comparação.
type: integer

page_type: Lista separada por vírgulas de caminhos hierárquicos de tipo de página previstos por IA. Cada valor é um caminho com prefixo de barra (ex.: /Article/How_to).
type: string nullable

position: A posição em que seu destino ranqueia nos resultados de pesquisa orgânica para uma palavra-chave.
type: integer

position_kind: O tipo de uma posição: orgânica, paga ou um recurso da SERP. Isso se aplica a todas as posições para uma determinada palavra-chave e URL antes de selecionar a melhor posição.
type: string
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

position_kind_prev: O tipo de uma posição na data de comparação.
type: string
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

position_prev: A posição do seu destino para uma determinada palavra-chave na data de comparação.
type: integer

raw_url: A URL da página ranqueada em formato codificado.
type: string

raw_url_prev: A URL da página ranqueada na data de comparação, em formato codificado.
type: string

referring_domains (5 units): O número de domínios exclusivos apontando para uma página.
type: integer nullable

serp_features
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

serp_features_prev: Os recursos da SERP na data de comparação.
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

status: O status de uma página: a nova página que acabou de começar a ranquear ("left"), a página perdida que desapareceu dos resultados de pesquisa ("right") ou sem mudanças ("both").
type: string
enum: "left" "right" "both"

sum_traffic (10 units): Uma estimativa do tráfego mensal de pesquisa orgânica que uma página recebe de todas as palavras-chave para as quais ranqueia.
type: integer nullable

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

sum_traffic_prev (10 units): O tráfego na data de comparação.
type: integer nullable

top_keyword: A palavra-chave que traz mais tráfego orgânico para uma página.
type: string nullable

top_keyword_best_position: A posição de ranqueamento que uma página ocupa para sua principal palavra-chave.
type: integer nullable

top_keyword_best_position_diff: A variação da melhor posição entre as datas selecionadas.
type: integer nullable

top_keyword_best_position_kind: O tipo da melhor posição: orgânica, paga ou um recurso da SERP.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

top_keyword_best_position_kind_prev: O tipo da melhor posição na data de comparação.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"

top_keyword_best_position_prev: A melhor posição na data de comparação.
type: integer nullable

top_keyword_best_position_title: O título exibido para a página na SERP da sua principal palavra-chave.
type: string nullable

top_keyword_best_position_title_prev: O título exibido para a página na SERP da sua principal palavra-chave na data de comparação.
type: string nullable

top_keyword_country: O país em que uma página ranqueia para sua principal palavra-chave.
type: string nullable
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"

top_keyword_country_prev: O país em que uma página ranqueava para sua principal palavra-chave na data de comparação.
type: string nullable
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"

top_keyword_prev: A palavra-chave que trazia mais tráfego orgânico para uma página na data de comparação.
type: string nullable

top_keyword_volume (10 units): Uma estimativa do número médio de pesquisas mensais pela principal palavra-chave no último mês ou nos últimos 12 meses conhecidos, dependendo do parâmetro "volume_mode".
type: integer nullable

top_keyword_volume_prev (10 units): O volume de pesquisa na data de comparação.
type: integer nullable

traffic (10 units): Uma estimativa do número de visitantes mensais que seu destino recebe de pesquisa orgânica para uma palavra-chave.
type: integer

traffic_diff: A variação de tráfego entre as datas selecionadas.
type: integer

traffic_diff_percent: A variação de tráfego entre as datas selecionadas, em porcentagem.
type: integer

traffic_prev (10 units): O tráfego de uma palavra-chave na data de comparação.
type: integer

ur: URL Rating (UR) mostra a força do perfil de Backlinks da página do seu destino em uma escala logarítmica de 100 pontos.
type: float nullable

url: A URL da página ranqueada.
type: url nullable

url_prev: A URL da página ranqueada na data de comparação.
type: url nullable

value (10 units): O valor estimado do tráfego mensal de pesquisa orgânica de uma página, em centavos de USD.
type: integer nullable

value_diff: A variação no valor do tráfego entre as datas selecionadas.
type: integer

value_diff_percent: A variação no valor do tráfego entre as datas selecionadas, em porcentagem.
type: integer

value_merged (10 units): O campo de valor de tráfego otimizado para ordenação.
type: integer nullable

value_prev (10 units): O valor do tráfego na data de comparação.
type: integer nullable

volume (10 units): Uma estimativa do número de pesquisas por uma palavra-chave no último mês.
type: integer nullable

volume_prev (10 units): O volume de pesquisa na data de comparação.
type: integer nullable

words: O número de palavras em uma palavra-chave.
type: integer

words_prev: O número de palavras em uma palavra-chave na data de comparação.
type: integer

selectstringObrigatório

Uma lista de colunas separadas por vírgula para retornar. Consulte o Schema de resposta para ver os identificadores de coluna válidos.

protocolstring

O protocolo do seu alvo.

Valores permitidos:bothhttphttps

Padrão:both

targetstringObrigatório

O alvo da pesquisa: 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

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

datestringObrigatório

Uma data para gerar relatório das métricas, no formato YYYY-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 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 or null

A URL da página ranqueada.

url_prevstring 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.