La API de Search Console ya separa las consultas de marca, mide Google Lens y filtra varios países en una sola petición

Si te gusta mi contenido, dile a Google que te lo muestre antes:

Google anunció el 16 de noviembre de 2026 tres novedades en la Search Analytics API de Search Console: la dimensión brandedClassification para separar consultas de marca y sin marca, el tipo webMultimodal para el tráfico de Google Lens y Circle to Search, y el campo filterLists para pedir varios países o dispositivos a la vez. La clasificación de marca la hace un sistema interno de Google asistido por IA, solo para propiedades elegibles y con datos desde el 21 de febrero de 2026.

Consultas de marca y sin marca en la Search Analytics API con brandedClassification

El anuncio lo firman Daniel Waisberg, Nati Yosephian y Karin Gadasi, del equipo de Search Console, y lo presentan como respuesta a lo que pedía el sector, «following ecosystem requests to make this data available for custom reporting and automated workflows». Las tres funciones ya estaban en la interfaz y ahora se pueden pedir por API, que es lo que alimenta los cuadros de mando propios, los conectores de terceros y las automatizaciones.

El filtro de marca llegó a la interfaz el 20 de noviembre de 2025 como «Branded queries» y «Non-branded queries», con un despliegue gradual que Google dio por completado el 11 de marzo de 2026. En la API es una dimensión nueva llamada brandedClassification, con los valores BRANDED y NON_BRANDED, que sirve tanto para agrupar como para filtrar y solo admite el operador equals.

Captura del informe de Rendimiento de Search Console con el diálogo de filtro de consultas abierto y tres opciones: por palabra clave, consultas de marca y consultas sin marca, estas dos con la etiqueta New
El filtro de consultas de marca en la interfaz de Search Console, el mismo dato que ahora sale por API. Fuente: Google Search Central.

La referencia de la API pone tres límites. Hay datos desde el 21 de febrero de 2026, no desde el lanzamiento del filtro en noviembre de 2025, y Google no explica por qué. Solo se calcula para propiedades de nivel superior con «sufficient query and impression volume», un umbral que no publica, y si la propiedad no es elegible «the response won't include any rows», sin error. Y no se puede combinar con un filtro query en la misma petición.

La clasificación no es una lista de términos. Según el anuncio de 2025, la decide «an internal, AI-assisted system» que incluye el nombre de marca en cualquier idioma, sus erratas y consultas sin el nombre que apuntan a un producto exclusivo del sitio. Google avisa de que «some queries may occasionally be misidentified», no publica los criterios y no hay forma de corregir una consulta mal clasificada. El post del 16 de noviembre lo plantea como alternativa a «maintaining complex keyword regex lists», el método que se usaba hasta ahora con una Regex SEO propia (Expresiones Regulares (Regex) SEO: ¿Qué son? Usos Prácticos).

El tipo webMultimodal: Google Lens y Circle to Search en la API

El segundo cambio es un valor nuevo del parámetro type. La referencia define webMultimodal como «Search results from Google Lens, Circle to Search on Android, and image uploads in Google Search», y es el mismo tráfico que Search Console separó en la interfaz el 24 de septiembre (Search Console separa en «Multimodal» el tráfico de Lens y Circle to Search, y son datos que antes no contaba). En aquella pieza la API no aparecía, y ahora sí.

Hay dos diferencias con la interfaz. El post de septiembre incluía también la opción «Search this image» de Chrome, que ni el anuncio ni la referencia de la API mencionan. Y la documentación no dice desde qué fecha hay datos de webMultimodal ni si el tipo web lo incluye o lo deja fuera, cuando en la interfaz Multimodal aparece como subopción de Web, junto a «Text-based».

filterLists: varios países o dispositivos en una sola petición

La tercera novedad es el campo filterLists, dentro de dimensionFilterGroups. Acepta una dimensión y una lista de valores, y una fila pasa si coincide con cualquiera de ellos. Solo funciona con country y device: países en código ISO 3166-1 de tres letras y dispositivos DESKTOP, MOBILE o TABLET. Una misma dimensión no puede ir a la vez en filters y en filterLists.

La interfaz ya permitía elegir varios países desde el 6 de octubre de 2026 y varios dispositivos desde principios de noviembre. En la API, hasta ahora, sacar el total de España, México y Argentina obligaba a hacer una petición por país y sumar después. Con el formato documentado, la petición queda así (ejemplo propio con la sintaxis de la referencia, no un ejemplo de Google):

"dimensions": ["brandedClassification", "page"],
"type": "web",
"dimensionFilterGroups": [{
  "filterLists": [
    { "dimension": "country", "expressions": ["esp", "mex", "arg"] },
    { "dimension": "device", "expressions": ["MOBILE", "TABLET"] }
  ]
}]

El resto de límites no cambia. rowLimit sigue entre 1 y 25.000 filas por petición y la API sigue devolviendo las filas principales, no todas («does not guarantee to return all data rows but rather top ones»).

BigQuery y Looker Studio: lo que Google no ha confirmado

El anuncio dice que el tipo multimodal «will also be available» en la exportación masiva a BigQuery, sin fecha. A 17 de noviembre, la referencia de tablas de esa exportación sigue listando solo seis tipos de búsqueda (web, image, video, news, discover y googleNews) y no tiene ningún campo de marca. De brandedClassification en BigQuery no se dice nada.

Tampoco hay nada sobre el conector de Looker Studio, ni en el post de Google ni en la cobertura de Search Engine Roundtable y PPC Land. Como el histórico de marca empieza el 21 de febrero de 2026, la comparación interanual con este dato no será posible hasta finales de febrero de 2027.