Los equipos que buscan una API de posicionamiento de Google normalmente quieren una cosa concreta: una llamada que devuelva en qué puesto está una página para una palabra clave. Google no publica eso.
Lo que Google publica es un conjunto de API que describen tu propio rendimiento, el estado de tu propio índice y tu propia situación de rastreo. Son genuinamente útiles y todas son gratuitas. También son estructuralmente incapaces de responder a la pregunta que la mayoría de la gente trae a esta búsqueda.
Pasamos un día midiendo qué devuelven realmente esas API en una propiedad en vivo, incluidas las partes que son fáciles de leer mal. Destacaron tres hallazgos: los datos llegan con tres días de retraso, el número de posición es una media que no se reproduce contra un resultado en vivo, y la única API que suena más a una comprobación de posiciones devuelve un veredicto que por sí solo no dice nada útil.
Qué publica Google en realidad
Cuatro superficies se confunden con una API de posicionamiento. Esto es para qué sirve cada una, según la propia documentación de Google.
La Search Analytics API devuelve clics, impresiones, CTR y posición media de una propiedad verificada. Es lo más parecido a datos de posicionamiento que ofrece Google, y es el origen de cada número de «posición media» en Search Console.
La URL Inspection API devuelve el estado de indexación de una sola URL: si Google la conoce, si está indexada y, si no lo está, por qué.
La Indexing API suena como si enviara páginas a indexación. La documentación de Google restringe sus tipos admitidos a datos estructurados JobPosting y BroadcastEvent, que es un caso de uso estrecho, no un envío general al índice.
La Custom Search JSON API devuelve resultados web para una consulta. Busca en un índice que configuras tú, y no te dice en qué puesto está tu sitio en los resultados principales de Google.
Ninguna de ellas devuelve «tu posición para esta palabra clave». Ese trabajo no existe en la línea de productos de Google, y la ausencia es deliberada, no un descuido. Google no tiene ninguna razón comercial para repartir datos de posiciones de competidores a escala.
Lo que medimos: los datos tienen tres días
Extraemos el desglose diario de nuestra propia propiedad el 12 de septiembre de 2026. La fecha más reciente con algún dato era el 9 de septiembre.
Fecha disponible | Filas devueltas |
|---|---|
2026-09-02 | sí |
2026-09-03 | sí |
2026-09-04 | sí |
2026-09-05 | sí |
2026-09-06 | sí |
2026-09-07 | sí |
2026-09-08 | sí |
2026-09-09 | sí, la más reciente |
Tres días de retraso, de forma constante. El parámetro window cuenta hacia atrás desde la fecha disponible más reciente y no desde hoy, lo cual es una pequeña trampa: una petición de siete días devuelve ocho fechas que terminan el 9 de septiembre, no el 12 de septiembre.
Para un informe mensual esto es irrelevante. Para la pregunta «¿el cambio que hice ayer en la página rompió algo?», es descalificante. Ninguna configuración lo arregla. El retraso está en el lado de Google del cable.
Lo que medimos: una posición media no es un puesto
Este es el hallazgo más importante, y es el que hace que la gente crea que existe una API de posicionamiento de Google y que se está mostrando esquiva.
La posición media es la posición media de tu URL en todas las impresiones del periodo, ponderada por países, dispositivos y variantes de consulta. Una comprobación de posición en vivo devuelve un número, desde una ubicación, en un dispositivo, en un instante. Son dos mediciones distintas que comparten un nombre.
Probamos la diferencia en 25 consultas extraídas de nuestros propios datos de Search Console, y después comprobamos esas mismas 25 palabras clave contra un SERP en vivo de Estados Unidos, en inglés, en escritorio, con profundidad 100.
Resultado | Recuento |
|---|---|
Consultas utilizables en ambos conjuntos | 23 |
Aparecieron en el top 100 en vivo | 14 (61%) |
Tenían impresiones en Search Console pero ningún resultado en vivo reproducible | 9 (39%) |
Mediana de la diferencia absoluta donde existían ambas | 7,4 posiciones |
Media de la diferencia absoluta | 8,5 posiciones |
Mayor diferencia | 36,6 posiciones |
A menos de 3 posiciones entre sí | 4 de 14 |
Con una diferencia superior a 10 posiciones | 4 de 14 |
Donde existen ambas mediciones, discrepan en una mediana de 7,4 posiciones.
Hay dos detalles que importan más que las medias.
Primero, nueve de las 23 consultas produjeron una posición en Search Console pero ningún resultado en vivo en la comprobación de Estados Unidos, inglés, escritorio. Eso no es un error. Las impresiones se acumulan desde otros países, otros idiomas, otros dispositivos y superficies de imagen o vídeo. Una comprobación única con enfoque geográfico no va a reproducirlas, y un equipo que trate los dos números como la misma medición pasará una semana persiguiendo una discrepancia que es un artefacto del método.
Segundo, la dirección no es consistente. La mayoría de las posiciones en vivo quedaron por debajo de la media de Search Console, que es lo que cabría esperar cuando la media incluye superficies con mejor rendimiento. Pero una consulta se movió 36,6 posiciones en sentido contrario, de 73,6 a 37. No hay ningún factor de corrección que aplicar.
La diferencia va en ambos sentidos, así que no hay factor de corrección que aplicar.
La consecuencia práctica para quien está eligiendo una API de posicionamiento de Google: los datos gratuitos no te dirán un puesto, y los datos de pago no coincidirán con ellos. Ambos son mediciones correctas de cosas distintas. Tratar cualquiera de los dos como sustituto del otro es donde el informe empieza a fallar.
Donde el lado de datos propios es genuinamente insustituible es en la cobertura, que medimos por separado en la comparación de alternativas a la API de SERP.
Qué devuelve en su lugar la URL Inspection API
La URL Inspection API es la única superficie de Google que se siente como una comprobación de posiciones, porque le entregas una URL sin palabra clave y te devuelve un estado. Probamos dos URL.
Estado de la URL | Veredicto | Estado de cobertura | Hora del último rastreo |
|---|---|---|---|
Publicada hace aproximadamente una hora | NEUTRAL | URL desconocida para Google | Desconocida |
Publicada hace aproximadamente nueve horas | NEUTRAL | Descubierta, actualmente sin indexar | Desconocida |
Ambas devolvieron el mismo veredicto. El campo que realmente diferencia los dos casos es la cadena de estado de cobertura, que es una frase, no un enumerado. El campo de veredicto dice NEUTRAL tanto para una URL que Google nunca ha visto como para una URL que ha descubierto pero no ha indexado.
Es una API utilizable y una señal de monitorización pobre por sí sola. Si quieres una alerta cuando una página no está indexada, analiza el estado de cobertura en lugar del veredicto, y cuenta con que la hora del último rastreo falte justo en las URL que más te importan.
Las cuatro superficies y el trabajo que ninguna hace
Pregunta | Superficie de Google | Respuesta |
|---|---|---|
Cómo rendí para esta consulta la semana pasada | Search Analytics API | Sí, con tres días de retraso, promediado |
Esta URL está indexada | URL Inspection API | Sí, por URL, bajo petición |
En qué puesto estoy ahora para cualquier palabra clave | ninguna | No |
En qué puesto están mis competidores | ninguna | No |
Cómo es el SERP de una palabra clave para la que no posiciono | ninguna | No |
El patrón es consistente. Las API de Google describen tu propiedad desde dentro. Una pregunta de posicionamiento se hace desde fuera, sobre una página de resultados, y Google no sirve eso.
Cómo cubrir el hueco sin pagar de más
La configuración práctica son dos fuentes con trabajos distintos, no una fuente a la que se le piden las dos cosas.
Usa las API de Google como verdad base sobre tu propia propiedad. Los clics, las impresiones y el estado de indexación son hechos de primera parte que no puedes obtener en ningún otro sitio, y son gratuitos. Extráelos según un calendario y trata el retraso de tres días como una propiedad del instrumento.
Usa una fuente de SERP para la visión externa. Posiciones en vivo, posiciones de competidores y palabras clave para las que todavía no posicionas. Esta es la parte de pago, y es más barata de lo que la mayoría de los equipos supone: en nuestra prueba, comprobar 23 palabras clave con profundidad 100 costó $0,2975, es decir $0,0129 por comprobación.
No intentes reconciliar los dos números. Miden cosas distintas. El movimiento útil es leerlos juntos: Search Console te dice qué ocurrió, y una comprobación en vivo te dice qué está ocurriendo. Cuando no coincidan, mira la composición de países y dispositivos de esa consulta antes de concluir nada.
La mecánica de ejecutar ambos desde un solo script está en nuestro rastreador de dos fuentes, y el lado de coste de la mitad en vivo está valorado en la prueba de comprobación masiva.
Preguntas frecuentes
¿Tiene Google una API de posicionamiento oficial? No. Google publica API para tu propio rendimiento de búsqueda (Search Analytics), el estado de indexación (URL Inspection) y dos tipos estrechos de envío (Indexing). Ninguna devuelve un puesto para una palabra clave.
¿Por qué Search Console muestra una posición si no hay API de posicionamiento? Porque la posición media es una métrica de rendimiento calculada a partir de tus impresiones, no una consulta de puestos. Es la posición media en todas las impresiones del periodo, promediada entre países, dispositivos y superficies.
¿Cuánto se retrasan los datos de Search Console? Tres días en nuestra medición del 12 de septiembre de 2026, con la fecha disponible más reciente siendo el 9 de septiembre. El parámetro window cuenta hacia atrás desde esa fecha, así que una petición de siete días devuelve ocho fechas que terminan en el día disponible más reciente.
¿Puede la URL Inspection API decirme si una página está indexada? Sí, y es la herramienta adecuada para ese trabajo. Lee la cadena de estado de cobertura en lugar del campo de veredicto, porque el veredicto devuelve NEUTRAL tanto para una URL desconocida como para una URL descubierta pero sin indexar.
¿Es la Custom Search JSON API una API de posicionamiento? No. Devuelve resultados de un motor de búsqueda que configuras tú, no tu posición en los resultados principales de Google.
¿Cuál es la forma más barata de obtener datos reales de posiciones? Comprueba el conjunto más pequeño de palabras clave sobre el que realmente actúas, con la profundidad que corresponde a donde posicionas. Las comprobaciones con profundidad 10 costaron $0,002 por palabra clave en nuestra prueba y con profundidad 100 costaron $0,014, así que la configuración de profundidad mueve la factura siete veces más que el número de palabras clave.
Visión de Auspia: la respuesta honesta a «¿existe una API de posicionamiento de Google?» es no, y el siguiente paso útil es dejar de buscarla. Las API de Google responden bien a preguntas de primera parte y no pueden responder a preguntas de posicionamiento en absoluto. Reserva un importe pequeño para la visión externa y dedica el resto del esfuerzo a la parte que Google no va a hacer por ti, que es decidir qué cambiar cuando los dos números no coinciden.
Autoría: Gabriel Finch, investigador de recuperación de búsqueda, con revisión de más de 1.200 respuestas de IA en Auspia. Escribe sobre infraestructura de búsqueda, sistemas de recuperación y qué puede ver realmente cada fuente de datos.
