GSC_TOP_PAGES
Obtén las principales páginas desde Google Search Console ordenadas por clics.
=GSC_TOP_PAGES(startDate, endDate, [limit], [siteUrl])Devuelve: 2D array with columns: Page, Clicks, Impressions, CTR, Position
Descripción General
GSC_TOP_PAGES recupera tus páginas con mejor rendimiento desde la API de Google Search Console directamente en Google Sheets. La función devuelve una tabla detallada con la URL de la página, clics totales, impresiones, porcentaje de clics (CTR) y posición promedio para cada página que apareció en los resultados de búsqueda de Google durante el rango de fechas especificado. Los resultados están ordenados por clics en orden descendente para que puedas ver inmediatamente qué páginas generan más tráfico orgánico.
Parámetros
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
startDate | string | Sí | Fecha de inicio en formato "YYYY-MM-DD" o formato relativo como "-30d" para hace 30 días. |
endDate | string | Sí | Fecha de fin en formato "YYYY-MM-DD" o formato relativo como "-1d" para ayer. |
limit | number | No (100) | Número máximo de filas a devolver. Por defecto 100, máximo 25000. |
siteUrl | string | No | La propiedad URL del sitio desde Search Console. Si se omite, usa la propiedad conectada por defecto. |
Ejemplos
Principales páginas de los últimos 30 días
Recupera las 100 principales páginas de los últimos 30 días usando la propiedad conectada por defecto.
=GSC_TOP_PAGES("-30d", "-1d")Salida
| 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 una semana específica
Obtén las 5 principales páginas para la primera semana de marzo de 2025 para analizar el rendimiento semanal.
=GSC_TOP_PAGES("2025-03-01", "2025-03-07", 5)Salida
| 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 |
Exportación completa de páginas para una propiedad de dominio
Exporta todas las páginas con tráfico de búsqueda de los últimos 90 días para una propiedad de dominio específica.
=GSC_TOP_PAGES("-90d", "-1d", 25000, "sc-domain:mystore.com")Salida
| 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 dos meses lado a lado
Extrae datos de enero en una pestaña y datos de febrero en otra para comparar el rendimiento de páginas mes tras mes.
=GSC_TOP_PAGES("2025-01-01", "2025-01-31", 50)Salida
| 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
Auditoría de Rendimiento de Contenido
Los estrategas de contenido analizan las principales páginas mensualmente para evaluar qué publicaciones de blog y páginas de destino generan más tráfico orgánico, informando decisiones sobre actualizaciones de contenido y prioridades de nuevos temas.
Optimización de Páginas de Producto
Los gerentes de e-commerce identifican páginas de producto con altas impresiones pero bajo CTR que necesitan mejores títulos, meta descripciones o datos estructurados para mejorar las tasas de clics desde los resultados de búsqueda.
Priorización de SEO Técnico
Los equipos de desarrollo usan datos a nivel de página para priorizar mejoras de Core Web Vitals y correcciones técnicas en las páginas que reciben más tráfico de búsqueda, maximizando el impacto de los esfuerzos de ingeniería.
Dashboard de Reporte de Clientes
Las agencias construyen dashboards automatizados que muestran las principales páginas de cada cliente con datos de tendencias, reduciendo el tiempo de reporte manual y proporcionando a los clientes visibilidad de rendimiento siempre actualizada.
Monitoreo de SEO Internacional
Las empresas globales comparan las principales páginas en diferentes propiedades específicas de país para entender qué contenido regional rinde mejor e identificar oportunidades de localización.
Pruebas A/B de Páginas de Destino
Los equipos de crecimiento monitorean el rendimiento de búsqueda de variantes de páginas de destino en pruebas A/B para medir el impacto del tráfico orgánico junto con métricas de conversión, asegurando que el SEO no se vea afectado negativamente por los experimentos.
Consejos Profesionales
Usa FILTER y REGEXMATCH sobre los resultados para aislar grupos específicos de páginas como /blog/, /product/ o /category/ para análisis de rendimiento por sección.
Crea un reporte de "Caída de Contenido" comparando las principales páginas de hace 3 meses versus hoy, marcando cualquier página con una caída de clics mayor al 20%.
Combina GSC_TOP_PAGES con GSC_PAGE_QUERIES para construir una auditoría de contenido completa: ve qué páginas obtienen más tráfico y qué palabras clave generan ese tráfico.
Para sitios grandes, exporta 25,000 páginas trimestralmente y usa formato condicional para resaltar páginas con CTR por debajo del 2% como oportunidades de optimización.
Entender qué páginas atraen más tráfico de búsqueda es fundamental para cualquier estrategia SEO. GSC_TOP_PAGES te permite identificar rápidamente tus pilares de contenido, detectar páginas que están perdiendo tráfico y descubrir páginas con potencial sin explotar (altas impresiones pero pocos clics). A diferencia de exportar datos manualmente desde la interfaz de Search Console, esta función mantiene tus datos en vivo y actualizables dentro de una hoja de cálculo donde puedes combinarlos con otras fuentes de datos.
La función admite tanto formatos de fecha estándar como fechas relativas convenientes. Usa "-7d" para una instantánea semanal, "-30d" para una vista mensual o especifica fechas exactas para comparaciones trimestre tras trimestre. El parámetro de límite controla cuántas páginas se devuelven, desde un resumen rápido de las 10 principales hasta una exportación completa de 25,000 páginas. Para sitios con múltiples propiedades de Search Console, el parámetro opcional siteUrl te permite especificar exactamente qué propiedad consultar. Combina esta función con GSC_PAGE_QUERIES para profundizar en las palabras clave específicas que generan tráfico a cada página, creando una imagen completa de tu rendimiento de búsqueda orgánica.
Errores Comunes
NOT_AUTHORIZED: Access to Search Console property deniedCausa: La cuenta de Google conectada a Unlimited Sheets no tiene permiso para acceder a la propiedad de Search Console especificada.
Solución: Verifica que tu cuenta de Google tenga al menos permiso "Completo" en Search Console > Configuración > Usuarios y permisos. Si consultas una propiedad específica con siteUrl, asegúrate de que la cadena de propiedad coincida exactamente (incluyendo el prefijo "sc-domain:" para propiedades de dominio o la URL completa para propiedades de prefijo URL).
INVALID_DATE: Start date must be before end dateCausa: El parámetro de fecha de inicio viene después de la fecha de fin cronológicamente, o una de las fechas está mal formateada.
Solución: Asegúrate de que las fechas sigan el formato "YYYY-MM-DD" y que la fecha de inicio sea anterior a la fecha de fin. Con fechas relativas, "-30d" (hace 30 días) debe ser el inicio y "-1d" (ayer) debe ser el fin.
LIMIT_EXCEEDED: Limit must be between 1 and 25000Causa: El parámetro de límite se estableció en un valor fuera del rango permitido.
Solución: Establece el límite a un valor entre 1 y 25000. Si necesitas más de 25,000 filas, divide tu solicitud en múltiples rangos de fechas o usa diferentes criterios de filtro.
Preguntas Frecuentes
Sí, la función puede devolver páginas que tienen impresiones pero cero clics. Estas páginas aparecieron en los resultados de búsqueda pero no fueron clicadas. Estos datos son valiosos para identificar páginas con visibilidad pero pobre CTR que podrían beneficiarse de etiquetas de título o meta descripciones mejoradas.
Search Console reporta datos basados en la URL canónica que Google seleccionó para cada página. Si tienes páginas duplicadas, sus métricas pueden consolidarse bajo una única URL canónica. Esto coincide con el comportamiento que ves en la interfaz web de Search Console.
GSC_TOP_PAGES devuelve todas las páginas ordenadas por clics. Para filtrar por una sección específica como /blog/, puedes envolver el resultado en una función FILTER: =FILTER(GSC_TOP_PAGES("-30d", "-1d", 5000), REGEXMATCH(GSC_TOP_PAGES("-30d", "-1d", 5000), "/blog/")). Alternativamente, usa GSC_QUERY con un filtro de página para mejor rendimiento.
GSC_TOP_PAGES muestra datos desde la perspectiva de Google: cómo aparecieron tus páginas en los resultados de búsqueda. Incluye impresiones (cuántas veces se mostraron las páginas) y posición promedio, que Analytics no tiene. Google Analytics muestra lo que sucede después del clic (sesiones, tasa de rebote, conversiones). Usar ambos juntos te da la imagen completa.
Las páginas solo aparecen si tuvieron al menos una impresión durante el rango de fechas especificado. Si una página no aparece, puede que no haya sido indexada, puede que no haya posicionado para ninguna consulta, o los datos pueden estar consolidados bajo una URL canónica diferente. Intenta aumentar el parámetro de límite o ampliar el rango de fechas.
Aunque GSC_TOP_PAGES te da una instantánea para un rango de fechas, puedes usar GSC_QUERY con la dimensión "date" y un filtro de página para obtener datos de rendimiento diario para una página específica. Esto te permite graficar tendencias de posición y clics a lo largo del tiempo.
Funciones Relacionadas
GSC_TOP_QUERIES
Obtén las principales consultas de búsqueda desde Google Search Console ordenadas por clics.
GSC_PAGE_QUERIES
Obtén las consultas de búsqueda que generan tráfico a una página específica.
GSC_QUERY
Consulta personalizada de Google Search Console con control total sobre dimensiones y filtros.
Comienza a usar GSC_TOP_PAGES hoy
Instala Unlimited Sheets para obtener GSC_TOP_PAGES y 41 otras funciones poderosas en Google Sheets.
