Páginas pagas

API + MCP

GET/v3/site-explorer/paid-pages

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.

wherestring

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

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

limitinteger

O número de resultados a retornar.

Padrão:1000

timeoutinteger

Um tempo limite manual em segundos.

volume_modestring

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

Valores permitidos:monthlyaverage

Padrão:monthly

datestring (date)Obrigatório

Uma data para a qual as métricas serão relatadas, no formato AAAA-MM-DD.

date_comparedstring (date)

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

countrystring

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

Valores permitidos:adaeafagaialamaoarasatauawazba…

modestring

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

Valores permitidos:exactprefixdomainsubdomains

Padrão:subdomains

targetstring (url)Obrigatório

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

protocolstring

O protocolo do seu alvo.

Valores permitidos:bothhttphttps

Padrão:both

outputstring

O formato de saída.

Valores permitidos:jsoncsvxmlphp

Respostas

pagesarray<object>

ads_countinteger or null

O número de anúncios únicos com uma página.

ads_count_diffinteger

A alteração nos anúncios entre as datas selecionadas.

ads_count_previnteger or null

O número de anúncios na data de comparação.

keywordsinteger or null

O número total de palavras-chave para as quais seu alvo ranqueia nos resultados de pesquisa pagos.

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.

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 acabou de começar a ranquear nos resultados pagos ("left"), a página perdida que desapareceu dos resultados pagos ("right") ou sem alteração ("both").

Valores permitidos:leftrightboth

sum_trafficinteger or null

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

sum_traffic_mergedinteger

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

sum_traffic_previnteger or null

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

top_keywordstring or null

A palavra-chave que gera mais tráfego pago para 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.

Valores permitidos:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…

top_keyword_best_position_kind_prevstring or null

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

Valores permitidos:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…

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.

Valores permitidos:ADAEAFAGAIALAMAOAQARASATAUAWAX…

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.

Valores permitidos:ADAEAFAGAIALAMAOAQARASATAUAWAX…

top_keyword_prevstring or null

A palavra-chave que gera mais tráfego pago 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 unidades) O custo estimado do tráfego mensal de busca paga de uma página, em centavos de dólar americano (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.