Cómo comprobar la posición de una palabra clave con la API de Google (guía 2026)

Intentar comprobar la posición de una palabra clave con una API de Google es una de esas tareas que parecen un problema resuelto hasta que uno lo intenta de verdad. No existe ningún endpoint rankings.get(), y las dos API de Google a las que se recurre primero responden cada una a una pregunta ligeramente distinta de la planteada. La documentación de Search Analytics de Search Console es el punto de partida adecuado, siempre que entienda qué significa ahí «posición».

¿Tiene Google una API oficial de posicionamiento de palabras clave?

No. Google nunca ha publicado una API que acepte una palabra clave y devuelva su posición en directo en google.com. Es deliberado: las consultas automatizadas de la página de resultados están prohibidas por las condiciones de Google, y la empresa no tiene ningún interés comercial en ofrecer infraestructura de seguimiento de posiciones.

Lo que existe en su lugar son tres vías parciales, cada una con un límite claro:

¿Cómo obtengo las posiciones de palabras clave con la API de Search Console?

Consulte el endpoint searchAnalytics con la dimensión query y lea el campo position. Son datos de primera mano directamente de Google, gratuitos y sin límite de palabras clave: obtiene todas las consultas para las que su sitio ha recibido impresiones.

La petición que funciona, en Python:

from google.oauth2 import service_account
from googleapiclient.discovery import build

creds = service_account.Credentials.from_service_account_file(
    "service-account.json",
    scopes=["https://www.googleapis.com/auth/webmasters.readonly"],
)
service = build("searchconsole", "v1", credentials=creds)

response = service.searchanalytics().query(
    siteUrl="https://example.com/",
    body={
        "startDate": "2026-07-01",
        "endDate": "2026-07-31",
        "dimensions": ["query", "page"],
        "rowLimit": 25000,
    },
).execute()

for row in response.get("rows", []):
    query, page = row["keys"]
    print(f"{row['position']:.1f}  {query}  ->  {page}")

Las tres limitaciones que pillan desprevenido a cualquiera

• La posición es una media, no un puesto. Un valor de 7,4 no significa que esté en la posición 7, sino que las impresiones se repartieron entre posiciones con una media de 7,4, quizá entre la 3 y la 15 según dispositivos y ubicaciones.
• Solo su sitio. No hay forma de ver la posición de un competidor. Search Console es, por diseño, una API limitada a la propiedad.
• Las palabras clave sin impresiones son invisibles. Si posiciona en el puesto 60 y nadie ha bajado tanto, la consulta ni siquiera aparece en los datos.

Ese tercer punto es el que arruina los informes sin que nadie se dé cuenta. Una palabra clave con la que aún no ha llegado a las primeras páginas simplemente no existe en Search Console, lo que hace imposible medir el progreso de la posición 60 a la 20 solo con esta API.

¿Puedo usar la Custom Search JSON API para comprobar posiciones?

Técnicamente sí, en la práctica no. La Custom Search JSON API exige crear primero un Programmable Search Engine. Incluso configurado para buscar en toda la web, aplica su propio orden y sus propias restricciones, así que el orden que devuelve no es el de google.com.

Además, en el nivel gratuito está limitada a 100 consultas al día, y el uso de pago se factura por cada mil consultas con un tope diario. Para un puñado de palabras clave revisadas de vez en cuando es viable. Como herramienta de seguimiento de posiciones produce cifras que parecen fiables y que en realidad son erróneas, lo que es peor que no tener datos.

¿Y hacer scraping de Google directamente?

No lo haga. Consultar Google Search de forma automatizada sin permiso va en contra de las Condiciones del Servicio de Google, y con cualquier volumen provoca bloqueos de IP y muros de CAPTCHA. Más allá de la cuestión normativa, la realidad técnica es poco grata: los resultados están personalizados, localizados y cada vez más construidos con funciones de IA, de modo que una «posición» obtenida por scraping varía según el centro de datos, la ubicación y la sesión aunque nada haya cambiado en su sitio.

Si necesita las posiciones de la competencia, una API SERP comercial es la vía que es a la vez legal según los acuerdos del propio proveedor y estable en la operación. Es una partida de gasto, y ese coste es el precio honesto de unos datos que Google no regala. Las empresas que necesitan construir y supervisar este flujo sin contratar personal interno suelen recurrir a un especialista; nuestra comparativa de las 10 mejores agencias de analítica de datos en Francia recoge proveedores que configuran este tipo de informes.

¿Qué debería construir realmente?

Para la mayoría de los equipos, la arquitectura más pragmática es híbrida, y se ve así:

• La API de Search Console como columna vertebral. Gratuita, con palabras clave ilimitadas, de primera mano y la única fuente que le dice para qué está obteniendo impresiones realmente.
• Una API SERP para un conjunto reducido y seleccionado de palabras clave. Sus veinte o treinta términos comercialmente críticos, revisados a diario, incluidas las posiciones de la competencia.
• Una capa de visibilidad en la IA. Cada vez más, la pregunta no es solo «¿en qué posición estoy?», sino «¿me citan cuando alguien pregunta a un asistente de IA?». Las API de posicionamiento clásicas no responden a nada de eso.

Los equipos que prefieren no diseñar esto por su cuenta suelen confiarlo a un especialista; nuestra comparativa de las 10 mejores agencias SEO en Francia presenta proveedores que gestionan este conjunto de informes para sus clientes.

Ese último punto no es una preocupación de futuro. Cuando una respuesta de la IA resuelve la consulta en la propia interfaz, la posición diez y la posición tres llegan al mismo resultado: ningún clic. Seguir las citas junto a las posiciones es precisamente para lo que están pensados nuestro servidor MCP de Search Console y nuestra plataforma de visibilidad en la IA, y la documentación explica la configuración de principio a fin.

Conclusión

No existe ninguna API oficial de Google para posiciones de palabras clave en directo: use la API de Search Console para sus propios datos promediados, una API SERP de terceros para posiciones exactas y de la competencia, y descarte por completo la Custom Search JSON API para el seguimiento de posiciones. Apoyarse en la API equivocada es el error más habitual, y da como resultado un panel que se equivoca con total seguridad.

Si prefiere no construir ni mantener ese flujo usted mismo, Sorank conecta su Search Console y sigue las citas en la IA en un solo lugar.