Visão geral

API + MCP

GET/v3/rank-tracker/overview

As solicitações para este endpoint são gratuitas e não consomem unidades da API.

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 do filtro. Os seguintes identificadores de coluna são reconhecidos (isso difere dos identificadores reconhecidos pelo parâmetro select).

best_position_has_thumbnail: A posição mais alta (ou a URL de destino, se definida) tem uma miniatura.
type: boolean nullable

best_position_has_thumbnail_previous: A posição mais alta (ou a URL de destino, se definida) tinha uma miniatura na data de comparação.
type: boolean nullable

best_position_has_video_preview: A posição mais alta (ou a URL de destino, se definida) tem uma prévia de vídeo.
type: boolean nullable

best_position_has_video_preview_previous: A posição mais alta (ou a URL de destino, se definida) tinha uma prévia de vídeo na data de comparação.
type: boolean nullable

best_position_kind: O tipo da posição mais alta (ou da URL de destino, se definida): orgânica, paga ou um dos Recursos 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"

best_position_kind_previous: O tipo da posição mais alta (ou da URL de destino, se definida) 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"

clicks: A métrica de Cliques se refere ao número médio mensal de cliques nos resultados de pesquisa que as pessoas fazem ao buscar a palavra-chave alvo. Algumas buscas geram cliques em vários resultados, enquanto outras podem não gerar clique nenhum.
type: integer nullable

clicks_per_search: Cliques por pesquisa é a proporção de Cliques em relação ao Volume de pesquisa da palavra-chave. Ela mostra quantos resultados de pesquisa diferentes recebem cliques, em média, quando as pessoas procuram a palavra-chave alvo em um determinado país.
type: float nullable

cost_per_click: Custo por clique mostra o preço médio que os anunciantes pagam por cada clique em anúncio nos resultados de pesquisa pagos de uma palavra-chave.
type: integer nullable

country: O país em que uma determinada palavra-chave está sendo monitorada. Um código de país de duas letras (ISO 3166-1 alpha-2).
type: string
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"

country_prev: O país em que uma determinada palavra-chave estava sendo monitorada na data de comparação. Um código de país de duas letras (ISO 3166-1 alpha-2).
type: string
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"

created_at: A data em que uma palavra-chave foi adicionada ao Projeto.
type: datetime

is_branded: Intenção do usuário: marca. O usuário está procurando uma marca específica ou o nome de uma empresa.
type: boolean

is_commercial: Intenção do usuário: comercial. O usuário está comparando produtos ou serviços antes de tomar uma decisão de compra.
type: boolean

is_informational: Intenção do usuário: informacional. O usuário está buscando informações ou uma resposta para uma pergunta específica.
type: boolean

is_local: Intenção do usuário: local. O usuário está buscando informações relevantes para um local específico ou serviços próximos.
type: boolean

is_main_position: Exclui posições no AI Overview, sitelinks, principais notícias, pacotes de imagens, vídeos, discussões e fóruns, e posts no X (Twitter).
type: boolean

is_main_position_prev: Exclui posições no AI Overview, sitelinks, principais notícias, pacotes de imagens, vídeos, discussões e fóruns, e posts no X (Twitter) na data de comparação.
type: boolean

is_navigational: Intenção do usuário: navegacional. O usuário está procurando um site ou uma página específica.
type: boolean

is_transactional: Intenção do usuário: transacional. O usuário está pronto para concluir uma ação, geralmente uma compra.
type: boolean

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

keyword_difficulty: Uma estimativa de quão difícil é ranquear entre os 10 primeiros resultados orgânicos de uma palavra-chave, em uma escala de 100 pontos.
type: integer nullable

keyword_has_data: Retornará false se a palavra-chave ainda estiver em processamento e nenhuma SERP tiver sido buscada ainda.
type: boolean

keyword_is_frozen: Indica se uma palavra-chave excedeu o limite de palavras-chave monitoradas no seu plano. Essas palavras-chave ficam "congeladas", ou seja, seus rankings não são atualizados.
type: boolean

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

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

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

language: O idioma da SERP para o qual uma determinada palavra-chave está sendo monitorada.
type: string

language_prev: O idioma da SERP na data de comparação.
type: string

location: A localização (país, estado/província ou cidade) em que uma determinada palavra-chave está sendo monitorada.
type: string

location_prev: A localização (país, estado/província ou cidade) em que uma determinada palavra-chave estava sendo monitorada na data de comparação.
type: string

parent_topic: Tópico principal determina se você pode ranquear para a palavra-chave alvo enquanto foca em um tópico mais geral na página. Para identificar o Tópico principal, pegamos a página com #1 para sua palavra-chave e encontramos a palavra-chave responsável por trazer mais tráfego para essa página.
type: string nullable

position: A posição mais alta (ou a URL de destino, se definida) na pesquisa orgânica.
type: integer nullable

position_diff: A mudança na posição mais alta (ou na URL de destino, se definida) entre as datas selecionadas.
type: integer nullable

position_prev: A posição mais alta (ou a URL de destino, se definida) na data de comparação.
type: integer nullable

search_type_image: O tipo de pesquisa Imagem mostra a porcentagem de buscas por uma palavra-chave feitas para imagens, destacando o interesse em conteúdo visual.
type: float nullable

search_type_news: O tipo de pesquisa Notícias mostra a porcentagem de buscas por uma palavra-chave feitas para artigos de notícias.
type: float nullable

search_type_video: O tipo de pesquisa Vídeo mostra a porcentagem de buscas por uma palavra-chave feitas para vídeo, refletindo o interesse em conteúdo em vídeo.
type: float nullable

search_type_web: O tipo de pesquisa Web mostra a porcentagem de buscas por uma palavra-chave feitas para conteúdo geral da web, indicando interesse em uma ampla variedade de informações.
type: float nullable

serp_features: Os Recursos da SERP que aparecem nos resultados de pesquisa de uma palavra-chave.
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 que aparecem nos resultados de pesquisa de uma palavra-chave 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"

serp_updated: A data em que verificamos pela última vez os resultados do mecanismo de busca para uma palavra-chave.
type: datetime nullable

serp_updated_prev: A data em que verificamos os resultados do mecanismo de busca até a data de comparação.
type: datetime nullable

tags: Uma lista de tags atribuídas a uma determinada palavra-chave.
type: array(string)

tags_prev: Uma lista de tags atribuídas a uma determinada palavra-chave na data de comparação.
type: array(string)

target_positions_count: O número de URLs de destino ranqueando para uma palavra-chave.
type: integer

traffic: Uma estimativa do número de visitas mensais que uma página recebe a partir da pesquisa orgânica no último mês ou nos últimos 12 meses de dados conhecidos, dependendo do parâmetro "volume_mode".
type: integer nullable

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

traffic_prev: Uma estimativa do número de visitas mensais que uma página recebe a partir da pesquisa orgânica no último mês ou nos últimos 12 meses de dados conhecidos, dependendo do parâmetro "volume_mode".
type: integer nullable

url: A URL com melhor ranking (ou a URL de destino, se definida) na pesquisa orgânica.
type: string nullable

url_prev: A URL com melhor ranking (ou a URL de destino, se definida) na data de comparação.
type: string nullable

volume: Uma estimativa do número médio mensal de buscas por uma palavra-chave no último mês ou nos últimos 12 meses de dados conhecidos, dependendo do parâmetro "volume_mode".
type: integer nullable

volume_desktop_pct: A porcentagem do Volume de pesquisa total que vem de dispositivos desktop.
type: float nullable

volume_mobile_pct: A porcentagem do Volume de pesquisa total que vem de dispositivos móveis.
type: float nullable

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.

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.

devicestringObrigatório

Escolha entre rankings para dispositivos móveis e desktop.

Valores permitidos:desktopmobile

project_idintegerObrigatório

O identificador exclusivo do projeto. Você pode encontrá-lo na URL do seu projeto do Rank Tracker no Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#

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

overviewsarray<object>

best_position_has_thumbnailboolean or null

A posição mais alta (ou a URL de destino, se definida) tem uma miniatura.

best_position_has_thumbnail_previousboolean or null

A posição mais alta (ou a URL de destino, se definida) tinha uma miniatura na data de comparação.

best_position_has_video_previewboolean or null

A posição mais alta (ou a URL de destino, se definida) tem uma prévia de vídeo.

best_position_has_video_preview_previousboolean or null

A posição mais alta (ou a URL de destino, se definida) tinha uma prévia de vídeo na data de comparação.

best_position_kindstring or null

O tipo da posição mais alta (ou da URL de destino, se definida): orgânica, paga ou um dos Recursos da SERP.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping

best_position_kind_previousstring or null

O tipo de melhor posição (ou das URLs de destino, se definidas) na data de comparação.

clicksinteger or null

A métrica de cliques se refere à média mensal do número de cliques nos resultados de pesquisa que as pessoas fazem enquanto pesquisam pela sua palavra-chave alvo. Algumas pesquisas geram cliques em múltiplos resultados enquanto outras podem não gerar nenhum clique.

clicks_per_searchnumber or null

Cliques por Pesquisa são a Proporção de Cliques para o Volume de Pesquisa de Palavras-Chave. Exibem quantos resultados de pesquisa diferentes são clicados, em média, quando as pessoas procuram pela palavra-chave alvo em um determinado país.

cost_per_clickinteger or null

O Custo por Clique mostra o preço médio que os anunciantes pagam por cada clique em um anúncio para uma palavra-chave nos resultados de pesquisa paga.

countrystring

O país em que uma determinada palavra-chave está sendo rastreada. Um código de país de duas letras (ISO 3166-1 alpha-2).

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

country_prevstring

O país em que uma determinada palavra-chave está sendo rastreada na data de comparação. Um código de país de duas letras (ISO 3166-1 alpha-2).

created_atstring

A data em que uma palavra-chave foi adicionada ao projeto.

is_brandedboolean

Intenção do usuário: marca. O usuário está buscando um nome de marca ou empresa específica.

is_commercialboolean

Intenção do usuário: comercial. O usuário está comparando produtos ou serviços antes de tomar uma decisão de compra.

is_informationalboolean

Intenção do usuário: informacional. O usuário está buscando informações ou uma resposta para uma pergunta específica.

is_localboolean

Intenção do usuário: local. O usuário está buscando informações relevantes para um local específico ou serviços próximos.

is_navigationalboolean

Intenção do usuário: navegacional. O usuário está buscando um site ou página da web específica.

is_transactionalboolean

Intenção do usuário: transacional. O usuário está pronto para concluir uma ação, geralmente uma compra.

keywordstring

A palavra-chave para a qual seu alvo se classifica.

keyword_difficultyinteger or null

Uma estimativa de quão difícil é ranquear entre os 10 melhores resultados de busca orgânica para uma palavra-chave, em uma escala de 100 pontos.

keyword_has_databoolean

Retornará false se a palavra-chave ainda estiver sendo processada e nenhuma SERP tiver sido coletada ainda.

keyword_is_frozenboolean

Indica se uma palavra-chave excedeu o limite de palavras-chave rastreadas do seu plano. Essas palavras-chave ficam "congeladas", ou seja, não têm suas posições atualizadas.

keyword_prevstring

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

languagestring

O idioma da SERP para o qual uma determinada palavra-chave está sendo rastreada.

language_prevstring

O idioma da SERP na data de comparação.

locationstring

O local (país, estado/província ou cidade) em que uma determinada palavra-chave está sendo rastreada.

location_prevstring

O local (país, estado/província ou cidade) em que uma determinada palavra-chave está sendo rastreada na data de comparação.

parent_topicstring or null

O Tópico Principal determina se você consegue ranquear para sua palavra-chave alvo enquanto, visa um tópico mais geral. Para identificar o Tópico Principal, usamos a página ranqueada em primeiro lugar para sua palavra-chave e encontramos a palavra-chave responsável por enviar mais tráfego para essa página.

positioninteger or null

A melhor posição (ou das URLs de destino, se definidas) na busca orgânica.

position_diffinteger or null

A mudança na melhor posição (ou das URLs de destino, se definidas) entre as datas selecionadas.

position_previnteger or null

A melhor posição (ou das URLs de destino, se definidas) na data de comparação.

search_type_imagenumber or null

A pesquisa do tipo Imagem mostra a porcentagem de pesquisas por uma palavra-chave realizadas para imagens, destacando o interesse por conteúdo visual.

search_type_newsnumber or null

A pesquisa do tipo Notícias mostra a porcentagem de pesquisas para uma palavra-chave feitas para artigos de notícias.

search_type_videonumber or null

A pesquisa do tipo Vídeo mostra a porcentagem de buscas por uma palavra-chave realizadas para vídeos, refletindo o interesse em conteúdo em vídeo.

search_type_webnumber or null

A pesquisa do tipo Web mostra a porcentagem de buscas por uma palavra-chave feita para conteúdo geral da web, indicando interesse em uma ampla gama de informações.

serp_featuresarray<string>

Os recursos de SERP que aparecem nos resultados de pesquisa para uma palavra-chave.

serp_features_prevarray<string>

Os Recursos da SERP que aparecem nos resultados de pesquisa para uma palavra-chave na data de comparação.

serp_updatedstring or null

A data da última análise dos resultados de pesquisa para uma palavra-chave.

serp_updated_prevstring or null

A data em que verificamos os resultados do mecanismo de pesquisa até a data de comparação.

tagsarray<string>

Uma lista de tags atribuídas a uma determinada palavra-chave.

tags_prevarray<string>

Uma lista de tags atribuídas a uma determinada palavra-chave na data de comparação.

target_positions_countinteger

O número de URLs-alvo classificadas para uma palavra-chave.

trafficinteger or null

Uma estimativa do número de visitas mensais que uma página recebe da pesquisa orgânica no último mês ou ao longo dos últimos 12 meses de dados conhecidos, dependendo do parâmetro "volume_mode".

traffic_diffinteger or null

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

traffic_previnteger or null

urlstring or null

A URL mais bem classificada (ou URL-alvo, se definida) na pesquisa orgânica.

url_prevstring or null

A URL mais bem classificada (ou URL-alvo, se definida) na data de comparação.

volumeinteger or null

Uma estimativa do número médio de pesquisas mensais de uma palavra-chave no último mês ou ao longo dos últimos 12 meses de dados conhecidos, dependendo do parâmetro "volume_mode".

volume_desktop_pctnumber or null

A porcentagem do volume de pesquisa total que vem de dispositivos desktop.

volume_mobile_pctnumber or null

A porcentagem do volume de pesquisa total que vem de dispositivos móveis.