API de indexación de Google explicada: la solución en GSC que debes probar primero

La API de indexación de Google (Google Indexing API) te permite avisar directamente a Google de que una página es nueva, se ha actualizado o se ha eliminado. Google añade entonces la URL a una cola de rastreo prioritaria, en lugar de esperar a descubrir el cambio por su cuenta. La API acelera el rastreo, pero no garantiza nada sobre la indexación. Si una página muestra "Discovered, currently not indexed", prueba primero la herramienta gratuita de inspección de URLs de Search Console.

Qué hace y qué no hace la API

Le envías a Google una URL junto con un tipo de notificación: URL_UPDATED o URL_DELETED. Google pone la URL en cola para rastrearla con mayor prioridad que su calendario habitual basado en sitemaps, y el rastreador aún tiene que visitar la página y decidir si merece un lugar en el índice.

Hay varias cosas que quedan fuera de lo que la API puede hacer:

• No puede indexar una URL directamente ni anular las señales de calidad de Google, así que una página con poco contenido o duplicada no entrará más rápido.
• No influye en el posicionamiento, porque solo afecta al rastreo.
• No sustituye a tu sitemap, que debe seguir llevando la mayor parte de tus URL.
• No tiene soporte oficial para todos los tipos de contenido. En la práctica acepta otras URL, pero Google no ha prometido que esto vaya a seguir funcionando.

El error más extendido es creer que un envío correcto significa que la página se indexará. La API consigue que Google se fije antes en la página, pero nada en ella hace que Google quiera esa página.

Primero, mira el problema: simula Googlebot

Antes de tocar Search Console o cualquier API, comprueba qué ve Googlebot cuando visita la página. Muchos problemas de "indexación" son en realidad problemas de renderizado o de bloqueo: una etiqueta noindex que se dejó puesta por error, una regla de robots.txt o contenido en JavaScript que nunca se carga para un rastreador.

Pasa la página por el Googlebot Simulator gratuito. Te muestra el HTML renderizado, los códigos de estado y cualquier directiva de bloqueo tal como las encuentra el rastreador de Google. Si aparece una etiqueta noindex o un recurso bloqueado, corregirlo te servirá más que cualquier llamada a la API.

Primero, soluciónalo dentro de Google Search Console

Para casi cualquier queja del tipo "mi página no se indexa", las herramientas propias de Search Console son el mejor punto de partida. La secuencia siguiente cubre todo el proceso.

Paso 1: inspecciona la URL

Abre Google Search Console, selecciona tu propiedad y pega la URL afectada en la herramienta de inspección de URLs, en la parte superior de la página. Te dice si la URL está en Google, si existe una versión rastreada y qué URL canónica ha elegido Google.

Paso 2: lee el estado con atención

El estado de cobertura que muestra Search Console te indica qué hacer a continuación.

Estado en Search Console	Qué significa	Qué hacer
Submitted and indexed	La página está activa en el índice de Google	No hace falta hacer nada
Crawled, currently not indexed	Google la visitó, pero decidió no indexarla	Mejora la calidad del contenido y revisa si hay duplicación
Discovered, currently not indexed	Google conoce la URL, pero todavía no la ha rastreado	Solicita la indexación; en sitios grandes, revisa el presupuesto de rastreo
URL is unknown to Google	Nunca la ha visto	Envíala mediante el sitemap y solicita la indexación
Blocked by robots.txt	Se le ha prohibido el acceso al rastreador	Edita el archivo robots.txt
Alternate page with proper canonical tag	Google indexó como canónica una URL distinta	Revisa si hay contenido duplicado o casi duplicado

Paso 3: solicita la indexación

Si la inspección muestra que la página no está indexada, haz clic en Solicitar indexación (Request Indexing). Google pone la URL en cola para un rastreo prioritario, de forma muy parecida a como lo hace con la API, y la opción es gratuita y está en la consola que ya usas.

Paso 4: vuelve a comprobar y no satures

Espera unos días antes de volver a solicitarlo para la misma URL. Las solicitudes repetidas sobre una misma página no aceleran nada y pueden parecer manipulación a los sistemas de Google.

Cuándo basta con Google Search Console y cuándo no

Search Console basta en estos casos:

• Tienes una página, o unas pocas, atascadas en "Discovered, currently not indexed".
• Acabas de publicar algo y quieres que se revise más rápido.
• Tu sitio tiene unos cientos o unos miles de URL, muy dentro del presupuesto de rastreo normal.

Necesitas algo más, ya sea la API de indexación o un servicio basado en ella, en estos casos:

• Gestionas un portal de empleo o un sitio de eventos con páginas que cumplen los requisitos de los tipos de esquema JobPosting o BroadcastEvent, que la API admite oficialmente.
• Gestionas un sitemap grande, con decenas de miles de URL, en el que las páginas nuevas quedan enterradas durante semanas antes de que llegue el rastreo programado de Google. Un caso documentado fue el de una tienda online con 80.000 URL de producto en la que las fichas nuevas esperaban unas dos semanas hasta el primer rastreo, y enviarlas a través de la API redujo ese plazo a menos de seis horas.
• Estás migrando de dominio y necesitas que Google abandone rápido una canónica antigua. Un bloguero que pasó de un subdominio de GitHub Pages a un dominio propio comprobó que las solicitudes manuales en Search Console no cambiaron la elección de canónica de Google en 30 días, y esa es parte de la razón por la que algunos desarrolladores automatizan los envíos masivos con scripts.
• Necesitas ejecutar el proceso a diario y no una sola vez.
• Quieres que las eliminaciones se reconozcan rápido. Las notificaciones URL_DELETED son una forma limpia de decirle a Google que una oferta caducada o un producto retirado ya no existe.

Si ninguno de estos casos encaja con el tuyo, quédate con la vía gratuita. Montar la autenticación de la API para una sola entrada de blog atascada es mucha ingeniería para un problema que Search Console resuelve con dos clics.

Cómo funciona la API, explicado sin tecnicismos

Si cumples los requisitos para el enfoque más pesado, la configuración consta de cinco pasos, y ninguno requiere código hasta el último.

1. Crea un proyecto de Google Cloud y activa en él la API de indexación.
2. Crea una cuenta de servicio y descarga su clave privada, que es un archivo JSON.
3. Añade esa cuenta de servicio como propietario (Owner) en los permisos de usuario de tu propiedad de Search Console. Casi todo el mundo se equivoca en este paso la primera vez, y si te lo saltas, todas las llamadas a la API devuelven un error 403.
4. Espera a que se propaguen los permisos, lo que puede tardar desde unos minutos hasta unas horas antes de que las llamadas empiecen a funcionar.
5. Envía las URL con un tipo de notificación URL_UPDATED o URL_DELETED, autenticadas con un token OAuth obtenido a cambio de tu clave privada.

Un script que hace esto suele tener las mismas partes: un módulo de autenticación que carga la clave, una función que envía una URL y reintenta si falla, y un bucle principal que lee las URL de tu sitemap y las envía sin superar la cuota diaria.

Cada proyecto recibe una cuota predeterminada de 200 solicitudes de publicación al día, en la que se cuentan juntas las actualizaciones y las eliminaciones, además de 180 solicitudes de metadatos y 380 solicitudes en total por minuto. El límite diario se restablece a medianoche, hora del Pacífico. Una actualización de la documentación de octubre de 2026, publicada por Search Engine Journal, eliminó el formulario de solicitud de aprobación y los pasos para pedir una cuota mayor, y Google no aclaró si el propio requisito de aprobación había cambiado. Si estás planificando en torno a un aumento de cuota, consulta la página de cuotas actual de la consola de API de Google en lugar de guías antiguas.

Varias herramientas comerciales envuelven esta misma API en un panel para que no tengas que escribir el código de autenticación. Suelen cobrar una cuota mensual o por proyecto y anuncian tiempos medios de indexación de un par de minutos, aunque los resultados siguen dependiendo de la cola de rastreo de Google y de la calidad de la página.

Cuándo la API no es la herramienta adecuada

Descártala para contenido perenne, para páginas que Google ya ha rastreado y rechazado, y para cualquier sitio donde un sitemap limpio y unos enlaces internos sólidos ya consigan que las URL nuevas se recojan en un plazo razonable. Para esos sitios, las alternativas son un sitemap enviado en Search Console y la solicitud manual de indexación para alguna página puntual. Un sitemap es la vía principal de descubrimiento de tus URL en bloque, mientras que la API es un carril prioritario para páginas concretas.

Errores comunes que debes evitar

• Dar por hecho que enviar equivale a indexar. La API pone un rastreo en cola y no promete ningún resultado, así que una página con poco contenido o duplicada no se indexará más rápido por haberla enviado.
• Saltarte el paso de la propiedad en Search Console. La cuenta de servicio debe ser propietaria (Owner) de la propiedad, no un usuario normal, o todas las llamadas fallan con un 403.
• Usarla con contenido fuera de los tipos admitidos y esperar la fiabilidad que Google promete para las ofertas de empleo y los eventos retransmitidos.
• Solicitar la indexación de la misma URL en Search Console varias veces en pocas horas.
• Tratar la API como un sustituto del sitemap.
• Subir la clave JSON de la cuenta de servicio a un repositorio público. Trátala como una contraseña.

Si una página sigue sin indexarse hagas la solicitud que hagas, la causa suele ser la calidad del contenido o la duplicación, y no la velocidad de rastreo. Una herramienta gratuita para confirmar el posicionamiento de las palabras clave antes de suponer que la indexación es el cuello de botella puede ayudarte a comprobarlo.

Preguntas frecuentes

¿La API de indexación de Google garantiza que mi página se indexe?

No. Avisa a Google de que una URL ha cambiado y le pide un rastreo prioritario. El rastreador de Google sigue visitando la página y aplica sus comprobaciones habituales de calidad y relevancia antes de decidir si la indexa.

¿Puedo usar la API de indexación para cualquier tipo de página?

Oficialmente, Google dice que la API admite páginas con datos estructurados JobPosting o BroadcastEvent. Mucha gente envía otros tipos de URL y comprueba que se aceptan, pero Google no se ha comprometido a que eso siga funcionando de forma fiable en el futuro.

¿Cuál es el límite diario de la API de indexación?

El valor predeterminado es de 200 solicitudes de publicación al día por proyecto, que incluye tanto actualizaciones como eliminaciones, con un tope por minuto de 180 solicitudes de metadatos. El recuento diario se restablece a medianoche, hora del Pacífico.

¿Por qué la API devuelve 403 Forbidden?

La causa habitual es que la cuenta de servicio no se ha añadido como propietaria (Owner) de la propiedad en Search Console. Los permisos también pueden tardar entre unos minutos y unas horas en propagarse, así que una llamada hecha justo después de la configuración aún puede fallar.

¿Puede la API obligar a Google a volver a rastrear una página?

Pide un rastreo prioritario, y es Google quien decide qué ocurre después. Que Google rastree una página no lo obliga a indexarla.

¿Solicitar indexación en Search Console es lo mismo que la API de indexación?

Ambas meten una URL en una cola de rastreo prioritario. Solicitar la indexación es gratis, manual y está integrado en la consola que ya usas, mientras que la API automatiza el mismo tipo de solicitud para muchas URL.

¿En qué se diferencia la API de enviar un sitemap?

Un sitemap enumera tus URL para que Google las rastree según su propio calendario y sigue siendo la vía principal para la mayor parte de tus páginas. La API empuja URL individuales, como las nuevas o las eliminadas, hacia una cola más rápida.

¿Por qué Google dice "Discovered, currently not indexed" aunque haya solicitado la indexación?

Lo normal es que Google esté dando baja prioridad a la página por el presupuesto de rastreo, por la calidad del contenido que percibe o por su parecido con otras páginas de tu sitio. Corregir la página de fondo suele ser más eficaz que enviarla una y otra vez.

Habla con el equipo

Perseguir una sola URL atascada en Search Console lleva unos cinco minutos. Perseguir problemas de indexación en todo un sitio, semana tras semana, es un mal uso de las llamadas a la API lanzadas a mano. Si quieres tener una imagen clara de qué páginas están indexadas, cuáles están atascadas y por qué, habla con el equipo y recibe un informe de muestra elaborado a partir de tu propio sitio.

Fuentes

• Google API Instant Indexing Services
• Bulk request Google search indexing with API
• Google Indexing API in Python: Auth, Quotas, and Working ...
• Google's Indexing API Docs No Longer Explain How To ...
• Google Indexing API tool: Index pages on Google