Para usar os novos filtros da Search Analytics API, consulte brandedClassification para separar buscas de marca e sem marca, use o tipo webMultimodal para medir Google Lens, Circle to Search e imagens enviadas à Busca, e aplique filterLists quando precisar agrupar vários países ou dispositivos. O Google lançou essas opções em 16 de novembro de 2026 para automatizar análises que já existiam parcialmente no relatório de desempenho. Elas ajudam a comparar descoberta, reconhecimento e presença visual, mas não transformam o Search Console em CRM nem garantem todas as linhas de consulta.
Comece pela pergunta que o relatório precisa responder
Não crie um painel apenas porque a API ganhou campos novos. Defina uma decisão concreta: saber se a marca está crescendo, descobrir páginas que atraem demanda sem marca, comparar mercados ou medir a participação da busca visual. Escreva a pergunta, o período, a propriedade e a ação esperada antes da primeira requisição.
Uma empresa que atende Curitiba e outras capitais pode, por exemplo, comparar consultas sem marca em um conjunto de estados e separar celular de computador. Uma operação internacional pode agrupar países da América Latina sem manter várias chamadas independentes. O relatório precisa preservar a granularidade necessária para agir, sem criar dezenas de cortes que ninguém revisa.
Separe marca e descoberta sem regex manual
A dimensão e o filtro brandedClassification permitem trabalhar com BRANDED e NON_BRANDED. Isso substitui parte das listas manuais de nome, domínio, produtos e erros de grafia, mas só aparece em propriedades de nível superior elegíveis e com volume suficiente. Se a resposta não trouxer linhas, não trate automaticamente como ausência de busca de marca.
A classificação do Google é contextual e pode errar. Compare amostras com as consultas visíveis no Search Console, registre mudanças de nome e acompanhe campanhas offline ou de mídia que possam elevar a procura pela marca. Use o dado para observar tendência e composição, não para atribuir cada conversão a um único canal.
- Propriedade de domínio verificada e elegível
- Período comparável e sem evento excepcional ignorado
- Marca e descoberta analisadas com páginas de destino
- Leads e vendas conciliados fora do Search Console
Meça Google Lens e outras buscas multimodais
Ao definir type como webMultimodal, a API retorna desempenho ligado ao Google Lens, Circle to Search no Android e imagens enviadas ao Google Search. Para propriedades com exportação em massa ativa, esse tipo também pode chegar ao BigQuery. O recorte ajuda lojas, turismo, alimentação, decoração e outros negócios em que a imagem participa da descoberta.
Não use o total para concluir que uma fotografia específica gerou o clique. Relacione página, país, dispositivo e período, depois confira qualidade das imagens, alt text, contexto visível, dados do produto e experiência da página. Uma alta de impressão visual pode sinalizar demanda, mas ainda precisa ser conectada a navegação, contato e venda.
Agrupe países e dispositivos com filterLists
O novo campo filterLists permite enviar vários países ou dispositivos na mesma consulta. Isso reduz a necessidade de repetir chamadas para cada mercado ou combinação e facilita cortes como Brasil e Portugal, América Latina ou celular e tablet. Mantenha a lista versionada para o resultado continuar comparável quando a empresa entrar em um novo mercado.
Evite somar regiões com comportamentos incompatíveis apenas para simplificar o painel. Preço, idioma, sazonalidade, disponibilidade e participação da marca podem variar. Use um grupo operacional para monitoramento e mantenha a possibilidade de abrir cada país quando surgir uma anomalia.
Respeite limites e combinações da API
A documentação informa que brandedClassification não pode ser combinado com um filtro de query na mesma requisição e aceita apenas o operador equals. A classificação está disponível a partir de 21 de fevereiro de 2026. A Search Analytics API também retorna as principais linhas, não uma reprodução garantida de todas as consultas existentes.
Implemente paginação, tratamento de resposta vazia, registro do corpo enviado e alerta para falhas. Separe erro de autenticação, limite, campo incompatível e ausência real de dado. Antes de publicar um indicador para a diretoria, compare o total agregado com a interface do Search Console no mesmo período e confirme fuso e data final.
Monte um painel que termina em ação
Uma visão semanal pode mostrar cliques, impressões, CTR e posição para marca e descoberta, com cortes de mercado, dispositivo e multimodal. Acrescente páginas que mais cresceram, páginas que perderam descoberta e consultas com impressão alta e CTR baixo. Defina responsável e prazo para cada investigação relevante.
Conecte o painel ao Analytics, CRM e atendimento quando a decisão envolve receita. O Search Console mede interação na Busca, não a venda concluída. Preserve UTMs já existentes, nomes de campanha e a origem registrada pelo comercial para evitar que um aumento de marca seja atribuído sem evidência ao último conteúdo ou anúncio.
Automatize sem eliminar a revisão humana
Agende a coleta depois que o período estiver estável, armazene a resposta bruta e a versão da transformação e gere alertas apenas para mudanças relevantes. Uma regra simples pode avisar quando cliques sem marca caem acima de um limite por duas semanas ou quando uma página perde presença multimodal em um mercado prioritário.
Revise falsos positivos causados por sazonalidade, alteração de consentimento, migração, canonical, mudança de propriedade ou atraso de dados. A automação serve para reduzir o tempo até a pergunta certa. A decisão de editar conteúdo, corrigir técnica ou investir em distribuição continua exigindo contexto do negócio.
Para levar daqui
Os novos filtros tornam a Search Analytics API mais útil para separar reconhecimento, descoberta e busca visual em vários mercados. O ganho vem de perguntas claras, limites documentados e conciliação com CRM e vendas.





