Docs
Pesquisar na documentação...⌘K

Visão geral da SERP

API + MCP
GET/v3/serp-overview/serp-overview

Parâmetros de consulta

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.

typestring

Uma lista, separada por vírgulas, de tipos de recursos da SERP pelos quais filtrar. São retornadas apenas as posições cujo type inclui pelo menos um dos valores fornecidos. Se não for especificada, serão retornadas posições de todos os tipos.

Valores permitidos:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion
top_positionsinteger

O número de principais posições orgânicas na SERP a retornar. Se não for especificado, todas as posições disponíveis serão retornadas.

datestring (date-time)

Um carimbo de data/hora em que a última Visão geral da SERP disponível é retornada no formato YYYY-MM-DDThh:mm:ss. Se não for especificado, a Visão geral da SERP mais recente será retornada.

countrystringObrigatório

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

Valores permitidos:adaeafagaialamaoarasatauawazba
keywordstringObrigatório

A palavra-chave para a qual retornar a Visão geral da SERP.

outputstring

O formato de saída.

Valores permitidos:jsonphpxml

Respostas

positionsarray<object>
ahrefs_rankinteger or null

A força do perfil de backlinks de um domínio em comparação com os outros sites no nosso banco de dados, em que a classificação #1 é a mais forte.

backlinksinteger or null

O número total de links de outros sites que direcionam para um resultado de pesquisa.

domain_ratingnumber (float) or null

A força do perfil de backlinks de um domínio em comparação com os demais no nosso banco de dados, em uma escala de 100 pontos.

keywordsinteger or null

O número de palavras-chave que ranqueiam entre as 100 melhores posições orgânicas para um resultado de pesquisa.

page_typestring or null

Lista separada por vírgulas de caminhos hierárquicos de tipos de página previstos por IA para a página ranqueada. Cada valor é um caminho com barra inicial (ex.: /Article/How_to).

positioninteger

A posição do resultado de pesquisa na SERP.

refdomainsinteger or null

(5 unidades) O número total de domínios exclusivos vinculados a um resultado de pesquisa.

titlestring or null

O título de uma página classificada.

top_keywordstring or null

A palavra-chave que gera mais tráfego orgânico para um resultado de pesquisa.

top_keyword_volumeinteger or null

(10 unidades) Uma estimativa do número médio mensal de pesquisas pela Principal palavra-chave nos últimos 12 meses de dados conhecidos.

trafficinteger or null

(10 unidades) Uma estimativa do tráfego orgânico mensal de pesquisa que um resultado obtém de todas as palavras-chave para as quais ele se posiciona.

typearray<string>

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

Valores permitidos:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion
update_datestring (date-time)

A data em que verificamos os resultados do mecanismo de pesquisa para uma palavra-chave.

urlstring or null

A URL de uma página classificada.

url_ratingnumber (float) or null

A força do perfil de backlinks de uma página em uma escala logarítmica de 100 pontos.

valueinteger or null

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