GSC_PAGE_QUERIES
Obtenha consultas de pesquisa gerando tráfego para uma página específica.
=GSC_PAGE_QUERIES(pageUrl, startDate, endDate, [limit], [siteUrl])Retorna: 2D array with columns: Query, Clicks, Impressions, CTR, Position
Visão Geral
GSC_PAGE_QUERIES revela exatamente quais consultas de pesquisa estão gerando tráfego para qualquer página específica em seu website. Ao fornecer uma URL de página, intervalo de datas e parâmetros opcionais, você obtém um detalhamento completo de cada palavra-chave que acionou sua página a aparecer nos resultados de pesquisa do Google, junto com os cliques, impressões, CTR e posição média para cada consulta. Esta é uma das funções mais acionáveis para otimização de conteúdo porque mostra a real intenção de pesquisa por trás de cada página.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
pageUrl | string | Sim | A URL completa da página a analisar (por exemplo, "https://example.com/blog/my-post"). |
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 consultas 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
Consultas para um post de blog
Veja quais consultas de pesquisa estão enviando tráfego para um post de blog específico nos últimos 30 dias.
=GSC_PAGE_QUERIES("https://example.com/blog/seo-guide", "-30d", "-1d")Saída
| Query | Clicks | Impressions | CTR | Position |
| seo guide 2025 | 340 | 5200 | 6.5% | 2.8 |
| seo best practices | 210 | 8900 | 2.4% | 7.3 |
| how to do seo | 180 | 6100 | 3.0% | 5.6 |
| search engine optimization guide | 95 | 3400 | 2.8% | 6.1 |
Consultas para uma página de produto
Obtenha as 50 principais consultas gerando tráfego para uma página de produto na última semana.
=GSC_PAGE_QUERIES("https://store.com/products/wireless-headphones", "-7d", "-1d", 50)Saída
| Query | Clicks | Impressions | CTR | Position |
| wireless headphones | 120 | 3800 | 3.2% | 6.4 |
| best wireless headphones 2025 | 85 | 2100 | 4.0% | 4.2 |
| bluetooth headphones review | 62 | 1900 | 3.3% | 5.8 |
Análise de consultas da homepage
Analise as 500 principais consultas levando usuários à homepage nos últimos 3 meses para entender tráfego de marca vs. não-marca.
=GSC_PAGE_QUERIES("https://myapp.com/", "-90d", "-1d", 500)Saída
| Query | Clicks | Impressions | CTR | Position |
| myapp | 8200 | 12000 | 68.3% | 1.0 |
| myapp.com | 3100 | 4500 | 68.9% | 1.0 |
| task management app | 450 | 18000 | 2.5% | 8.2 |
| best productivity tool | 280 | 15000 | 1.9% | 9.5 |
URL de página dinâmica de referência de célula
Use uma referência de célula para a URL da página para que você possa alternar rapidamente entre páginas sem editar a fórmula. Coloque a URL na célula A2.
=GSC_PAGE_QUERIES(A2, "-30d", "-1d", 200)Saída
| Query | Clicks | Impressions | CTR | Position |
| crm comparison | 520 | 9400 | 5.5% | 3.1 |
| best crm for small business | 380 | 7200 | 5.3% | 4.5 |
| crm software reviews | 290 | 6800 | 4.3% | 5.2 |
Consultas para uma propriedade de prefixo de URL
Especifique uma propriedade de prefixo de URL explicitamente quando sua conta tem múltiplas propriedades.
=GSC_PAGE_QUERIES("https://blog.company.com/post/analytics", "-30d", "-1d", 100, "https://blog.company.com/")Saída
| Query | Clicks | Impressions | CTR | Position |
| web analytics tutorial | 190 | 4200 | 4.5% | 3.8 |
| google analytics setup | 145 | 5100 | 2.8% | 6.2 |
| analytics for beginners | 110 | 3300 | 3.3% | 5.1 |
Casos de Uso
Priorização de Atualização de Conteúdo
Equipes de conteúdo analisam dados de consultas no nível de página para determinar quais artigos devem ser atualizados primeiro, focando em páginas onde a palavra-chave principal caiu em posição ou onde novas consultas relevantes surgiram.
Detecção de Canibalização de Palavras-chave
Especialistas em SEO executam GSC_PAGE_QUERIES em múltiplas páginas direcionando tópicos similares para identificar canibalização de palavras-chave, onde duas ou mais páginas competem pelas mesmas consultas e diluem o potencial de ranqueamento uma da outra.
Auditoria de SEO de Página de Produto
Equipes de SEO de e-commerce auditam páginas de produto para verificar se as palavras-chave alvo pretendidas são aquelas realmente gerando tráfego, e descobrir novas consultas de produto de cauda longa para adicionar a títulos e descrições.
Correspondência de Intenção de Landing Page
Equipes de marketing de produto analisam dados de consultas para landing pages chave para garantir que a mensagem da página se alinhe com a intenção de pesquisa dos visitantes, melhorando tanto rankings de SEO quanto taxas de conversão.
Otimização de Links Internos
Editores usam dados de consultas de página para construir estratégias de links internos mais inteligentes, conectando páginas que compartilham consultas relacionadas e criando clusters de tópicos que fortalecem a autoridade geral do domínio.
Dicas Profissionais
Construa um template de auditoria de conteúdo: liste suas principais páginas na coluna A, depois use =GSC_PAGE_QUERIES(A2, "-30d", "-1d", 10) em células adjacentes para ver as principais palavras-chave de cada página rapidamente.
Procure por consultas com altas impressões mas posições 8-20: essas são palavras-chave na borda da página 1 onde pequenas melhorias de conteúdo poderiam gerar ganhos significativos de tráfego.
Compare a consulta principal de cada página contra o H1 e title tag da página. Se não corresponderem, atualizar o título para incluir a consulta principal frequentemente melhora o CTR e rankings.
Use formatação condicional para destacar consultas com CTR abaixo de 2% nos resultados, facilitando identificar oportunidades de melhorias de meta descrição.
Para planejamento de cluster de conteúdo, execute GSC_PAGE_QUERIES em sua página pilar e procure por consultas que merecem suas próprias páginas dedicadas, depois crie essas páginas e faça links de volta para o pilar.
A otimização de conteúdo começa com o entendimento do que os usuários estão realmente pesquisando quando chegam à sua página. GSC_PAGE_QUERIES preenche a lacuna entre seu conteúdo e a intenção do usuário mostrando as frases exatas que o Google associa à sua página. Você pode descobrir que um post de blog sobre "dicas de email marketing" também está ranqueando para "como escrever linhas de assunto" ou "taxas de abertura de email" -- consultas que você poderia direcionar melhor com atualizações de conteúdo ou novas páginas dedicadas.
Esta função é particularmente poderosa para auditorias de SEO on-page. Para cada página importante, puxe seus dados de consulta para verificar se sua palavra-chave alvo é de fato a principal consulta por cliques. Se consultas inesperadas dominam, isso sinaliza uma incompatibilidade de conteúdo-intenção que precisa ser abordada. Você também pode identificar problemas de canibalização verificando se múltiplas páginas competem pelas mesmas consultas. Use o parâmetro de limite para ver além das palavras-chave principais óbvias e explorar as consultas de cauda longa que coletivamente podem representar uma porção significativa do seu tráfego. Combinada com GSC_TOP_PAGES, esta função habilita um fluxo de trabalho completo de auditoria de conteúdo página por página inteiramente dentro do Google Sheets.
Erros Comuns
NO_DATA: Nenhum dado de pesquisa encontrado para a página especificadaCausa: A URL da página não corresponde a nenhuma página indexada no Search Console, ou a página não teve impressões durante o intervalo de datas especificado.
Correção: Verifique a URL exata da página verificando a saída de GSC_TOP_PAGES ou a interface do Search Console. Certifique-se de que a URL inclui o protocolo (https://), caminho correto e quaisquer barras finais. Tente ampliar o intervalo de datas para capturar mais dados.
NOT_AUTHORIZED: Acesso à propriedade do Search Console negadoCausa: Sua conta Google conectada não tem acesso à propriedade do Search Console que possui a URL da página especificada.
Correção: Verifique se a URL da página pertence a uma propriedade do Search Console à qual você tem acesso. Se a página está sob uma propriedade diferente (por exemplo, uma propriedade de subdomínio), especifique o parâmetro siteUrl correto.
INVALID_URL: URL da página deve ser uma URL válidaCausa: O parâmetro pageUrl não é uma URL formatada corretamente.
Correção: Certifique-se de que a URL começa com "https://" ou "http://", inclui o domínio e tem o caminho correto. Não inclua fragmentos de URL (#section). Se referenciando uma célula, certifique-se de que a célula contém uma string de URL válida.
Perguntas Frequentes
Sim, a pageUrl deve corresponder exatamente como aparece no Search Console, incluindo o protocolo (https://), barras finais e quaisquer parâmetros de consulta. Se não tiver certeza da URL exata, primeiro use GSC_TOP_PAGES para ver como o Google reporta suas URLs de página, depois copie a string exata.
Não, GSC_PAGE_QUERIES requer uma URL de página exata. Para filtrar por padrões de URL (como todas as páginas sob /blog/), use GSC_QUERY com um filtro de página usando o operador "contains".
Isso pode acontecer devido ao limite de linhas. Se uma página ranqueia para milhares de consultas e você recupera apenas 100, a soma será menor que o total. Aumente o parâmetro de limite para capturar mais consultas. Além disso, consultas anonimizadas (pesquisas muito raras) não são reportadas individualmente mas estão incluídas nos totais agregados de página.
Use uma função FILTER nos resultados: =FILTER(GSC_PAGE_QUERIES(url, start, end, 1000), INDEX(GSC_PAGE_QUERIES(url, start, end, 1000),,5) > 10). Isso filtra para consultas onde a posição média é maior que 10, significando que sua página tipicamente aparece na página 2 ou além.
Sim, executando GSC_PAGE_QUERIES para diferentes intervalos de datas e comparando resultados. Para uma visualização de série temporal, use GSC_QUERY com dimensões "query" e "date" e um filtro de página para ver o desempenho diário de consultas para uma página específica.
Se a URL especificada não tem dados de pesquisa (ou não existe, não está indexada, ou não teve impressões durante o intervalo de datas), a função retorna um resultado vazio com apenas a linha de cabeçalho. Verifique novamente o formato da URL e tente um intervalo de datas mais amplo.
O Search Console tipicamente consolida dados AMP e mobile sob a URL canônica. Use a URL canônica como parâmetro pageUrl. Se seu site usa URLs mobile separadas (m.example.com), essas seriam páginas separadas no Search Console e você precisaria consultá-las individualmente.
Funções Relacionadas
GSC_TOP_PAGES
Obtenha as principais páginas do Google Search Console ordenadas por cliques.
GSC_TOP_QUERIES
Obtenha as principais consultas de pesquisa do Google Search Console ordenadas por cliques.
GSC_KEYWORD_POSITION
Obtenha a posição média para uma palavra-chave específica do Google Search Console.
Comece a usar GSC_PAGE_QUERIES hoje
Instale o Unlimited Sheets para obter GSC_PAGE_QUERIES e outras 41 funções poderosas no Google Sheets.
