GSC_TOP_QUERIES
Obtén las principales consultas de búsqueda desde Google Search Console ordenadas por clics.
=GSC_TOP_QUERIES(startDate, endDate, [limit], [siteUrl])Devuelve: 2D array with columns: Query, Clicks, Impressions, CTR, Position
Descripción General
GSC_TOP_QUERIES extrae tus principales consultas de búsqueda directamente desde la API de Google Search Console a Google Sheets. La función devuelve una tabla completa de métricas que incluye el texto de la consulta, clics, impresiones, porcentaje de clics (CTR) y posición promedio para cada palabra clave por la que se posiciona tu sitio. Los resultados están ordenados por clics en orden descendente, facilitando la identificación de qué términos de búsqueda generan más tráfico a tu sitio.
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 consultas de los últimos 30 días
Recupera las 100 principales consultas de búsqueda de los últimos 30 días usando formato de fecha relativo.
=GSC_TOP_QUERIES("-30d", "-1d")Salida
| 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 un mes específico
Obtén solo las 10 principales consultas para enero de 2025.
=GSC_TOP_QUERIES("2025-01-01", "2025-01-31", 10)Salida
| 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 |
Exportación completa para una propiedad específica
Exporta hasta 25,000 consultas de los últimos 90 días para una propiedad de dominio específica de Search Console.
=GSC_TOP_QUERIES("-90d", "-1d", 25000, "sc-domain:example.com")Salida
| 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 |
Resumen rápido de los últimos 7 días
Obtén una instantánea rápida de las 20 principales consultas de la última semana para una revisión semanal.
=GSC_TOP_QUERIES("-7d", "-1d", 20)Salida
| 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
Reporte Semanal de Rendimiento SEO
Las agencias de marketing extraen las principales consultas semanalmente para rastrear el rendimiento de palabras clave de clientes, identificar mejoras en rankings y reportar el ROI de búsqueda orgánica en dashboards automatizados.
Análisis de Brechas de Contenido
Los equipos editoriales analizan las principales consultas para descubrir qué temas generan más tráfico de búsqueda e identificar palabras clave con altas impresiones pero bajo CTR que necesitan mejor contenido o meta descripciones.
Descubrimiento de Productos E-commerce
Los minoristas en línea monitorean las principales consultas de búsqueda para entender cómo los clientes encuentran sus productos, identificar búsquedas de productos en tendencia y optimizar títulos y descripciones de páginas de productos.
Benchmarking de Palabras Clave de Competidores
Las empresas SaaS exportan las principales consultas mensualmente para comparar contra listas de palabras clave de competidores, identificar oportunidades de posicionamiento en el mercado e informar estrategias de búsqueda pagada.
Detección de Tendencias Estacionales
Las empresas de viajes comparan las principales consultas en diferentes períodos de tiempo para identificar tendencias de búsqueda estacionales y planificar calendarios de contenido alrededor de períodos pico de reservas.
Consejos Profesionales
Usa fechas relativas como "-30d" y "-1d" para crear dashboards que siempre muestren los últimos datos sin necesidad de actualizar celdas de fechas manualmente.
Combina con VLOOKUP o INDEX/MATCH contra una exportación del período anterior para calcular cambios semana tras semana o mes tras mes en clics y posición.
Filtra los resultados por consultas donde las impresiones sean altas pero el CTR esté por debajo del 3% para encontrar tus mejores oportunidades de mejorar etiquetas de título y meta descripciones.
Exporta 25,000 filas trimestralmente y usa tablas dinámicas para rastrear tendencias de palabras clave de cola larga que pueden no aparecer en una vista top-100 más corta.
Si gestionas múltiples sitios, usa el parámetro siteUrl para extraer datos de cada propiedad en pestañas separadas de la misma hoja de cálculo para una comparación fácil.
Esta función es esencial para profesionales SEO que necesitan monitorear regularmente el rendimiento de palabras clave sin iniciar sesión manualmente en Google Search Console. Puedes especificar rangos de fechas personalizados usando formatos de fecha estándar o fechas relativas convenientes como "-30d" para los últimos 30 días o "-7d" para la última semana. El parámetro opcional de límite te permite controlar cuántas filas se devuelven, desde una lista enfocada de las 10 principales hasta una exportación completa de hasta 25,000 consultas.
Al combinar GSC_TOP_QUERIES con otras fórmulas de hojas de cálculo, puedes crear potentes dashboards SEO que se actualizan automáticamente con los últimos datos. Rastrea cambios semana tras semana o mes tras mes en rankings de palabras clave, identifica consultas en tendencia y detecta oportunidades donde tienes altas impresiones pero bajo CTR. Los datos devueltos coinciden exactamente con lo que verías en el informe de Rendimiento de Search Console, pero con la flexibilidad adicional de estar dentro de una hoja de cálculo donde puedes ordenar, filtrar, pivotar y graficar los datos como necesites.
Errores Comunes
NOT_AUTHORIZED: Access to Search Console property deniedCausa: La cuenta de Google conectada a Unlimited Sheets no tiene acceso a la propiedad de Search Console especificada.
Solución: Asegúrate de que tu cuenta de Google tenga al menos permiso "Completo" en la propiedad de Search Console. Ve a Search Console > Configuración > Usuarios y permisos para verificar el acceso. Si usas una propiedad de dominio, asegúrate de haber verificado la propiedad.
INVALID_DATE: Start date must be before end dateCausa: La fecha de inicio es posterior a la fecha de fin, o una de las fechas está en formato inválido.
Solución: Verifica que tus fechas estén en formato "YYYY-MM-DD" y que la fecha de inicio venga antes de la fecha de fin cronológicamente. Al usar fechas relativas, recuerda que "-30d" significa hace 30 días (anterior) y "-1d" significa ayer (posterior).
PROPERTY_NOT_FOUND: No Search Console property connectedCausa: No se ha establecido una propiedad de Search Console por defecto y no se proporcionó siteUrl.
Solución: Proporciona el parámetro siteUrl explícitamente (ej., "sc-domain:example.com") o conecta una propiedad por defecto a través de la barra lateral de Search Console de Unlimited Sheets (Extensiones > Unlimited Sheets > Search Console).
Preguntas Frecuentes
Google Search Console retiene datos de los últimos 16 meses. Puedes usar cualquier rango de fechas dentro de esa ventana. Las fechas se pueden especificar en formato "YYYY-MM-DD" o como fechas relativas como "-30d" (hace 30 días), "-7d" (hace 7 días) o "-1d" (ayer). Los datos más recientes disponibles suelen ser de hace 2-3 días debido al retraso de procesamiento de Google.
Puedes recuperar hasta 25,000 consultas por solicitud estableciendo el parámetro de límite. El valor por defecto es 100 si no se especifica límite. Para sitios con más de 25,000 consultas posicionadas, considera usar GSC_QUERY con dimensión de fecha para dividir los datos en múltiples rangos de fechas.
Los resultados siempre están ordenados por clics en orden descendente, mostrando tus consultas de mayor tráfico primero. Si necesitas un orden diferente, puedes usar la función SORT de Google Sheets sobre los datos devueltos, por ejemplo =SORT(GSC_TOP_QUERIES("-30d", "-1d"), 5, TRUE) para ordenar por posición ascendente.
El siteUrl debe coincidir exactamente con tu propiedad de Search Console. Para propiedades de dominio usa "sc-domain:example.com". Para propiedades de prefijo URL usa la URL completa como "https://www.example.com/". Si se omite, la función usa la propiedad por defecto que conectaste durante la configuración.
Las discrepancias menores son normales y pueden ocurrir debido al muestreo de datos, diferencias de zona horaria o redondeo. Los datos de la API y la interfaz de Search Console usan el mismo conjunto de datos subyacente, pero los métodos de agregación pueden producir totales ligeramente diferentes. Para la comparación más precisa, asegúrate de usar exactamente el mismo rango de fechas y propiedad.
Sí, GSC_TOP_QUERIES funciona con hojas automatizadas y actualizaciones programadas. Sin embargo, ten en cuenta los límites de cuota de API si tienes muchas fórmulas actualizándose simultáneamente. Para dashboards con múltiples funciones GSC, considera usar disparadores de actualización manual o escalonar los tiempos de actualización.
Si no hay datos de rendimiento de búsqueda para el rango de fechas especificado (por ejemplo, el sitio aún no estaba verificado o no tuvo impresiones), la función devuelve un resultado vacío con solo la fila de encabezado.
No, GSC_TOP_QUERIES devuelve solo datos de búsqueda web por defecto. Google Discover y Google News tienen tipos de datos separados en la API de Search Console. Usa GSC_QUERY con filtros de tipo de búsqueda apropiados si necesitas datos de Discover o News.
Funciones Relacionadas
GSC_TOP_PAGES
Obtén las principales páginas 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_KEYWORD_POSITION
Obtén la posición promedio para una palabra clave específica desde Google Search Console.
GSC_QUERY
Consulta personalizada de Google Search Console con control total sobre dimensiones y filtros.
Comienza a usar GSC_TOP_QUERIES hoy
Instala Unlimited Sheets para obtener GSC_TOP_QUERIES y 41 otras funciones poderosas en Google Sheets.
