GSC_KEYWORD_POSITION
Obtenha a posição média para uma palavra-chave específica do Google Search Console.
=GSC_KEYWORD_POSITION(query, startDate, endDate, [siteUrl])Retorna: 2D array with columns: Keyword, Position, Clicks, Impressions, CTR
Visão Geral
GSC_KEYWORD_POSITION permite verificar instantaneamente a posição média de pesquisa para qualquer palavra-chave específica que seu site ranqueia no Google. Simplesmente forneça a palavra-chave, um intervalo de datas e opcionalmente uma URL do site para obter de volta a posição média junto com cliques, impressões e CTR para aquela consulta exata. Esta é a maneira mais rápida de responder a pergunta "Onde meu site ranqueia para esta palavra-chave?" diretamente de sua planilha.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Sim | A consulta de pesquisa exata (palavra-chave) a consultar. |
startDate | string | Sim | Data inicial no formato "YYYY-MM-DD" ou formato relativo como "-30d" para 30 dias atrás. |
endDate | string | Sim | Data final no formato "YYYY-MM-DD" ou formato relativo como "-1d" para ontem. |
siteUrl | string | Não | A URL da propriedade do Search Console. Se omitida, usa a propriedade conectada padrão. |
Exemplos
Verificar posição para uma palavra-chave alvo
Verifique onde seu site ranqueia para "project management software" nos últimos 30 dias.
=GSC_KEYWORD_POSITION("project management software", "-30d", "-1d")Saída
| Keyword | Position | Clicks | Impressions | CTR |
| project management software | 4.2 | 980 | 22100 | 4.4% |
Acompanhar uma palavra-chave de marca
Verifique se seu site mantém a posição 1 para o nome da sua marca na última semana.
=GSC_KEYWORD_POSITION("mycompany", "-7d", "-1d")Saída
| Keyword | Position | Clicks | Impressions | CTR |
| mycompany | 1.0 | 2400 | 3100 | 77.4% |
Palavra-chave de referência de célula
Use uma referência de célula para a palavra-chave para que você possa construir um rastreador de ranking com uma lista de palavras-chave na coluna A.
=GSC_KEYWORD_POSITION(A2, "-30d", "-1d")Saída
| Keyword | Position | Clicks | Impressions | CTR |
| best crm software | 6.8 | 320 | 12500 | 2.6% |
Comparar posição de palavra-chave entre meses
Obtenha a posição média para janeiro de 2025 para comparar com outros meses para análise de tendências.
=GSC_KEYWORD_POSITION("email marketing tips", "2025-01-01", "2025-01-31")Saída
| Keyword | Position | Clicks | Impressions | CTR |
| email marketing tips | 5.3 | 410 | 9800 | 4.2% |
Verificar posição para uma propriedade específica
Consulte a posição de palavra-chave para uma propriedade de domínio específica do Search Console.
=GSC_KEYWORD_POSITION("healthy recipes", "-30d", "-1d", "sc-domain:healthblog.com")Saída
| Keyword | Position | Clicks | Impressions | CTR |
| healthy recipes | 3.5 | 1850 | 28000 | 6.6% |
Casos de Uso
Dashboard de Acompanhamento de Ranking de Palavras-chave
Profissionais de SEO constroem planilhas de acompanhamento de ranking com palavras-chave alvo listadas em uma coluna e GSC_KEYWORD_POSITION verificando cada uma, fornecendo uma alternativa gratuita a ferramentas caras de acompanhamento de ranking.
Medição de Impacto de Campanha SEO
Equipes de marketing medem o impacto de campanhas de SEO comparando posições de palavras-chave antes e depois de mudanças de conteúdo, esforços de link building ou otimizações técnicas.
Monitoramento de Marca
Gerentes de marca monitoram rankings de posição 1 para consultas de nome de marca e variações, identificando rapidamente quaisquer problemas onde concorrentes ou conteúdo negativo possam estar superando páginas oficiais da marca.
Acompanhamento de Lacuna de Palavras-chave de Concorrentes
Empresas SaaS acompanham suas posições para palavras-chave de comparação de concorrentes como "produto A vs produto B" para garantir que mantenham forte visibilidade quando clientes em potencial estão avaliando alternativas.
Monitoramento de Posição de SEO Local
Negócios locais monitoram posições para palavras-chave específicas de localização como "dentista em Chicago" ou "encanador perto do centro" para garantir que seus esforços de SEO local estão mantendo rankings fortes.
Verificação de Posição Pós-Migração
Após migrações de site ou redesigns, equipes de desenvolvimento verificam posições para palavras-chave críticas para verificar que a migração não causou quedas de ranking e detectar quaisquer problemas cedo.
Dicas Profissionais
Construa um rastreador de ranking listando palavras-chave alvo na coluna A, depois use =GSC_KEYWORD_POSITION(A2, "-30d", "-1d") nas linhas. Copie para baixo para todas as palavras-chave.
Crie acompanhamento mês a mês colocando os dados de cada mês em uma coluna separada e usando formatação condicional para destacar melhorias de posição (verde) e quedas (vermelho).
Para acompanhamento de palavras-chave em alto volume (50+ palavras-chave), use GSC_TOP_QUERIES com um limite alto e VLOOKUP para encontrar cada palavra-chave. Isso é mais eficiente em API do que chamadas individuais.
Configure alertas usando gatilhos do Apps Script: se a posição de uma palavra-chave crítica cair abaixo de um limite, envie automaticamente uma notificação por email para você.
Acompanhe tanto a palavra-chave principal quanto variações de cauda longa (por exemplo, "crm software" e "best crm software for small business") para obter uma visão abrangente de sua força de ranking para um tópico.
O acompanhamento de rankings é uma das atividades de SEO mais fundamentais, e GSC_KEYWORD_POSITION torna isso sem esforço puxando dados de posição da fonte mais autoritativa disponível: os próprios dados do Search Console do Google. Ao contrário de rastreadores de ranking de terceiros que estimam posições fazendo scraping de resultados de pesquisa, esta função retorna dados reais de posição média calculados a partir de impressões reais que seu site recebeu na pesquisa do Google. Isso significa que os dados são 100% precisos para seu site específico e refletem a verdadeira média em todas as variações da pesquisa (diferentes localizações, dispositivos e fatores de personalização).
A função é perfeita para construir planilhas de acompanhamento de ranking de palavras-chave. Liste suas palavras-chave alvo em uma coluna e use GSC_KEYWORD_POSITION com referências de células para verificar cada uma. Ao executar isso periodicamente ou para diferentes intervalos de datas, você pode acompanhar tendências de ranking ao longo do tempo, medir o impacto de mudanças de SEO e relatar sobre o desempenho de palavras-chave para stakeholders. O foco em palavra-chave única a torna ideal para monitorar suas palavras-chave mais críticas, enquanto GSC_TOP_QUERIES é mais adequado para descoberta ampla de palavras-chave. Para tendências detalhadas de posição por dia, combine isso com GSC_QUERY usando a dimensão "date".
Erros Comuns
NO_DATA: Nenhum dado de pesquisa encontrado para a consulta especificadaCausa: Seu site não ranqueia para a palavra-chave especificada, ou não teve impressões durante o intervalo de datas.
Correção: Verifique a ortografia exata da palavra-chave. O Search Console normaliza consultas para minúsculas, então a capitalização não importa. Tente um intervalo de datas mais amplo ou verifique GSC_TOP_QUERIES para confirmar que a palavra-chave aparece em seus dados de pesquisa. Lembre-se de que consultas muito novas ou muito raras podem não ter dados.
NOT_AUTHORIZED: Acesso à propriedade do Search Console negadoCausa: A conta Google conectada não tem permissão para a propriedade do Search Console.
Correção: Certifique-se de que sua conta tem pelo menos permissão "Completa" em Search Console > Configurações > Usuários e permissões. Se usar o parâmetro siteUrl, verifique se a string da propriedade corresponde exatamente como aparece no Search Console.
INVALID_DATE: Intervalo de datas excede o período máximo permitidoCausa: O intervalo de datas abrange mais de 16 meses, o que excede o período de retenção de dados do Search Console.
Correção: Limite seu intervalo de datas a dentro dos últimos 16 meses. O Search Console não retém dados com mais de 16 meses. Para acompanhamento histórico, exporte e armazene dados de posição regularmente em planilhas separadas.
Perguntas Frequentes
Posição média é a posição média do seu site nos resultados de pesquisa para aquela consulta, ponderada por impressões. Se seu site apareceu na posição 3 para 80% das impressões e posição 8 para 20%, a média seria aproximadamente 4.0. Reflete seu ranking típico em todas as pesquisas para aquela palavra-chave, incluindo variações por localização, dispositivo e personalização.
Sim, o parâmetro de consulta deve corresponder exatamente como reportado pelo Search Console. O Google normaliza consultas para minúsculas e remove espaços extras, mas a consulta principal deve ser exata. "project management" e "project management tools" são duas consultas diferentes. Use GSC_TOP_QUERIES para descobrir as strings de consulta exatas que o Google reporta.
Se seu site não teve impressões para a consulta especificada durante o intervalo de datas, a função retorna um resultado vazio com apenas a linha de cabeçalho. Isso significa que seu site ou não ranqueia para aquela palavra-chave ou ranqueia além das posições que geram impressões (tipicamente além da posição 100).
GSC_KEYWORD_POSITION usa dados oficiais do Google, tornando-o a fonte mais precisa para sua posição média real. Ferramentas de terceiros estimam posições fazendo scraping de resultados de pesquisa de localizações específicas, o que pode não representar a imagem completa. No entanto, dados do GSC são uma média em todas as pesquisas, enquanto ferramentas de terceiros mostram uma posição específica de ponto no tempo de uma localização específica.
GSC_KEYWORD_POSITION fornece a posição média para o intervalo de datas inteiro. Para dados de posição diários, use GSC_QUERY com a dimensão "date" e um filtro de consulta para obter um detalhamento dia a dia de mudanças de posição para uma palavra-chave específica.
Sim, dados de posição do Search Console incluem todos os tipos de resultados de pesquisa. Se seu site aparece em um featured snippet, é tipicamente contado como posição 1. Outras features SERP como People Also Ask, image packs ou painéis de conhecimento também podem afetar a numeração de posição.
Embora você possa usar GSC_KEYWORD_POSITION com referências de células para verificar muitas palavras-chave, cada fórmula faz uma chamada API separada. Para verificar centenas de palavras-chave, considere usar GSC_TOP_QUERIES com um limite alto, que retorna todas as suas palavras-chave ranqueadas em uma única requisição. Você pode então usar VLOOKUP ou INDEX/MATCH para encontrar palavras-chave específicas.
Funções Relacionadas
GSC_TOP_QUERIES
Obtenha as principais consultas de pesquisa do Google Search Console ordenadas por cliques.
GSC_PAGE_QUERIES
Obtenha consultas de pesquisa gerando tráfego para uma página específica.
GSC_QUERY
Consulta personalizada do Google Search Console com controle total sobre dimensões e filtros.
Comece a usar GSC_KEYWORD_POSITION hoje
Instale o Unlimited Sheets para obter GSC_KEYWORD_POSITION e outras 41 funções poderosas no Google Sheets.
