Equipes que procuram uma API de ranking do Google normalmente querem uma coisa específica: uma chamada que retorne em que posição uma página está para uma palavra-chave. O Google não publica isso.
O que o Google publica é um conjunto de APIs que descrevem o seu próprio desempenho, o estado do seu próprio índice e a sua própria situação de rastreamento. Elas são genuinamente úteis e todas são gratuitas. Também são estruturalmente incapazes de responder à pergunta que a maioria das pessoas traz a essa busca.
Passamos um dia medindo o que essas APIs realmente retornam em uma propriedade ao vivo, incluindo as partes fáceis de interpretar errado. Três descobertas se destacaram: os dados chegam com três dias de atraso, o número de posição é uma média que não se reproduz contra um resultado ao vivo, e a única API que soa mais como uma verificação de ranking retorna um veredito que não diz nada de útil sozinho.
O que o Google realmente publica
Quatro superfícies são confundidas com uma API de ranking. Veja para que serve cada uma, segundo a própria documentação do Google.
A Search Analytics API retorna cliques, impressões, CTR e posição média de uma propriedade verificada. É a coisa mais próxima de dados de ranking que o Google oferece, e é a origem de todo número de "posição média" no Search Console.
A URL Inspection API retorna o estado de indexação de uma única URL: se o Google a conhece, se está indexada e, se não estiver, por quê.
A Indexing API soa como se enviasse páginas para indexação. A documentação do Google restringe os tipos suportados a dados estruturados JobPosting e BroadcastEvent, o que é um caso de uso estreito, não um envio geral de índice.
A Custom Search JSON API retorna resultados web para uma consulta. Ela pesquisa um índice que você configura e não diz em que posição o seu site está nos resultados principais do Google.
Nenhuma delas retorna "a sua posição para esta palavra-chave". Esse trabalho não existe na linha de produtos do Google, e a ausência é deliberada, não um descuido. O Google não tem motivo comercial para distribuir dados de posição de concorrentes em escala.
O que medimos: os dados têm três dias
Puxamos o detalhamento diário da nossa própria propriedade em 12 de setembro de 2026. A data mais recente com qualquer dado era 9 de setembro.
Data disponível | Linhas retornadas |
|---|---|
2026-09-02 | sim |
2026-09-03 | sim |
2026-09-04 | sim |
2026-09-05 | sim |
2026-09-06 | sim |
2026-09-07 | sim |
2026-09-08 | sim |
2026-09-09 | sim, a mais recente |
Três dias de atraso, de forma consistente. O parâmetro window conta para trás a partir da data disponível mais recente, e não a partir de hoje, o que é uma pequena armadilha: um pedido de sete dias retorna oito datas terminando em 9 de setembro, não em 12 de setembro.
Para um relatório mensal isso é irrelevante. Para a pergunta "a mudança que fiz na página ontem quebrou alguma coisa", é desqualificador. Nenhuma configuração corrige isso. O atraso está do lado do Google na conexão.
O que medimos: posição média não é ranking
Esta é a descoberta mais importante, e é a que faz as pessoas acreditarem que uma API de ranking do Google existe e está sendo evasiva.
Posição média é a posição média da sua URL em todas as impressões do período, ponderada por países, dispositivos e variações de consulta. Uma verificação de ranking ao vivo retorna um número, de um local, em um dispositivo, em um instante. São medições diferentes que compartilham um nome.
Testamos a diferença em 25 consultas tiradas dos nossos próprios dados do Search Console e depois verificamos as mesmas 25 palavras-chave contra um SERP ao vivo dos Estados Unidos, em inglês, em desktop, com profundidade 100.
Resultado | Contagem |
|---|---|
Consultas utilizáveis nos dois conjuntos | 23 |
Apareceram no top 100 ao vivo | 14 (61%) |
Tinham impressões no Search Console mas nenhum resultado ao vivo reproduzível | 9 (39%) |
Mediana da diferença absoluta onde ambas existiam | 7,4 posições |
Média da diferença absoluta | 8,5 posições |
Maior diferença | 36,6 posições |
Dentro de 3 posições uma da outra | 4 de 14 |
Com diferença superior a 10 posições | 4 de 14 |
Onde as duas medições existem, elas divergem em uma mediana de 7,4 posições.
Dois detalhes importam mais que as médias.
Primeiro, nove das 23 consultas produziram uma posição no Search Console, mas nenhum resultado ao vivo na verificação de Estados Unidos, inglês, desktop. Isso não é um bug. As impressões se acumulam de outros países, outros idiomas, outros dispositivos e superfícies de imagem ou vídeo. Uma verificação única com foco geográfico não vai reproduzi-las, e uma equipe que trata os dois números como a mesma medição vai passar uma semana perseguindo uma discrepância que é um artefato do método.
Segundo, a direção não é consistente. A maioria das posições ao vivo ficou abaixo da média do Search Console, o que é esperado quando a média inclui superfícies com desempenho melhor. Mas uma consulta se moveu 36,6 posições no sentido oposto, de 73,6 para 37. Não há fator de correção a aplicar.
A diferença corre nos dois sentidos, então não há fator de correção a aplicar.
A consequência prática para quem está escolhendo uma API de ranking do Google: os dados gratuitos não vão dizer uma posição, e os dados pagos não vão concordar com eles. Ambos são medições corretas de coisas diferentes. Tratar um como substituto do outro é onde o relatório dá errado.
Onde o lado primário é genuinamente insubstituível é na cobertura, que medimos separadamente na comparação de alternativas à API de SERP.
O que a URL Inspection API retorna em vez disso
A URL Inspection API é a única superfície do Google que parece uma verificação de ranking, porque você entrega a ela uma URL sem palavra-chave e recebe um status de volta. Testamos duas URLs.
Estado da URL | Veredito | Estado de cobertura | Horário do último rastreamento |
|---|---|---|---|
Publicada cerca de uma hora antes | NEUTRAL | URL desconhecida para o Google | Desconhecido |
Publicada cerca de nove horas antes | NEUTRAL | Descoberta, atualmente não indexada | Desconhecido |
As duas retornaram o mesmo veredito. O campo que realmente diferencia os dois casos é a string de estado de cobertura, que é uma frase, não um enum. O campo de veredito diz NEUTRAL tanto para uma URL que o Google nunca viu quanto para uma URL que ele descobriu mas não indexou.
Essa é uma API utilizável e um sinal de monitoramento ruim por si só. Se você quer um alerta quando uma página não está indexada, analise o estado de cobertura em vez do veredito, e espere que o horário do último rastreamento esteja ausente justamente nas URLs que mais lhe importam.
As quatro superfícies e o trabalho que nenhuma delas faz
Pergunta | Superfície do Google | Resposta |
|---|---|---|
Como me saí nesta consulta na semana passada | Search Analytics API | Sim, com três dias de atraso, em média |
Esta URL está indexada | URL Inspection API | Sim, por URL, sob demanda |
Em que posição estou agora para qualquer palavra-chave | nenhuma | Não |
Em que posição estão meus concorrentes | nenhuma | Não |
Como é o SERP de uma palavra-chave para a qual eu não ranqueio | nenhuma | Não |
O padrão é consistente. As APIs do Google descrevem a sua propriedade por dentro. Uma pergunta de ranking é feita por fora, sobre uma página de resultados, e o Google não serve isso.
Como cobrir a lacuna sem pagar a mais
A configuração prática são duas fontes com trabalhos diferentes, não uma fonte à qual se pede as duas coisas.
Use as APIs do Google como verdade base sobre a sua própria propriedade. Cliques, impressões e estado de indexação são fatos primários que você não consegue em outro lugar, e são gratuitos. Puxe-os em uma agenda e trate o atraso de três dias como uma propriedade do instrumento.
Use uma fonte de SERP para a visão externa. Posições ao vivo, posições de concorrentes e palavras-chave para as quais você ainda não ranqueia. Esta é a parte paga, e é mais barata do que a maioria das equipes supõe: no nosso teste, verificar 23 palavras-chave com profundidade 100 custou $0,2975, o que dá $0,0129 por verificação.
Não tente reconciliar os dois números. Eles medem coisas diferentes. O movimento útil é lê-los juntos: o Search Console diz o que aconteceu, e uma verificação ao vivo diz o que está acontecendo. Quando eles discordam, olhe a composição de países e dispositivos da consulta antes de concluir qualquer coisa.
A mecânica de rodar os dois a partir de um script está no nosso rastreador de duas fontes, e o lado de custo da metade ao vivo está precificado no teste de verificação em massa.
Perguntas frequentes
O Google tem uma API de ranking oficial? Não. O Google publica APIs para o seu próprio desempenho de busca (Search Analytics), estado de indexação (URL Inspection) e dois tipos estreitos de envio (Indexing). Nenhuma retorna uma posição para uma palavra-chave.
Por que o Search Console mostra uma posição se não existe API de ranking? Porque posição média é uma métrica de desempenho calculada a partir das suas impressões, não uma consulta de posição. É a posição média em todas as impressões do período, calculada em média entre países, dispositivos e superfícies.
Quanto os dados do Search Console ficam atrasados? Três dias na nossa medição em 12 de setembro de 2026, com a data disponível mais recente sendo 9 de setembro. O parâmetro window conta para trás a partir dessa data, então um pedido de sete dias retorna oito datas terminando no dia disponível mais recente.
A URL Inspection API pode me dizer se uma página está indexada? Pode, e é a ferramenta certa para esse trabalho. Leia a string de estado de cobertura em vez do campo de veredito, porque o veredito retorna NEUTRAL tanto para uma URL desconhecida quanto para uma URL descoberta mas não indexada.
A Custom Search JSON API é uma API de ranking? Não. Ela retorna resultados de um mecanismo de busca que você configura, não a sua posição nos resultados principais do Google.
Qual é a forma mais barata de obter dados reais de posição? Verifique o menor conjunto de palavras-chave sobre o qual você realmente age, na profundidade que corresponde a onde você está. Verificações com profundidade 10 custaram $0,002 por palavra-chave no nosso teste e com profundidade 100 custaram $0,014, então a configuração de profundidade move a conta sete vezes mais do que a contagem de palavras-chave.
Visão da Auspia: a resposta honesta para "existe uma API de ranking do Google" é não, e o desdobramento útil é parar de procurar. As APIs do Google respondem bem a perguntas primárias e não conseguem responder a perguntas de posição de forma alguma. Reserve um valor pequeno para a visão externa e gaste o restante do esforço na parte que o Google não vai fazer por você, que é decidir o que mudar quando os dois números discordam.
Autor: Gabriel Finch, pesquisador de recuperação de busca, com revisão de mais de 1.200 respostas de IA na Auspia. Escreve sobre infraestrutura de busca, sistemas de recuperação e o que cada fonte de dados realmente consegue ver.
