ES · EN

11 de septiembre de 2026

Indexing API: No Malgastes Cuota en Páginas JavaScript

Developer reviewing rendered page request flow

La Indexing API le dice al rastreador de Google que revise una URL más pronto enviando una señal URL_UPDATED o URL_DELETED, pero Google restringe su uso oficial a páginas de JobPosting y BroadcastEvent. Una llamada exitosa mueve tu página hacia el frente de la fila de rastreo. No fuerza la indexación, no garantiza posicionamiento ni se salta los controles de calidad de Google. La API tiene una cuota diaria por defecto, y una respuesta 200 solo confirma que Google recibió la notificación.

En resumen:

  • Las solicitudes URL_UPDATED de la Indexing API solo le piden a Google que vuelva a rastrear páginas; no garantizan la indexación ni se saltan los controles de calidad, sobre todo fuera de las páginas de JobPosting y BroadcastEvent.
  • Una configuración correcta requiere habilitar la API, verificar la propiedad del sitio, crear y asegurar una cuenta de servicio, y hacer pruebas en un entorno de staging antes de usarla en producción para evitar problemas de cuota y filtraciones.
  • Las llamadas se hacen con una simple solicitud POST, y se pueden agrupar hasta 100 URLs, pero las respuestas solo confirman el acuse de recibo, no el éxito real de la indexación o el rastreo.
  • Asegurarte de que las páginas estén completamente renderizadas y libres de esquemas o etiquetas que bloqueen es clave antes de enviarlas, en especial para sitios cargados de JavaScript que dependen del renderizado del lado del servidor o del prerenderizado.
  • La API premia principalmente a las páginas bien preparadas; no puede arreglar problemas del servidor o del código, ni garantizar la indexación, así que resulta inútil si la salud técnica de base del sitio es pobre.

Tabla de Contenidos

Qué hace realmente la Instant Indexing API

Cada solicitud se reduce a dos acciones: URL_UPDATED le avisa a Google que una página cambió y que debe volver a rastrearla, y URL_DELETED le dice a Google que descarte una URL que ya conoce. Cada llamada devuelve un dato llamado UrlNotificationMetadata, que muestra la última notificación que Google registró para esa URL y su estado, no si la página llegó al índice.

Google creó esto específicamente para páginas que se vuelven obsoletas rápido. La guía de inicio rápido de la Indexing API deja claro el alcance para el que fue pensada:

Ese último punto hace tropezar a muchos desarrolladores. La API aceptará una notificación de una entrada de blog o de una página de producto. Simplemente, Google no está obligado a tratarla como una señal prioritaria, y usarla mal a gran escala puede marcar tu cuenta de servicio para revisión. Una solicitud de rastreo no es lo mismo que una decisión de renderizado, y el renderizado no es lo mismo que la indexación. Son tres pasos distintos, y la API solo acelera el primero.

Requisitos previos y checklist de configuración rápida

Antes de escribir una sola línea de código de solicitud, deja bien conectada la parte de las cuentas. Saltarte un paso aquí es la razón más común por la que los desarrolladores reciben un 200 limpio y no pasa nada.

  1. Habilita la Indexing API en Google Cloud Console y confirma que tu proyecto solicita el scope de OAuth https://www.googleapis.com/auth/indexing.
  2. Crea una cuenta de servicio bajo ese proyecto y descarga la clave JSON. Guárdala fuera de tu repositorio, idealmente en un gestor de secretos, nunca en código del lado del cliente.
  3. Verifica la propiedad del sitio en Search Console y agrega el correo de la cuenta de servicio como propietario o usuario con permisos completos en la propiedad.
  4. Prueba primero en una propiedad de staging antes de apuntar el script a producción, para que un esquema mal configurado o un error de autenticación no te queme la cuota.
  5. Solicita más cuota a través del proceso de la guía de inicio rápido de la Indexing API si tu volumen de JobPosting o BroadcastEvent supera con regularidad el límite por defecto.

Tip Pro: Rota la clave de la cuenta de servicio al menos una vez por trimestre, y ponte un recordatorio en el calendario. Las claves viejas olvidadas en scripts son la fuente más común de filtraciones accidentales.

Cómo llamar a la Indexing API: endpoints y solicitudes por lotes

Una sola notificación se envía a un endpoint con un payload JSON pequeño:

Eso es toda la solicitud para una sola URL. Según la documentación de la Indexing API de Google, también puedes combinar hasta 100 llamadas individuales en una sola solicitud multipart contra el endpoint /batch, lo que reduce la sobrecarga de conexión si estás publicando un lote de vacantes de golpe. Cada parte dentro del lote refleja el formato de solicitud individual, y Google devuelve una respuesta separada para cada parte, así que un fallo en una no necesariamente hace fallar al resto.

Google publica bibliotecas cliente para varios lenguajes que manejan por ti el handshake de OAuth y el formato JSON. Si prefieres no escribir esa capa tú mismo, herramientas como el proyecto instant-indexer basado en navegador muestran el flujo de solicitud directamente en JavaScript, usando Web Crypto para firmar el JWT localmente. Ese enfoque solo funciona de forma segura si la clave de la cuenta de servicio nunca sale de tu máquina ni queda incrustada en un script público. Subir esa clave a un servidor de terceros por comodidad echa por tierra el propósito de mantenerla privada en primer lugar.

Cuota, verificación de estado y errores comunes

La API ofrece una cuota diaria por defecto para las notificaciones de URL, y para conseguir cuota adicional hay que pasar por un proceso de revisión y solicitud. Ese es un tope duro que vale la pena tener en cuenta si manejas bolsas de trabajo con mucha rotación diaria.

Puedes consultar los metadatos de cualquier URL que hayas enviado, lo que muestra el último tipo de notificación y cuándo Google la registró. No te dice si la página fue rastreada, renderizada o indexada. Ese vacío causa la mayor parte de la confusión que reportan los desarrolladores tras sus primeras llamadas.

Una respuesta exitosa confirma que Google registró tu solicitud, no que la indexación ocurrió. Reintenta los 429 al día siguiente en lugar de darle duro al endpoint, y registra cada código de respuesta para que puedas detectar patrones en vez de depurar una URL fallida a la vez.

Buenas prácticas: renderizado, preparación de la página y qué evitar

Llamar a la API en una página que en realidad no está lista para ser indexada malgasta cuota y no te enseña nada útil sobre por qué falló la indexación. Antes de disparar una sola notificación, confirma lo básico: que la URL devuelve un estado 200, que no lleva etiqueta noindex y que incluye un esquema válido de JobPosting o BroadcastEvent si ese es el tipo de contenido que estás enviando.

Los sitios cargados de JavaScript enfrentan un problema completamente aparte. El rastreador de Google a menudo obtiene primero el HTML crudo y renderiza el JavaScript después, a veces con un lapso real de por medio, y la investigación de Semrush sobre SEO en JavaScript señala que este retraso de renderizado puede dejar una página prácticamente invisible incluso después de que Google ya la rastreó. El renderizado del lado del servidor o el prerenderizado cierran esa brecha al servir una página completamente formada en la primera solicitud, y Prerender lo recomienda como uno de los arreglos más confiables para sitios en JS que batallan para indexarse.

Una secuencia práctica te ahorra andar adivinando:

  1. Prueba la URL en vivo en la herramienta de Inspección de URLs de Search Console y revisa exactamente cómo la ve Google.
  2. Arregla lo que la esté bloqueando: esquema faltante, un noindex perdido, un renderizado que nunca termina.
  3. Solo entonces dispara la llamada a la Indexing API o vuelve a enviarla a través de Inspección de URLs.

Tip Pro: Si una página devuelve 200 desde la API pero sigue sin indexarse tras 48 horas, no la reenvíes a ciegas. Saca el HTML renderizado con la herramienta de inspección de Search Console y compáralo con lo que realmente muestra un navegador.

Alternativas y cuándo usar cada una

La Indexing API es una herramienta entre varias, y elegir la equivocada para el trabajo es un error común.

Un flujo de trabajo práctico para equipos que publican seguido

Los equipos editoriales que publican contenido de JobPosting o BroadcastEvent a diario necesitan una secuencia repetible, no un script de una sola vez. Confirma que la página esté lista (estado, esquema, sin noindex), prueba la URL en vivo, envíala a través de la API o de Inspección de URLs, luego registra el resultado y vuelve a revisar.

Flujo de publicación de la Indexing API en cinco pasos

Si una página devuelve 200 desde la API pero no muestra actividad de indexación tras 48 horas, no vuelvas a mandar la solicitud sin más. Depura primero el renderizado usando los mismos hallazgos de SEO en JavaScript de Semrush que marcan el retraso de renderizado como el sospechoso de siempre. A los equipos que siguen chocando contra este muro en un stack cargado de JS por lo general les conviene más pasarse al renderizado del lado del servidor, o entregarle la parte operativa a un servicio hecho para gestionarlo, en vez de pelear indefinidamente con la misma brecha de renderizado. Las agencias que manejan esto en varios sitios de clientes suelen apoyarse en herramientas de flujo de trabajo, como los patrones operativos descritos en los recursos para agencias de BabyLoveGrowth, para mantener los envíos y el monitoreo consistentes entre cuentas.

Un camino gestionado cuando prefieres no correr la API tú mismo

La mayoría de los fallos de indexación no son problemas de la API. Son problemas de configuración: un permiso de Search Console que falta, un renderizado de JavaScript que nunca termina, una etiqueta de esquema que está ligeramente mal. Arreglar esto requiere alguien que vigile la salud técnica del sitio de forma continua, no solo alguien que sepa escribir una solicitud POST.

Diazluna

Algunos servicios integran esa supervisión en el propio sitio web bilingüe, para que los errores de configuración que bloquean la indexación, verificación de propiedad, renderizado, marcado de esquema, se resuelvan antes de convertirse en un ticket de soporte. Para las consultas que atienden a clientes hispanos, esto puede significar un sitio en español e inglés construido para estar listo para indexarse desde el lanzamiento, respaldado por una recepcionista bilingüe con IA e integración con WhatsApp que mantienen la comunicación con los clientes en movimiento mientras la parte técnica corre en silencio de fondo. Si prefieres tener un sitio bilingüe ya configurado correctamente en vez de andar depurando retrasos de renderizado tú mismo, mira cómo funciona la plataforma de Diazluna y consigue una configuración hecha para que te encuentren desde el primer día.

Por qué los desarrolladores sobreestiman lo que hace esta API

Por qué los desarrolladores sobreestiman lo que hace esta API — diagrama general

El mayor malentendido sobre la Indexing API no es técnico, es de expectativas. Los desarrolladores tratan una respuesta 200 como una confirmación de éxito, cuando en realidad es apenas un acuse de recibo. Google registró la solicitud. Eso es todo.

La API premia a los equipos que ya tienen su casa técnica en orden: esquema limpio, sin retrasos de renderizado, permisos correctos en Search Console. Castiga a los equipos que la usan como atajo para saltarse esos fundamentos, porque una solicitud de rastreo rápida sobre una página rota solo te consigue un rechazo rápido. Si estás peleando con retrasos de renderizado de JavaScript en cada envío, el arreglo no es llamar a la API más seguido. Es pasarte al renderizado del lado del servidor o al prerenderizado para que la primera obtención ya esté lista para indexarse, algo que el checklist de indexación de Prerender.io cubre con más detalle operativo del que la mayoría de los desarrolladores espera al entrar. La API es una señal de última milla, no un sustituto de una página que de verdad está construida para ser indexada.

— Francisco

Fuentes