GSC_TOP_PAGES
Obtenha as principais páginas do Google Search Console ordenadas por cliques.
=GSC_TOP_PAGES(startDate, endDate, [limit], [siteUrl])Retorna: 2D array with columns: Page, Clicks, Impressions, CTR, Position
Visão Geral
GSC_TOP_PAGES recupera suas páginas com melhor desempenho da API do Google Search Console diretamente para o Google Sheets. A função retorna uma tabela detalhada com a URL da página, total de cliques, impressões, taxa de cliques (CTR) e posição média para cada página que apareceu nos resultados de pesquisa do Google durante o intervalo de datas especificado. Os resultados são ordenados por cliques em ordem decrescente para que você possa ver imediatamente quais páginas geram mais tráfego orgânico.
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 páginas dos últimos 30 dias
Recupere as 100 principais páginas dos últimos 30 dias usando a propriedade conectada padrão.
=GSC_TOP_PAGES("-30d", "-1d")Saída
| Page | Clicks | Impressions | CTR | Position |
| https://example.com/blog/best-tools-2025 | 4200 | 62000 | 6.8% | 3.1 |
| https://example.com/pricing | 3100 | 41000 | 7.6% | 2.4 |
| https://example.com/blog/how-to-guide | 2800 | 39500 | 7.1% | 4.2 |
Top 5 páginas para uma semana específica
Obtenha as 5 principais páginas da primeira semana de março de 2025 para analisar o desempenho semanal.
=GSC_TOP_PAGES("2025-03-01", "2025-03-07", 5)Saída
| Page | Clicks | Impressions | CTR | Position |
| https://example.com/ | 1800 | 25000 | 7.2% | 1.8 |
| https://example.com/features | 950 | 14200 | 6.7% | 3.5 |
| https://example.com/blog/seo-tips | 720 | 11800 | 6.1% | 4.9 |
Exportação completa de páginas para uma propriedade de domínio
Exporte todas as páginas com tráfego de pesquisa dos últimos 90 dias para uma propriedade de domínio específica.
=GSC_TOP_PAGES("-90d", "-1d", 25000, "sc-domain:mystore.com")Saída
| Page | Clicks | Impressions | CTR | Position |
| https://mystore.com/product/widget-pro | 8900 | 120000 | 7.4% | 2.2 |
| https://mystore.com/category/widgets | 6500 | 95000 | 6.8% | 3.1 |
| https://mystore.com/ | 5200 | 78000 | 6.7% | 1.5 |
Comparar dois meses lado a lado
Puxe dados de janeiro em uma aba e dados de fevereiro em outra para comparar o desempenho de páginas mês a mês.
=GSC_TOP_PAGES("2025-01-01", "2025-01-31", 50)Saída
| Page | Clicks | Impressions | CTR | Position |
| https://example.com/blog/year-review | 3600 | 52000 | 6.9% | 2.8 |
| https://example.com/tools/calculator | 2400 | 38000 | 6.3% | 4.5 |
| https://example.com/about | 1100 | 19000 | 5.8% | 6.2 |
Casos de Uso
Auditoria de Performance de Conteúdo
Estrategistas de conteúdo analisam as principais páginas mensalmente para avaliar quais posts de blog e landing pages geram mais tráfego orgânico, informando decisões sobre atualizações de conteúdo e novas prioridades de tópicos.
Otimização de Páginas de Produto
Gerentes de e-commerce identificam páginas de produtos com alta impressão mas baixo CTR que precisam de melhores títulos, meta descrições ou dados estruturados para melhorar taxas de cliques dos resultados de pesquisa.
Priorização de SEO Técnico
Equipes de desenvolvimento usam dados de nível de página para priorizar melhorias de Core Web Vitals e correções técnicas nas páginas que recebem mais tráfego de pesquisa, maximizando o impacto dos esforços de engenharia.
Dashboard de Relatórios para Clientes
Agências constroem dashboards automatizados mostrando as principais páginas de cada cliente com dados de tendência, reduzindo tempo de relatórios manuais e fornecendo aos clientes visibilidade de desempenho sempre atual.
Monitoramento de SEO Internacional
Empresas globais comparam as principais páginas em diferentes propriedades específicas de países para entender qual conteúdo regional tem melhor desempenho e identificar oportunidades de localização.
Testes A/B de Landing Pages
Equipes de crescimento monitoram o desempenho de pesquisa de variantes de landing pages em testes A/B para medir impacto de tráfego orgânico junto com métricas de conversão, garantindo que o SEO não seja afetado negativamente por experimentos.
Dicas Profissionais
Use FILTER e REGEXMATCH nos resultados para isolar grupos de páginas específicos como /blog/, /product/ ou /category/ para análise de desempenho por seção.
Crie um relatório de "Decaimento de Conteúdo" comparando as principais páginas de 3 meses atrás versus hoje, sinalizando quaisquer páginas com queda de cliques maior que 20%.
Combine GSC_TOP_PAGES com GSC_PAGE_QUERIES para construir uma auditoria completa de conteúdo: veja quais páginas recebem mais tráfego e quais palavras-chave geram esse tráfego.
Para sites grandes, exporte 25.000 páginas trimestralmente e use formatação condicional para destacar páginas com CTR abaixo de 2% como oportunidades de otimização.
Entender quais páginas atraem mais tráfego de pesquisa é fundamental para qualquer estratégia de SEO. GSC_TOP_PAGES permite identificar rapidamente seus pilares de conteúdo, detectar páginas que estão perdendo tráfego e descobrir páginas com potencial inexplorado (altas impressões mas poucos cliques). Ao contrário de exportar manualmente dados da interface do Search Console, esta função mantém seus dados dinâmicos e atualizáveis dentro de uma planilha onde você pode combiná-los com outras fontes de dados.
A função suporta tanto formatos de data padrão quanto datas relativas convenientes. Use "-7d" para um snapshot semanal, "-30d" para uma visualização mensal ou especifique datas exatas para comparações trimestre a trimestre. O parâmetro de limite controla quantas páginas são retornadas, desde uma visão rápida dos 10 principais até uma exportação abrangente de 25.000 páginas. Para sites com múltiplas propriedades do Search Console, o parâmetro opcional siteUrl permite especificar exatamente qual propriedade consultar. Combine esta função com GSC_PAGE_QUERIES para detalhar as palavras-chave específicas que geram tráfego para cada página, criando uma imagem completa de seu desempenho de pesquisa orgânica.
Erros Comuns
NOT_AUTHORIZED: Acesso à propriedade do Search Console negadoCausa: A conta do Google conectada ao Unlimited Sheets não tem permissão para acessar a propriedade especificada do Search Console.
Correção: Verifique se sua conta do Google tem pelo menos permissão "Completa" em Search Console > Configurações > Usuários e permissões. Se consultar uma propriedade específica com siteUrl, certifique-se de que a string da propriedade corresponde exatamente (incluindo o prefixo "sc-domain:" para propriedades de domínio ou a URL completa para propriedades de prefixo de URL).
INVALID_DATE: Data inicial deve ser anterior à data finalCausa: O parâmetro startDate vem depois de endDate cronologicamente, ou uma das datas está formatada incorretamente.
Correção: Certifique-se de que as datas seguem o formato "YYYY-MM-DD" e que a data inicial é anterior à data final. Com datas relativas, "-30d" (30 dias atrás) deve ser o início e "-1d" (ontem) deve ser o fim.
LIMIT_EXCEEDED: Limite deve estar entre 1 e 25000Causa: O parâmetro de limite foi definido com um valor fora do intervalo permitido.
Correção: Defina o limite para um valor entre 1 e 25000. Se você precisar de mais de 25.000 linhas, divida sua solicitação em múltiplos intervalos de datas ou use critérios de filtro diferentes.
Perguntas Frequentes
Sim, a função pode retornar páginas que têm impressões mas zero cliques. Essas páginas apareceram nos resultados de pesquisa mas não foram clicadas. Esses dados são valiosos para identificar páginas com visibilidade mas CTR baixo que poderiam se beneficiar de title tags ou meta descrições melhoradas.
O Search Console reporta dados baseados na URL canônica que o Google selecionou para cada página. Se você tem páginas duplicadas, suas métricas podem ser consolidadas sob uma única URL canônica. Isso corresponde ao comportamento que você vê na interface web do Search Console.
GSC_TOP_PAGES retorna todas as páginas ordenadas por cliques. Para filtrar uma seção específica como /blog/, você pode envolver o resultado em uma função FILTER: =FILTER(GSC_TOP_PAGES("-30d", "-1d", 5000), REGEXMATCH(GSC_TOP_PAGES("-30d", "-1d", 5000), "/blog/")). Alternativamente, use GSC_QUERY com um filtro de página para melhor desempenho.
GSC_TOP_PAGES mostra dados da perspectiva do Google: como suas páginas apareceram nos resultados de pesquisa. Inclui impressões (quantas vezes as páginas foram mostradas) e posição média, que o Analytics não tem. O Google Analytics mostra o que acontece após o clique (sessões, taxa de rejeição, conversões). Usar ambos juntos dá a você a imagem completa.
As páginas só aparecem se tiveram pelo menos uma impressão durante o intervalo de datas especificado. Se uma página não está aparecendo, pode não estar indexada, pode não ter ranqueado para nenhuma consulta, ou os dados podem estar consolidados sob uma URL canônica diferente. Tente aumentar o parâmetro de limite ou ampliar o intervalo de datas.
Embora GSC_TOP_PAGES forneça um snapshot para um intervalo de datas, você pode usar GSC_QUERY com a dimensão "date" e um filtro de página para obter dados de desempenho diários para uma página específica. Isso permite criar gráficos de tendências de posição e cliques ao longo do tempo.
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_TOP_PAGES hoje
Instale o Unlimited Sheets para obter GSC_TOP_PAGES e outras 41 funções poderosas no Google Sheets.
