← Nesim Apps

Verifique quais páginas o Google indexou com a API de inspeção de URL

Por Nesim Razon, desenvolvedor mobile independente · 2026-11-20

#Notas de desenvolvimento#Android

Os relatórios do Search Console só mostram páginas que já tiveram impressões, então não dizem quais páginas o Google não indexou de todo. A API de inspeção de URL diz. Usei-a para verificar com um script as 381 URLs do meu sitemap: 329 estavam indexadas e 52 não. Aqui conto como a verificação funciona, o que significam as respostas e o que fiz depois.

Por que os relatórios normais não bastam

O relatório de desempenho lista as consultas e páginas que apareceram na busca. Uma página com zero impressões simplesmente não aparece, e essa é a página sobre a qual você mais quer saber. Em um site de apenas algumas semanas, a maioria das páginas está nesse grupo.

Como funciona a chamada da API

A API recebe dois valores: a URL que você quer inspecionar e a propriedade a que ela pertence. Responde com o estado do índice, o estado de cobertura em palavras, o horário da última varredura, a URL canônica escolhida pelo Google e se a varredura foi permitida. Li o arquivo do sitemap, enviei cada URL e guardei o estado de cobertura.

Um detalhe me custou uma primeira tentativa falha: o valor da propriedade precisa coincidir com a forma como o site está registrado. Uma propriedade de domínio é escrita com um prefixo especial, e usar o endereço simples devolveu um erro de permissão dizendo que a URL não faz parte da propriedade. Uma conta de serviço adicionada como usuária restrita da propriedade consegue executar as inspeções.

Seja gentil com a cota

A API tem um limite diário por site e um por minuto. Meu script reaproveita um cache e só verifica de novo uma página depois de cerca de uma semana, então uma execução semanal fica muito abaixo dos limites, e uma primeira execução de algumas centenas de URLs termina em poucos minutos com algumas requisições em paralelo.

O que encontrei

De 381 URLs, 329 estavam “Submitted and indexed”. As outras 52 se dividiam em três grupos: 33 que o Google não conhecia, 13 “Discovered, currently not indexed” e 6 “Crawled, currently not indexed”. Por idioma, as páginas em inglês eram as mais bem cobertas e as turcas tinham mais lacunas. As páginas que o Google não conhecia eram sobretudo os posts e guias mais novos.

Os três grupos pedem ações diferentes. “Desconhecida” significa que o Google ainda não achou a página, então ajude-o a achar. “Descoberta” significa que ele conhece o endereço mas não o varreu. “Varrida, não indexada” significa que ele olhou e decidiu não indexar, o que é um sinal de qualidade do conteúdo, e aí eu preciso melhorar a página.

O que fiz a respeito

Faça disso parte de um painel

Como a verificação é um script simples com cache, é fácil colocá-lo em um painel: indexadas sobre verificadas, uma divisão por idioma e uma lista curta de páginas não indexadas. Um número semanal diz se o que você publica está chegando ao índice.

Perguntas frequentes

Posso verificar a indexação de muitas páginas de uma vez?

Sim. A API de inspeção de URL verifica uma URL por requisição, então um script pode percorrer um sitemap, desde que respeite os limites diário e por minuto documentados.

Qual a diferença entre “descoberta” e “varrida” mas não indexada?

Descoberta significa que o Google conhece o endereço mas ainda não o varreu. Varrida significa que o Google obteve a página e decidiu não indexá-la, normalmente um sinal de qualidade.

Por que recebi um erro de permissão?

Provavelmente o valor da propriedade não coincidia com a forma como o site está registrado, por exemplo uma URL simples em vez da forma de propriedade de domínio.

Reenviar um sitemap garante a indexação?

Não. Ajuda o Google a descobrir URLs. A indexação continua dependendo da decisão do Google sobre cada página.

Mais do blog