GSC_TOP_QUERIES
Obtenha as principais consultas de pesquisa do Google Search Console ordenadas por cliques.
=GSC_TOP_QUERIES(startDate, endDate, [limit], [siteUrl])Retorna: 2D array with columns: Query, Clicks, Impressions, CTR, Position
Visão Geral
GSC_TOP_QUERIES puxa suas principais consultas de pesquisa diretamente da API do Google Search Console para o Google Sheets. A função retorna uma tabela abrangente de métricas incluindo o texto da consulta, cliques, impressões, taxa de cliques (CTR) e posição média para cada palavra-chave que seu site ranqueia. Os resultados são ordenados por cliques em ordem decrescente, facilitando a identificação de quais termos de pesquisa geram mais tráfego para seu site.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
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. |
limit | number | Não (100) | Número máximo de linhas a retornar. Padrão 100, máximo 25000. |
siteUrl | string | Não | A URL da propriedade do Search Console. Se omitida, usa a propriedade conectada padrão. |
Exemplos
Principais consultas dos últimos 30 dias
Recupere as 100 principais consultas de pesquisa dos últimos 30 dias usando formato de data relativa.
=GSC_TOP_QUERIES("-30d", "-1d")Saída
| Query | Clicks | Impressions | CTR | Position |
| best project management tools | 1240 | 18500 | 6.7% | 3.2 |
| project management software | 980 | 22100 | 4.4% | 5.1 |
| free task manager | 870 | 15300 | 5.7% | 4.8 |
Top 10 consultas para um mês específico
Obtenha apenas as 10 principais consultas para janeiro de 2025.
=GSC_TOP_QUERIES("2025-01-01", "2025-01-31", 10)Saída
| Query | Clicks | Impressions | CTR | Position |
| online invoice generator | 2100 | 31000 | 6.8% | 2.9 |
| free invoice template | 1850 | 28400 | 6.5% | 3.4 |
| invoice maker | 1620 | 25800 | 6.3% | 4.1 |
Exportação completa para uma propriedade específica
Exporte até 25.000 consultas dos últimos 90 dias para uma propriedade de domínio específica do Search Console.
=GSC_TOP_QUERIES("-90d", "-1d", 25000, "sc-domain:example.com")Saída
| Query | Clicks | Impressions | CTR | Position |
| example product review | 5400 | 82000 | 6.6% | 2.1 |
| example vs competitor | 3200 | 45000 | 7.1% | 3.5 |
| buy example online | 2800 | 38000 | 7.4% | 2.8 |
Visão rápida dos últimos 7 dias
Obtenha um snapshot rápido das 20 principais consultas da última semana para uma revisão semanal.
=GSC_TOP_QUERIES("-7d", "-1d", 20)Saída
| Query | Clicks | Impressions | CTR | Position |
| meal prep ideas | 340 | 5200 | 6.5% | 4.2 |
| healthy lunch recipes | 290 | 4800 | 6.0% | 5.1 |
| quick dinner recipes | 265 | 4100 | 6.5% | 3.8 |
Casos de Uso
Relatório Semanal de Performance SEO
Agências de marketing puxam as principais consultas semanalmente para acompanhar o desempenho de palavras-chave de clientes, identificar melhorias de ranking e relatar sobre o ROI de pesquisa orgânica em dashboards automatizados.
Análise de Lacunas de Conteúdo
Equipes editoriais analisam as principais consultas para descobrir quais tópicos geram mais tráfego de pesquisa e identificar palavras-chave de alta impressão e baixo CTR que precisam de melhor conteúdo ou meta descrições.
Descoberta de Produtos E-commerce
Varejistas online monitoram as principais consultas de pesquisa para entender como os clientes encontram seus produtos, identificar pesquisas de produtos em tendência e otimizar títulos e descrições de páginas de produtos.
Benchmarking de Palavras-chave de Concorrentes
Empresas SaaS exportam as principais consultas mensalmente para comparar com listas de palavras-chave de concorrentes, identificar oportunidades de posicionamento de mercado e informar estratégia de pesquisa paga.
Detecção de Tendências Sazonais
Empresas de viagem comparam as principais consultas em diferentes períodos de tempo para identificar tendências de pesquisa sazonais e planejar calendários de conteúdo em torno de períodos de pico de reserva.
Dicas Profissionais
Use datas relativas como "-30d" e "-1d" para criar dashboards que sempre mostram os dados mais recentes sem precisar atualizar células de data manualmente.
Combine com VLOOKUP ou INDEX/MATCH contra a exportação de um período anterior para calcular mudanças semana a semana ou mês a mês em cliques e posição.
Filtre os resultados para consultas onde as impressões são altas mas o CTR está abaixo de 3% para encontrar suas melhores oportunidades de melhorar title tags e meta descrições.
Exporte 25.000 linhas trimestralmente e use tabelas dinâmicas para acompanhar tendências de palavras-chave de cauda longa que podem não aparecer em uma visualização dos 100 principais.
Se você gerencia múltiplos sites, use o parâmetro siteUrl para puxar dados de cada propriedade em abas separadas da mesma planilha para comparação fácil.
Esta função é essencial para profissionais de SEO que precisam monitorar regularmente o desempenho de palavras-chave sem fazer login manual no Google Search Console. Você pode especificar intervalos de datas personalizados usando formatos de data padrão ou datas relativas convenientes como "-30d" para os últimos 30 dias ou "-7d" para a última semana. O parâmetro opcional de limite permite controlar quantas linhas são retornadas, desde uma lista focada dos 10 principais até uma exportação abrangente de até 25.000 consultas.
Ao combinar GSC_TOP_QUERIES com outras fórmulas de planilha, você pode construir dashboards de SEO poderosos que atualizam automaticamente com os dados mais recentes. Acompanhe mudanças semana a semana ou mês a mês em rankings de palavras-chave, identifique consultas em tendência e detecte oportunidades onde você tem altas impressões mas baixo CTR. Os dados retornados correspondem exatamente ao que você veria no relatório de Performance do Search Console, mas com a flexibilidade adicional de estar dentro de uma planilha onde você pode ordenar, filtrar, dinamizar e criar gráficos dos dados da forma que precisar.
Erros Comuns
NOT_AUTHORIZED: Acesso à propriedade do Search Console negadoCausa: A conta do Google conectada ao Unlimited Sheets não tem acesso à propriedade especificada do Search Console.
Correção: Certifique-se de que sua conta do Google tenha pelo menos permissão "Completa" na propriedade do Search Console. Vá para Search Console > Configurações > Usuários e permissões para verificar o acesso. Se usar uma propriedade de domínio, certifique-se de ter verificado a propriedade.
INVALID_DATE: Data inicial deve ser anterior à data finalCausa: A startDate é posterior à endDate, ou uma das datas está em formato inválido.
Correção: Verifique se suas datas estão no formato "YYYY-MM-DD" e que a data inicial vem antes da data final cronologicamente. Ao usar datas relativas, lembre-se de que "-30d" significa 30 dias atrás (anterior) e "-1d" significa ontem (posterior).
PROPERTY_NOT_FOUND: Nenhuma propriedade do Search Console conectadaCausa: Nenhuma propriedade padrão do Search Console foi definida e nenhum siteUrl foi fornecido.
Correção: Forneça o parâmetro siteUrl explicitamente (por exemplo, "sc-domain:example.com") ou conecte uma propriedade padrão através da barra lateral do Unlimited Sheets Search Console (Extensões > Unlimited Sheets > Search Console).
Perguntas Frequentes
O Google Search Console retém dados dos últimos 16 meses. Você pode usar qualquer intervalo de datas dentro dessa janela. As datas podem ser especificadas no formato "YYYY-MM-DD" ou como datas relativas como "-30d" (30 dias atrás), "-7d" (7 dias atrás) ou "-1d" (ontem). Os dados mais recentes disponíveis são tipicamente de 2-3 dias atrás devido ao atraso de processamento do Google.
Você pode recuperar até 25.000 consultas por requisição definindo o parâmetro de limite. O padrão é 100 se nenhum limite for especificado. Para sites com mais de 25.000 consultas ranqueadas, considere usar GSC_QUERY com dimensão de data para dividir dados em múltiplos intervalos de datas.
Os resultados são sempre ordenados por cliques em ordem decrescente, mostrando suas consultas de maior tráfego primeiro. Se você precisar de uma ordem de classificação diferente, pode usar a função SORT do Google Sheets nos dados retornados, por exemplo =SORT(GSC_TOP_QUERIES("-30d", "-1d"), 5, TRUE) para ordenar por posição crescente.
O siteUrl deve corresponder exatamente à sua propriedade do Search Console. Para propriedades de domínio use "sc-domain:example.com". Para propriedades de prefixo de URL use a URL completa como "https://www.example.com/". Se omitido, a função usa a propriedade padrão que você conectou durante a configuração.
Pequenas discrepâncias são normais e podem ocorrer devido a amostragem de dados, diferenças de fuso horário ou arredondamento. Os dados da API e a interface do Search Console usam o mesmo conjunto de dados subjacente, mas métodos de agregação podem produzir totais ligeiramente diferentes. Para a comparação mais precisa, certifique-se de estar usando exatamente o mesmo intervalo de datas e propriedade.
Sim, GSC_TOP_QUERIES funciona com planilhas automatizadas e atualizações programadas. No entanto, esteja atento aos limites de cota da API se você tiver muitas fórmulas atualizando simultaneamente. Para dashboards com múltiplas funções GSC, considere usar gatilhos de atualização manual ou escalonar os tempos de atualização.
Se não houver dados de desempenho de pesquisa para o intervalo de datas especificado (por exemplo, o site ainda não foi verificado ou não teve impressões), a função retorna um resultado vazio com apenas a linha de cabeçalho.
Não, GSC_TOP_QUERIES retorna apenas dados de pesquisa web por padrão. Google Discover e Google News têm tipos de dados separados na API do Search Console. Use GSC_QUERY com filtros de tipo de pesquisa apropriados se precisar de dados do Discover ou News.
Funções Relacionadas
GSC_TOP_PAGES
Obtenha as principais páginas do Google Search Console ordenadas por cliques.
GSC_PAGE_QUERIES
Obtenha consultas de pesquisa gerando tráfego para uma página específica.
GSC_KEYWORD_POSITION
Obtenha a posição média para uma palavra-chave específica do Google Search Console.
GSC_QUERY
Consulta personalizada do Google Search Console com controle total sobre dimensões e filtros.
Comece a usar GSC_TOP_QUERIES hoje
Instale o Unlimited Sheets para obter GSC_TOP_QUERIES e outras 41 funções poderosas no Google Sheets.
