Cualquier SEO conoce la interfaz de Search Console: escribes una URL en la barra de inspección, o exportas un informe de rendimiento, una propiedad cada vez. La API de Search Console promete levantar ese techo: los mismos datos oficiales, para miles de URLs, en todos los sitios que gestionas, al ritmo que tú decidas.
Lo difícil no es conseguir los datos. Es lo que Google te concede al día, y cómo se comporta ese límite en cuanto pasas de una sola propiedad. ¿Cuántas URLs puedes inspeccionar de verdad antes de que Google te frene? ¿La cuota se cuenta por cuenta o por sitio? ¿Y por qué un script que funciona para una propiedad se derrumba con veinte? Ahí es donde la API deja de ser una simple tubería y se convierte en un problema de ingeniería.
Lo que la API de Search Console te da de verdad
La API de Search Console es la puerta programática a los mismos datos oficiales que muestra la interfaz de Google Search Console: tu rendimiento en búsqueda y los veredictos de indexación de Google, devueltos como datos estructurados en lugar de pantallas. Te permite sacar esos datos en volumen, sobre cada una de tus propiedades verificadas, según un calendario que tú controlas, sin scrapear nunca una página de resultados. Su uso es gratuito, limitado por una cuota y no facturado.
Ese último punto es la razón de su valor para el trabajo SEO. La interfaz responde a una pregunta cada vez: una URL en la barra de inspección, un informe abierto para una propiedad. La API responde a las mismas preguntas para una lista, un sitio entero o una cartera de clientes. Todo lo que sigue trata de lo que puedes pedirle, de lo que eso cuesta en cuota, y del punto en que gestionar esa cuota tú mismo se convierte en el verdadero trabajo.
Las dos API que los SEO usan de verdad: Search Analytics y URL Inspection
Lo que llamamos «la API de Search Console» es en realidad una familia de métodos, y dos de ellos concentran casi todo el valor del día a día. Confundirlos, o cubrir solo uno, es la carencia más frecuente de las guías posicionadas sobre el tema.
La API de Search Analytics devuelve tus datos de rendimiento: clics, impresiones, CTR y posición media, desglosados por consulta, página, país, dispositivo y fecha. Va mucho más allá de los límites de exportación de la interfaz, lo que la convierte en la columna vertebral de la mayoría de flujos de informes y análisis SEO. Responde a las preguntas sobre cómo te posicionas ya.
La API de URL Inspection responde a una pregunta muy distinta: cómo indexa Google una URL concreta, ahora mismo. Para cualquier URL de una propiedad que posees, devuelve el veredicto («URL is on Google» o no), el estado de cobertura en las propias palabras de Google («Rastreada: actualmente sin indexar», «Detectada: actualmente sin indexar», «Excluida por la etiqueta noindex», y los demás), la canónica que tú declaras junto a la que Google eligió, la fecha y el user agent del último rastreo, los estados de robots.txt y de obtención, si hay un noindex en una etiqueta meta o en un encabezado HTTP, y los sitemaps y páginas de referencia que Google asocia a la URL. Es la versión legible por una máquina de la herramienta de inspección, que decodificamos campo a campo en nuestra guía completa de la herramienta de inspección de URLs.
Otros dos métodos completan la familia: la API de Sitemaps (enviar, borrar y leer el estado de tus sitemaps) y la API de Sites (añadir, quitar y listar tus propiedades). Útiles para la automatización, pero es con las dos anteriores donde se toman las decisiones SEO. La forma más sencilla de no confundirlas: Search Analytics habla de rendimiento, URL Inspection habla de indexación, y solo la segunda lleva los estados de cobertura de nuestro directorio completo de estados de indexación de Search Console.
La mecánica de las cuotas que nadie explica
Aquí es donde las guías se callan. Google documenta la cifra de titular, 2.000 inspecciones de URL al día por propiedad, y 600 por minuto, y ahí se detiene. La cifra es fácil de encontrar; cómo se comporta, no, y entenderla mal es desperdiciar un día de cuota. Cuatro propiedades de esa cuota, verificadas por nuestras propias pruebas, deciden lo que puedes hacer de verdad.
Primero, la cuota diaria es una ventana deslizante de 24 horas, no un reinicio a medianoche. La capacidad no reaparece de golpe al cambiar la fecha; se libera de forma progresiva, a medida que cada petición supera la marca de las 24 horas. Un análisis detenido en el límite a las 15 h no espera a medianoche para reanudarse: arranca poco a poco, cuando las peticiones de la mañana caducan.
Segundo, la cuota está ligada a la propiedad y compartida por todas las cuentas que la inspeccionan. No es una asignación por usuario. Dos personas, o dos herramientas, que inspeccionan la misma propiedad beben de los mismos 2.000, y conectar más cuentas de Google a esa propiedad no multiplica nada. Dos análisis lanzados en paralelo sobre el mismo sitio se privan el uno al otro, en silencio.
Además, una propiedad de dominio y las propiedades de prefijo de URL del mismo sitio tienen cuotas independientes. Una propiedad de prefijo verificada obtiene sus propios 2.000 inspecciones diarias: repartir un sitio grande entre una propiedad de dominio y N propiedades de prefijo lleva el techo a unos (N+1) × 2.000 al día. Esta palanca la conocen los usuarios avanzados, pero rara vez se plantea como un cálculo, y tiene su propio coste de gestión, sobre el que vuelven las secciones siguientes.
Por último, la API de Search Analytics funciona con una cuota distinta de la de URL Inspection. Sacar datos de rendimiento no consume tu presupuesto de inspección, y al revés también. Son dos grifos sobre dos contadores.
Una salvedad honesta atraviesa todo esto: nada de ello hace desaparecer el techo. Puedes gastar la cuota de forma más inteligente, repartirla entre propiedades, evitar malgastarla en páginas ya confirmadas, pero las ganancias son proporcionales a la parte de la lista ya resuelta. No hay ilimitado, ni instantáneo.
💡 En un solo sitio de unos miles de URLs, la cuota diaria ya reparte una inspección completa a lo largo de varios días. En una cartera de sitios de clientes, se convierte en un problema de planificación. Mira cómo lo resuelve nuestro comprobador de indexación Google en masa →
Lo que puedes construir con ella (sin escribir un scraper)
En cuanto puedes leer los datos de indexación por programa, se abre una serie de tareas que la interfaz sencillamente no sabe hacer a escala, y ninguna de ellas consiste en scrapear a Google.
Puedes hacer una auditoría de indexación en masa: pasar toda tu lista de URLs por el método de inspección y leer la distribución de los estados de cobertura, en lugar de revisar las páginas una a una. Puedes seguir la frescura del rastreo vigilando la fecha del último paso de Googlebot por todo el sitio, lo que revela dónde ha envejecido el rastreo y por qué una corrección puede seguir invisible. Puedes hacer detección de regresiones: reinspeccionar la misma lista a intervalos regulares y detectar las páginas que salieron del índice entre dos pasadas, a menudo la primera señal de que algo se rompió. Y puedes reconciliar rendimiento e indexación, cruzando los datos de Search Analytics con los resultados de inspección para distinguir «no posiciona» de «no está indexada», la distinción en el corazón de nuestra guía sobre por qué un sitio no aparece en Google.
Para un sitio pequeño inspeccionado una vez, un script corto hace todo esto. El problema es que la indexación no es una pregunta que se hace una sola vez, y pocos sitios son pequeños.
Cuando hacerlo a mano deja de escalar
Un script local que inspecciona 2.000 URLs de una propiedad, una vez, es un problema resuelto, y los tutoriales para desarrolladores posicionados sobre el tema lo resuelven bien. Los líos empiezan en cuanto el trabajo se parece a trabajo SEO de verdad.
En un sitio grande de decenas de miles de URLs, 2.000 inspecciones al día significan que una sola pasada completa tarda días. El script tiene entonces que conservar su estado entre ejecuciones, reanudarse dentro de la ventana deslizante a medida que se libera capacidad en vez de disparar a ciegas y quemar cuota en rechazos, y, para que valga la pena lanzarlo, saltarse las URLs ya confirmadas como indexadas para que el presupuesto vaya a las páginas que aún te enseñan algo. Ese solo paso de filtrado supone guardar un registro de lo que devolvió cada URL la vez anterior.
Es aún más duro en agencia. Gestionar varios sitios de clientes, grandes o no, son otras tantas propiedades, cada una con su cuota, su propia autorización OAuth, su propio calendario. Exprimir más capacidad de un cliente grande dividiéndolo en propiedades de prefijo, como mostró la sección de cuotas, multiplica la cuota y el número de presupuestos distintos que ahora tienes que orquestar. Mantener un historial por cliente para enseñar qué cambió de un mes a otro supone una base de datos, no una hoja de cálculo. Lo que empezó en cincuenta líneas de script es ya una pequeña infraestructura: un planificador que respeta una ventana deslizante, un almacén de resultados pasados, una regla de deduplicación, y un modelo multipropiedad y multicliente por encima.
Este es todo el propósito del artículo, y es donde una herramienta se gana su sitio. IndexProbe es esa orquestación construida una sola vez, sobre la API oficial: tú traes tu lista de URLs, y él lanza las inspecciones al ritmo de la cuota a lo largo de la ventana deslizante, retoma las páginas ya probadas como indexadas en vez de reinspeccionarlas, y conserva cada resultado para que puedas filtrar, segmentar, comparar análisis y exportar, sobre varias propiedades y varios clientes en un mismo sitio. No levanta el techo de Google, nada puede, pero gasta el presupuesto de 2.000 al día solo donde aporta información nueva, y absorbe la planificación, la deduplicación y la contabilidad multipropiedad que un script casero deja sobre tu mesa.
Prueba IndexProbe en acceso anticipado para convertir la API de Search Console en una auditoría de indexación sobre todas tus URLs, y todos tus sitios, de una vez.
Preguntas frecuentes
¿Cuántas URLs puedo inspeccionar al día con la API?
La API de URL Inspection está documentada en 2.000 consultas al día por propiedad y 600 por minuto. En la práctica, la asignación diaria se comporta como una ventana deslizante de 24 horas y no como un reinicio a medianoche: la capacidad se libera de forma progresiva, no de golpe.
¿La cuota es por cuenta de Google o por sitio?
Por propiedad, y compartida por todas las cuentas que la inspeccionan. Conectar más cuentas de Google a la misma propiedad no añade cuota. Lo que sí la añade es verificar propiedades de prefijo de URL del mismo sitio, ya que cada propiedad verificada lleva sus propios 2.000 al día, independientes.
¿Search Analytics y URL Inspection son la misma API?
Son dos métodos de la misma API de Search Console, con cuotas distintas y funciones opuestas. Search Analytics devuelve tus datos de rendimiento (clics, impresiones, posición); URL Inspection devuelve el veredicto de indexación y el estado de cobertura de Google para una URL dada. La mayoría de los proyectos SEO usan las dos, para preguntas distintas.
¿Hay que saber programar para usarla?
Para llamar a la API directamente, sí: es una interfaz para desarrolladores, a la que se accede con un lenguaje como Python o Node y una cuenta de Google autorizada. Si quieres los mismos datos oficiales sin escribir ni mantener un script, una herramienta construida sobre la API te da los resultados, el historial y la gestión multipropiedad sin el código.
¿Por qué no lanzar simplemente un script local?
Para una propiedad inspeccionada una vez, un script basta. Deja de escalar cuando una pasada completa tarda días (conservar el estado, reanudar dentro de la ventana deslizante, saltarse las URLs ya indexadas) o cuando gestionas varias propiedades o clientes a la vez, cada uno con su cuota y su historial. A esas alturas mantienes una infraestructura, no un script.
¿La API permite comprobar sitios que no poseo?
No. Como la interfaz, cada método exige una propiedad verificada. La API industrializa el trabajo sobre los sitios que controlas; no abre el acceso a los datos de Search Console de otra persona.