GSC, bien leído · Parte 8 de 8
Blog / Búsqueda y visibilidad en IA
Más allá de la pantalla de GSC: la API, la exportación masiva y lo que no ves
La pantalla de GSC muestra 1.000 filas y 16 meses. La API de Search Console y la exportación masiva a BigQuery muestran mucho más. Qué te da cada una, qué sigue escondido, cuánto cuesta y cómo guardar tu propia copia antes de que se acabe el historial.
La pantalla de Rendimiento de GSC (Google Search Console) es donde la mayoría se detiene. Es una buena pantalla, pero es un resumen: una tabla cortada en 1.000 filas, un historial de 16 meses y algunas búsquedas que se dejan fuera a propósito.¹ ² Para un sitio pequeño alcanza. Para un sitio con cientos de páginas, o para un negocio que quiere comparar este año con hace tres años, la pantalla esconde casi todo lo que importa.
Google ofrece otras dos puertas a los mismos datos: la API de Search Console y la exportación masiva de datos a BigQuery. Esta parte de la serie explica qué te da cada una, qué no te da ninguna y cómo usamos la primera en nuestras auditorías. Si GSC es nuevo para ti, empieza por la parte 1, ¿Qué es GSC?
Si lideras el equipo: qué preguntar
- ¿Estamos guardando nuestra propia copia de los datos de GSC, o vamos a perder todo lo que tenga más de 16 meses?
- Cuando miramos nuestros datos de búsqueda, ¿vemos la lista completa o solo las primeras 1.000 filas?
- ¿Quién de afuera de la empresa puede leer nuestro GSC, y con qué permiso?
Lo que la pantalla esconde
- Las filas después de la 1.000. La tabla del informe de Rendimiento muestra como máximo 1.000 filas, así que pueden faltar búsquedas y páginas poco frecuentes.² En un sitio con muchas páginas, esa cola larga suele ser donde está la mayoría de las búsquedas.
- Las búsquedas raras, a propósito. Por privacidad, Google deja fuera las búsquedas que hace muy poca gente. Siguen contando en los totales del gráfico, pero sus palabras nunca aparecen.² Ninguna herramienta, API ni exportación las recupera.
- Todo lo que tenga más de 16 meses. El periodo más largo que puedes elegir son los últimos 16 meses. Si quieres más, el propio Google recomienda usar la API de Search Analytics o la exportación masiva.³ Ninguna de las dos viaja al pasado: te permiten empezar a guardar una copia desde ahora.
- Los últimos dos o tres días. Los datos nuevos suelen llegar con dos o tres días de retraso,² así que el borde derecho de cada gráfico todavía se está llenando.
La API de Search Console: los mismos datos, sin el corte de 1.000 filas
La API es la forma en que un programa lee GSC. Cada consulta devuelve los mismos cuatro números que la pantalla (clics, impresiones, tasa de clics y posición media), divididos por las dimensiones que pidas: búsqueda, página, país, dispositivo, aspecto en la búsqueda, fecha e incluso hora.⁴
Los límites son mucho más amplios que los de la pantalla:
- Hasta 25.000 filas por consulta, y puedes recorrer más pidiendo el bloque siguiente.⁴
- Hasta 50.000 filas por día de datos, por tipo de búsqueda (web, imágenes, video y otros), ordenadas por clics.⁵ Para muchos sitios eso es la lista completa; para los muy grandes, es la parte de arriba.
- No promete todas las filas. Google dice que la API devuelve las filas principales, no necesariamente todas, y que dividir por página y búsqueda a la vez puede dejar fuera algunos datos.⁴ ⁵
- Las búsquedas raras siguen escondidas, igual que en la pantalla.
La API es gratis. Lo que cuesta es alguien que sepa consultarla, guardar las respuestas y darle sentido a decenas de miles de filas.
Exportación masiva: todo, cada día, en tu propia base de datos
La exportación masiva envía tus datos de rendimiento de GSC a BigQuery, la base de datos en la nube de Google, una vez al día.⁶ Google la describe como todos los datos de rendimiento que Search Console tiene de tu propiedad, salvo las búsquedas raras que esconde por privacidad.⁶ Llegan en dos tablas, una con los totales de todo el sitio y otra dividida por página, más un registro de cada exportación.¹¹
Tres cosas que conviene saber antes de activarla:
- Empieza el día en que la configuras. La primera exportación trae los datos de ese día; para lo anterior, Google te remite a la API o a los informes.⁷ Cada mes que esperas es un mes que nunca vas a tener ahí.
- No es del todo gratis. Necesitas un proyecto de Google Cloud con la facturación activada. Hay un nivel de uso gratuito, pero el almacenamiento y las consultas por encima de él se cobran a tu proyecto.⁷
- Guarda todo para siempre, salvo que pongas una fecha de vencimiento a los datos.⁷ Eso es lo que quieres para el historial; también es la razón por la que la factura crece despacio con los años.
Cuál conviene, según el negocio
- Un sitio pequeño, unas decenas de páginas: la pantalla alcanza. Descarga una copia del informe de Rendimiento cada pocos meses para que no se te acabe el historial.
- Un sitio con cientos o miles de páginas: la API, manejada por alguien de tu equipo o del nuestro, te da la lista completa en vez de las primeras 1.000.
- Un sitio grande que vive de la búsqueda: activa la exportación masiva ya, aunque nadie la lea todavía. Es la única forma de tener, dentro de dos años, un historial completo con el que comparar.
Lo que hacemos en la auditoría a fondo
Nuestra auditoría a fondo lee el GSC del cliente a través de la API. El cliente agrega una dirección nuestra, una cuenta de servicio de Google, como usuario con permiso Restringido: el nivel más bajo de Google, que puede ver la mayoría de los datos y no puede cambiar la configuración, enviar sitemaps ni agregar usuarios.⁸ Nuestra clave le pide a Google solo acceso de lectura. El paso a paso está en cómo darle acceso a GSC a un auditor, solo de lectura.
Con ese acceso traemos, en una sola pasada, lo que la pantalla no puede mostrar en una sola vista: cada par de búsqueda y página de los últimos tres meses, no solo las primeras 1.000; los clics de cada página en los últimos tres meses, en los tres anteriores, en los mismos tres meses de hace un año y en los últimos doce; los clics diarios de los 16 meses completos; dispositivos, países y sitemaps; y el estado de indexación en Google de algunas páginas clave. Comparar esos periodos es como encontramos el día en que empezó una caída, qué búsquedas casi traen un clic y qué páginas se están apagando. Cuando termina el trabajo, el cliente quita nuestra dirección de la lista de usuarios.
Para quienes construyen
- Método:
searchanalytics.querysobre una propiedad;rowLimitde 1 a 25.000 (por defecto 1.000), ystartRowpara paginar.⁴ Detente cuando una respuesta llegue incompleta. - Datos frescos o finales:
dataStateesfinalpor defecto;allincluye los datos frescos, yhourly_allda el desglose por hora.⁴ - Cuotas: 1.200 consultas por minuto por sitio y por usuario; Inspección de URLs, 2.000 por día y 600 por minuto por sitio.⁹ Inspecciona las páginas clave, no todo el sitio.
- Consultas diarias: el patrón del propio Google es una consulta por día de datos, por tipo de búsqueda, que se mantiene dentro de la cuota.⁵ Córrela cada día y tienes tu propio historial, sin cuenta de facturación.
- Permiso de solo lectura: el alcance
webmasters.readonlybasta para listar propiedades y leer datos.¹⁰
Si quieres saber qué dicen tus propios datos de GSC, más allá de las primeras 1.000 filas, la auditoría a fondo los lee con acceso de solo lectura y los convierte en una lista ordenada de qué arreglar primero.
Notas. ¹ Google, “Depurar caídas del tráfico de la Búsqueda de Google” (el periodo de 16 meses). ² Google, “Informe ‘Rendimiento’ (resultados de la Búsqueda): solucionar discrepancias de datos” (1.000 filas, búsquedas anonimizadas, 2–3 días). ³ Google, “Depurar caídas del tráfico de la Búsqueda de Google” (para ir más allá de 16 meses, la API de Search Analytics o la exportación masiva). ⁴ Google, “Search Analytics: query”. ⁵ Google, “Obtén tus datos de rendimiento” (50.000 filas por día por tipo de búsqueda). ⁶ Google, “Acerca de la exportación de datos en bloque de Search Console a BigQuery”. ⁷ Google, “Iniciar una nueva exportación de datos en bloque”. ⁸ Google, “Gestionar propietarios, usuarios y permisos”. ⁹ Google, “Límites de uso”. ¹⁰ Google, “Sites: list”. ¹¹ Google, “Referencia y directrices de tablas”. Consultado el 26 de octubre de 2026.
Los ejemplos de este artículo vienen de proyectos reales. Datos del cliente reservados; cada cifra proviene de los datos del propio cliente.
Leer el caso de estudio →