GSC_QUERY
Consulta personalizada de Google Search Console con control total sobre dimensiones y filtros.
=GSC_QUERY(startDate, endDate, [dimensions], [limit], [filterDimension], [filterOperator], [filterValue], [siteUrl])Devuelve: 2D array with columns for each selected dimension + Clicks, Impressions, CTR, Position
Descripción General
GSC_QUERY es la función de Search Console más flexible y poderosa, dándote control completo sobre qué datos recuperas y cómo se estructuran. Mientras las otras funciones GSC cubren casos de uso comunes con parámetros simplificados, GSC_QUERY te permite especificar dimensiones personalizadas, aplicar filtros y combinar múltiples ejes de datos en una sola solicitud. Refleja las capacidades completas del endpoint searchAnalytics.query de la API de Google Search Console, haciendo posible construir virtualmente cualquier reporte de rendimiento de búsqueda.
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. |
dimensions | string | No (query) | Lista separada por comas de dimensiones: query, page, country, device, date. Por defecto "query". |
limit | number | No (100) | Número máximo de filas a devolver. Por defecto 100, máximo 25000. |
filterDimension | string | No | La dimensión sobre la cual filtrar: query, page, country o device. |
filterOperator | string | No | El operador de filtro: "equals", "contains" o "notContains". |
filterValue | string | No | El valor por el cual filtrar (ej., un patrón de URL, código de país o palabra clave). |
siteUrl | string | No | La propiedad URL del sitio desde Search Console. Si se omite, usa la propiedad conectada por defecto. |
Ejemplos
Consultas por país
Obtén las principales consultas desglosadas por país para entender el rendimiento de búsqueda geográfico.
=GSC_QUERY("-30d", "-1d", "query,country", 500)Salida
| Query | Country | Clicks | Impressions | CTR | Position |
| best crm software | USA | 520 | 9400 | 5.5% | 3.1 |
| best crm software | GBR | 180 | 3200 | 5.6% | 3.4 |
| crm comparison | USA | 340 | 6100 | 5.6% | 4.2 |
| crm comparison | DEU | 95 | 2100 | 4.5% | 5.8 |
Tendencias de clics diarios
Obtén clics e impresiones diarias totales para los últimos 14 días para graficar tendencias generales de búsqueda.
=GSC_QUERY("-14d", "-1d", "date", 14)Salida
| Date | Clicks | Impressions | CTR | Position |
| 2025-03-01 | 1250 | 18500 | 6.8% | 12.3 |
| 2025-03-02 | 1180 | 17800 | 6.6% | 12.5 |
| 2025-03-03 | 1420 | 21200 | 6.7% | 11.8 |
Consultas solo de blog filtradas por página
Obtén consultas que solo generaron tráfico a páginas de blog filtrando por URL de página que contenga "/blog/".
=GSC_QUERY("-30d", "-1d", "query", 200, "page", "contains", "/blog/")Salida
| Query | Clicks | Impressions | CTR | Position |
| how to write a business plan | 890 | 14200 | 6.3% | 3.8 |
| business plan template | 720 | 12500 | 5.8% | 4.1 |
| startup business plan example | 540 | 8900 | 6.1% | 4.5 |
Análisis de tráfico no-marca
Excluye consultas de nombre de marca para analizar solo el rendimiento de búsqueda orgánica no-marca.
=GSC_QUERY("-30d", "-1d", "query", 1000, "query", "notContains", "mycompany")Salida
| Query | Clicks | Impressions | CTR | Position |
| project management tools | 980 | 22100 | 4.4% | 5.1 |
| task tracking software | 650 | 14800 | 4.4% | 6.3 |
| team collaboration app | 520 | 11200 | 4.6% | 5.8 |
Rendimiento móvil vs escritorio por página
Desglosa el rendimiento de página por tipo de dispositivo para identificar páginas que rinden mal en móvil.
=GSC_QUERY("-30d", "-1d", "page,device", 500)Salida
| Page | Device | Clicks | Impressions | CTR | Position |
| https://example.com/pricing | DESKTOP | 1800 | 24000 | 7.5% | 2.3 |
| https://example.com/pricing | MOBILE | 1200 | 19000 | 6.3% | 2.8 |
| https://example.com/blog/guide | DESKTOP | 950 | 13500 | 7.0% | 3.5 |
| https://example.com/blog/guide | MOBILE | 1100 | 16200 | 6.8% | 3.2 |
Casos de Uso
Análisis de Rendimiento Geográfico
Las empresas internacionales analizan el rendimiento de búsqueda por país para identificar qué mercados tienen la visibilidad orgánica más fuerte y dónde invertir en contenido localizado y esfuerzos SEO.
Dashboard de Monitoreo SEO Diario
Las agencias construyen dashboards de monitoreo diario usando la dimensión "date" para rastrear tendencias de clics, detectar caídas repentinas de tráfico y correlacionar cambios con actualizaciones de algoritmo de Google o actividad de competidores.
Optimización SEO Mobile-First
Los equipos de desarrollo comparan rendimiento móvil vs. escritorio para páginas clave, identificando problemas de ranking específicos de móvil que indican problemas de Core Web Vitals o usabilidad móvil.
Reporte de Tráfico No-Marca
Los equipos de marketing aíslan tráfico de búsqueda no-marca usando filtros de consulta para medir el crecimiento real de búsqueda orgánica independiente de campañas de conciencia de marca y búsquedas directas de marca.
Rendimiento de Sección de Contenido
Los editores filtran por patrones de URL de página para comparar rendimiento entre secciones de contenido (noticias, opiniones, reseñas, tutoriales), guiando la asignación de recursos editoriales.
Evaluación de Impacto de Actualización de Algoritmo
Los consultores SEO usan consultas de dimensión de fecha alrededor de fechas de actualización de algoritmo conocidas para medir el impacto en sitios de clientes, proporcionando recomendaciones basadas en datos para estrategias de recuperación.
Consejos Profesionales
Usa la dimensión "date" sin ninguna otra dimensión para obtener totales de clics diarios de todo el sitio, perfecto para crear un gráfico simple de tendencia de tráfico.
Filtra por página "contains" un segmento de URL para analizar rendimiento de secciones específicas del sitio sin necesidad de conocer cada URL de página individual.
Combina dimensiones "query,date" con un filtro de consulta para rastrear cambios de posición diarios para una palabra clave específica a lo largo del tiempo, creando una línea de tendencia de posición.
Usa dimensión "query" con un filtro de página (filterDimension "page", filterOperator "contains", filterValue "/product/") para encontrar todas las palabras clave que generan tráfico específicamente a páginas de producto.
Para análisis de tráfico no-marca, usa filterDimension "query" con filterOperator "notContains" y el nombre de tu marca como filterValue. Esto es más eficiente que filtrar después del hecho.
El parámetro de dimensiones controla qué columnas de datos se devuelven. Puedes solicitar cualquier combinación de "query", "page", "country", "device" y "date" como una cadena separada por comas. Por ejemplo, dimensiones "query,country" devuelve rendimiento de búsqueda desglosado por palabra clave y país, mientras que "page,device" muestra rendimiento de página dividido por escritorio, móvil y tablet. La dimensión "date" es especialmente poderosa ya que permite análisis de series temporales, permitiéndote graficar tendencias diarias de clics, impresiones y posiciones.
El sistema de filtrado te permite reducir resultados a subconjuntos específicos de tus datos. Elige una dimensión de filtro (query, page, country o device), un operador (equals, contains o notContains) y un valor para incluir o excluir datos específicos. Por ejemplo, filtrar por página "contains" "/blog/" para ver solo el rendimiento de contenido de blog, o filtrar por consulta "notContains" "nombre de marca" para aislar tráfico de búsqueda no-marca. Esto elimina la necesidad de post-procesamiento con funciones FILTER y reduce transferencia de datos.
GSC_QUERY es la función a usar cuando las funciones GSC más simples no proporcionan la vista exacta de datos que necesitas. Ya sea que quieras desgloses a nivel de país, rendimiento específico por dispositivo, datos de tendencias diarias o subconjuntos filtrados de tus análisis de búsqueda, esta función lo entrega con una sola fórmula.
Errores Comunes
INVALID_DIMENSION: Unknown dimension specifiedCausa: El parámetro dimensions contiene un nombre de dimensión no reconocido. Las dimensiones válidas son: query, page, country, device, date.
Solución: Verifica errores tipográficos en el parámetro dimensions. Usa solo los valores admitidos: "query", "page", "country", "device", "date". Separa múltiples dimensiones con comas y sin espacios (ej., "query,country" no "query, country").
INVALID_FILTER: Filter operator must be equals, contains, or notContainsCausa: El parámetro filterOperator contiene un valor de operador no admitido.
Solución: Usa uno de los tres operadores admitidos: "equals" para coincidencia exacta, "contains" para coincidencia parcial o "notContains" para exclusión. Estos operadores distinguen mayúsculas en el parámetro pero aplican coincidencia sin distinguir mayúsculas a los datos.
INCOMPLETE_FILTER: All three filter parameters must be provided togetherCausa: Solo algunos de los parámetros de filtro (filterDimension, filterOperator, filterValue) fueron proporcionados. Los tres son requeridos al usar filtros.
Solución: Al aplicar un filtro, debes proporcionar los tres parámetros: filterDimension (qué filtrar), filterOperator (cómo filtrar) y filterValue (qué valor coincidir). Si no quieres filtrar, omite los tres parámetros.
Preguntas Frecuentes
Puedes combinar cualquiera de estas dimensiones: "query", "page", "country", "device" y "date". Pásalas como una cadena separada por comas como "query,country" o "page,device,date". Cada combinación te da una sección transversal de datos diferente. Nota que más dimensiones resultan en datos más granulares y más filas, así que puede que necesites aumentar el parámetro de límite.
Los valores de país se devuelven como códigos ISO 3166-1 alfa-3 de 3 letras (ej., "USA", "GBR", "DEU", "FRA", "JPN"). Al filtrar por país, usa estos mismos códigos. Por ejemplo, filterDimension "country", filterOperator "equals", filterValue "USA" para obtener solo datos de búsqueda de EE.UU.
La dimensión device devuelve tres valores: "DESKTOP", "MOBILE" y "TABLET". Al filtrar por dispositivo, usa estas cadenas exactas. Por ejemplo, filterDimension "device", filterOperator "equals", filterValue "MOBILE" para obtener solo datos de búsqueda móvil.
La función actual admite un solo filtro por llamada. Para múltiples condiciones de filtro, puedes hacer llamadas GSC_QUERY separadas con diferentes filtros o aplicar un solo filtro de API y luego usar la función FILTER de Google Sheets sobre los resultados para filtrado adicional. Para la mayoría de casos de uso, un filtro combinado con fórmulas de hoja de cálculo es suficiente.
El operador "equals" coincide con el valor exacto (ej., query equals "seo tools" coincide solo con esa consulta exacta). El operador "contains" coincide si el valor de dimensión incluye la cadena de filtro en cualquier lugar (ej., page contains "/blog/" coincide con cualquier URL con /blog/ en ella). El operador "notContains" excluye valores coincidentes (ej., query notContains "nombre de marca" excluye todas las consultas de marca). Estos operadores no distinguen entre mayúsculas y minúsculas.
Cuando "date" se incluye como dimensión, los resultados se desglosan por día individual. Cada fila incluye una columna de fecha en formato "YYYY-MM-DD" junto con las métricas para ese día específico. Esto es esencial para análisis de series temporales y gráficos de tendencias. Sin la dimensión date, las métricas se agregan en todo el rango de fechas.
El máximo es 25,000 filas independientemente de las dimensiones. Sin embargo, combinar múltiples dimensiones aumenta dramáticamente el número de filas únicas. Por ejemplo, 1,000 consultas en 5 países producirían hasta 5,000 filas. Si tus datos exceden el límite, reduce tu rango de fechas, agrega un filtro o reduce dimensiones.
Sí, GSC_QUERY es la función de poder subyacente. GSC_TOP_QUERIES es equivalente a GSC_QUERY con dimensiones "query", GSC_TOP_PAGES con dimensiones "page", GSC_PAGE_QUERIES con dimensiones "query" y un filtro de página, y GSC_KEYWORD_POSITION con dimensiones "query" y un filtro de consulta. Las funciones especializadas son más simples de usar para casos comunes.
Funciones Relacionadas
GSC_TOP_QUERIES
Obtén las principales consultas de búsqueda desde Google Search Console ordenadas por clics.
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.
Comienza a usar GSC_QUERY hoy
Instala Unlimited Sheets para obtener GSC_QUERY y 41 otras funciones poderosas en Google Sheets.
