API de indexación de Google: usos admitidos y mitos

TL;DR — La API de indexación de Google permite a los propietarios de sitios decirle mediante código «esta página ha cambiado, vuelve a rastrearla», en lugar de hacer clic en botones. Pero este es el matiz que omiten la mayoría de las guías: Google solo la admite oficialmente para páginas de ofertas de empleo y páginas de emisiones en directo. No es un atajo para indexar más rápido tus artículos o páginas de producto; Google lo ha dicho una y otra vez.

Qué es la API de indexación

Cuando publicas o cambias una página, normalmente esperas a que Google vuelva a rastrearla según su propio calendario. La API de indexación permite enviar una notificación a Google en su lugar: «esta URL es nueva o se ha actualizado» o «esta URL ya no existe, elimínala». Lo haces con código (un pequeño programa que llama a los servidores de Google), no haciendo clic en un panel.

Suena potente, y lo es, para las cosas exactas para las que se creó.

Lo único que debes entender

Google solo admite oficialmente la API de indexación para dos tipos de páginas:

1. Ofertas de empleo: páginas con datos estructurados JobPosting (anuncios de trabajo que caducan y deben desaparecer rápidamente).
2. Emisiones en directo: páginas con datos estructurados BroadcastEvent (eventos de vídeo en directo que solo importan durante la emisión).

Eso es todo. Ambos son contenidos sensibles al tiempo que se quedan obsoletos rápidamente, por lo que Google creó para ellos un carril rápido.

Si no tienes ofertas de empleo ni emisiones en directo, la API de indexación no es tu herramienta, por mucho que un plugin o SaaS de «indexación en horas» te diga lo contrario.

El mito que debes ignorar

El mayor mito de internet es: «Usa la API de indexación para indexar rápidamente cualquier página». No funciona así, y Google ha calificado repetidamente de uso indebido emplearla para páginas normales. La gente lo hace porque las herramientas lo venden como un truco de crecimiento, pero Google puede (y dice que lo hará) revocar tu acceso por abusar de ella.

También hay una segunda trampa: cuando envías una URL y recibes una respuesta de «éxito», eso solo significa que Google recibió tu solicitud. No significa que la página se haya indexado. Muchas herramientas difuminan esa diferencia; la documentación de Google es clara al respecto.

Qué hacer en su lugar para indexar más rápido

Para páginas normales (blogs, productos y artículos), lo que realmente ayuda es aburrido, pero real:

• Envía un sitemap XML en Google Search Console.
• Enlaza tus páginas nuevas desde otras páginas de tu sitio.
• Haz que la página realmente merezca ser indexada (calidad, no relleno superficial).
• Para un caso puntual, usa «Solicitar indexación» en la herramienta de inspección de URL de Search Console, con moderación.

¿Quieres la versión técnica —configuración, métodos reales de la API, cuotas y citas exactas de Google—? Cambia a la pestaña Avanzado.

TL;DR — La API de indexación es una API REST (v3) autenticada mediante Google Cloud que acepta notificaciones URL_UPDATED y URL_DELETED. Google la admite oficialmente solo para páginas con JobPosting y para páginas de emisiones en directo con BroadcastEvent dentro de VideoObject, no para contenido general. Un 200 del endpoint de estado confirma la recepción, no la indexación. La postura de Google se ha endurecido con los años: 2022 (“doesn’t make sense” (traducción) «no tiene sentido») → septiembre de 2024 (se añadió una advertencia de spam a la documentación) → mayo de 2025 (Mueller: “spammers misuse the Indexing API… use it properly, or not use it” (traducción) «los spammers hacen un uso indebido de la API de indexación… úsala correctamente o no la uses»). El uso indebido, incluidas varias cuentas para inflar la cuota, puede provocar la revocación del acceso. Para páginas generales, tus palancas son los sitemaps, los enlaces internos, la calidad y el «Solicitar indexación» ocasional de GSC; recuerda que Google no admite IndexNow.

Qué es realmente la API de indexación

La API de indexación es un canal programático de envío: una API REST (v3), autenticada mediante una cuenta de servicio de Google Cloud, a la que llamas para indicar que se ha añadido o actualizado una URL (URL_UPDATED) o que debe eliminarse (URL_DELETED). Se sitúa junto a los sitemaps y Search Console como forma de que Google descubra y actualice las URL, pero es la más limitada de las tres por tipo de contenido.

En mi presentación How Search Works, enumero la API de indexación como fuente de descubrimiento de URL con la etiqueta “limited use cases” (traducción) «casos de uso limitados»: esa es toda la historia en dos palabras. Es real, funciona y solo está autorizada para una pequeña parte de la web.

Para qué la admite oficialmente Google

Este es el hecho fundamental, así que lo expresarė como Google: la API de indexación «can only be used to crawl pages with either JobPosting or BroadcastEvent embedded in a VideoObject.» (traducción) «solo se puede utilizar para rastrear páginas que tengan JobPosting o BroadcastEvent insertado en un VideoObject». Eso es todo: dos tipos de datos estructurados:

• JobPosting: páginas de ofertas de empleo. Caducan y los empleos obsoletos ofrecen una mala experiencia, por lo que importa añadirlos o retirarlos a tiempo.
• BroadcastEvent en un VideoObject: páginas de eventos emitidos en directo. Solo son relevantes durante la emisión y justo alrededor de ella.

¿Por qué solo estos dos? Ambos son intrínsecamente sensibles al tiempo y de corta duración. La razón que da Google es que notificar rápidamente los cambios importa mucho más para ellos que para las páginas perennes, que el rastreo normal gestiona correctamente.

Cómo funciona

Requisitos previos

La configuración no es trivial: no es una función de un solo clic:

• Un proyecto de Google Cloud con la API de indexación activada. Como dice Google, «need to tell Google about your client and activate access to the API.» (traducción) «debes informar a Google sobre tu cliente y activar el acceso a la API».
• Una cuenta de servicio con un archivo de clave JSON, almacenado de forma segura.
• Verificación en Search Console del sitio; después, añade tu cuenta de servicio como propietario delegado del sitio.
• OAuth: «Every call to the Indexing API must be authenticated with an OAuth token that you get in exchange for your private key,» (traducción) «cada llamada a la API de indexación debe autenticarse con un token OAuth que obtienes a cambio de tu clave privada», usando el alcance https://www.googleapis.com/auth/indexing.

Los dos métodos (más una comprobación de estado)

• URL_UPDATED: «To notify Google of a new URL to crawl or that content at a previously-submitted URL has been updated.» (traducción) «para notificar a Google una URL nueva que debe rastrear o que se ha actualizado el contenido de una URL enviada anteriormente». Envía la URL mediante POST con "type": "URL_UPDATED". Una llamada correcta recibe HTTP 200; la formulación de Google es que «means that Google may try to recrawl this URL soon,» (traducción) «significa que Google puede intentar volver a rastrear esta URL pronto», no que vaya a hacerlo ni que el rastreo vaya a terminar en indexación.
• URL_DELETED: antes de solicitar la eliminación, Google exige que «the URL must return a 404 or 410 status code or the page must contain» (traducción) «la URL devuelva un código de estado 404 o 410, o la página contenga» una etiqueta meta noindex: es una condición o, no «elimina la página y añade también noindex». Cuando se cumple, envía la URL mediante POST con "type": "URL_DELETED" para que Google la retire.
• Estado (GET): devuelve metadatos (latest_update, latest_remove, notify_time). El matiz crítico, literalmente, es que la solicitud «only returns whether you successfully submitted a request.» (traducción) «solo devuelve si has enviado correctamente una solicitud». No indica si Google ha indexado o retirado algo.
• Lotes: para reducir las conexiones HTTP, puedes “combine up to 100 calls to the Indexing API into a single HTTP request.” (traducción) «combinar hasta 100 llamadas a la API de indexación en una sola solicitud HTTP». La cuota sigue contando por URL: un lote de 10 solicitudes consume 10 solicitudes de cuota.

Cuotas

La cuota predeterminada de Google tiene tres dimensiones distintas, no un solo número:

• 200 solicitudes de publicación al día por proyecto: incluye conjuntamente las llamadas URL_UPDATED y URL_DELETED. Es la cifra que cita la mayoría de las guías.
• 180 solicitudes getMetadata (estado) por minuto y proyecto.
• 380 solicitudes por minuto y proyecto entre todos los endpoints.

Las tres se describen como «initial default quota for testing» (traducción) «cuota predeterminada inicial para pruebas». Superarlas «requires additional approval for usage and resource provisioning» (traducción) «requiere aprobación adicional para el uso y el aprovisionamiento de recursos» mediante un formulario de solicitud, y Google señala que “the quota may increase or decrease based on the document quality.” (traducción) «la cuota puede aumentar o disminuir según la calidad del documento». El «truco» habitual de crear varias cuentas de servicio o proyectos para inflar la cuota diaria es exactamente lo que Google prohíbe (véase más abajo).

¿Puedes usarla para páginas normales? Lo que dice realmente Google

Respuesta corta: no, no de una forma admitida, y Google ha sido extraordinariamente constante y cada vez más tajante al respecto.

La documentación incluye una advertencia de spam. Alrededor de septiembre de 2024, Google añadió al inicio rápido un texto que hacía explícita la postura: «All submissions through the Indexing API undergo rigorous spam detection,» (traducción) «todas las solicitudes enviadas mediante la API de indexación se someten a una rigurosa detección de spam», y «any attempts to abuse the Indexing API, including the use of multiple accounts or other means to exceed usage quotas, may result in access being revoked.» (traducción) «cualquier intento de abusar de la API de indexación, incluido el uso de varias cuentas u otros medios para superar las cuotas de uso, puede provocar la revocación del acceso».

Los representantes lo llevan diciendo años. En mayo de 2022, John Mueller lo explicó con su analogía de los vehículos de construcción: la API «is meant for very specific kinds of content» (traducción) «está pensada para tipos de contenido muy específicos», y utilizarla para otros «doesn’t really make sense» (traducción) «no tiene mucho sentido». En mayo de 2025 el tono fue más contundente: Mueller dijo «We see a lot of spammers misuse the Indexing API like this, so I’d recommend just sticking to the documented & supported use-cases,» (traducción) «vemos que muchos spammers hacen un uso indebido de la API de indexación de esta forma, así que recomendaría limitarse a los casos de uso documentados y admitidos», y «I’d just use it properly, or not use it. If we wanted to suggest that people could use it regardless, we’d document it as such.» (traducción) «yo la usaría correctamente o no la usaría. Si quisiéramos sugerir que la gente puede usarla de todos modos, lo documentaríamos así».

Esa trayectoria —2022 “doesn’t make sense” (traducción) «no tiene sentido» → advertencia de spam en la documentación de 2024 → 2025 “spammers misuse… use it properly or not use it” (traducción) «los spammers hacen un uso indebido… úsala correctamente o no la uses»— es un patrón de varios años, no un hecho aislado. La cobertura también ha señalado que blogueros y profesionales de SEO inundan de hecho la API al tratar sitios normales como si cumplieran los requisitos.

El riesgo real, expresado con precisión. Mueller no llega a prometer una penalización algorítmica. La formulación honesta es: no está admitida y va contra las directrices, el contenido enviado de forma indebida puede no permanecer indexado y tu acceso puede revocarse. No lo exageres como una acción manual garantizada, pero tampoco finjas que es gratis.

El mito del endpoint de estado

Este merece su propia línea porque muchas herramientas se equivocan: un envío correcto es confirmación de recepción, no una promesa de indexación. El GET de estado «only returns whether you successfully submitted a request.» (traducción) «solo devuelve si has enviado correctamente una solicitud». Si un panel te muestra una insignia verde de «indexado» basándose en un 200, está infiriendo algo que la API nunca le dijo.

API de indexación frente a Solicitar indexación frente a IndexNow

Las tres cosas se confunden constantemente. Son mecanismos distintos:

• API de indexación (Google): programática, pero restringida por contenido a JobPosting/BroadcastEvent. Es la más limitada de las tres.
• Solicitar indexación (inspección de URL de GSC): funciona para cualquier página que poseas, pero es manual, de una URL cada vez y está pensada para usos ocasionales; además, es una solicitud, no una garantía.
• IndexNow: protocolo abierto de envío entre motores (Bing, Yandex, Yep, Seznam y Naver), y Google no lo utiliza. Es el equivalente entre motores de la API de indexación, y es el que yo defiendo: ayudé a lanzar la integración de IndexNow en Ahrefs Site Audit. Pero no llega a Google.

(Desglose completo en la pestaña Marcos.)

Qué hacer en su lugar para las páginas generales

Si no publicas ofertas de empleo ni emisiones en directo, la API de indexación no es tu herramienta, y Google lo ha dicho repetidamente. Tus palancas reales en Google son las poco glamurosas:

• Sitemaps: para cobertura y descubrimiento.
• Enlaces internos: las páginas huérfanas tienen dificultades; las páginas enlazadas se descubren.
• Calidad del contenido: Google decide qué merece indexarse; las páginas superficiales se estancan en «Discovered – currently not indexed» por mucho que las impulses.
• «Solicitar indexación» de GSC: para casos puntuales auténticos, con moderación.

Para el envío entre motores (Bing y compañía, no Google), IndexNow es la herramienta correcta. Y si te importa por qué no se indexan las páginas, esa es una cuestión de frecuencia de rastreo y calidad, no una cuestión de API.

Resumen de IA

Una síntesis de la versión avanzada:

• Qué es: una API REST (v3) autenticada mediante Google Cloud para enviar a Google notificaciones URL_UPDATED/URL_DELETED.
• El único hecho importante: se admite oficialmente solo para páginas JobPosting y BroadcastEvent (emisiones en directo), no para contenido general. Ambos están diseñados para ser sensibles al tiempo.
• El mito número uno: «indexa rápidamente cualquier página». No lo hace; Google califica de uso indebido el uso más amplio. Un envío correcto solo confirma que Google recibió la solicitud, no que se haya indexado nada.
• La postura de Google se endureció con el tiempo: 2022 “doesn’t make sense” (traducción) «no tiene sentido» → septiembre de 2024, advertencia de spam añadida a la documentación → mayo de 2025, Mueller “spammers misuse… use it properly, or not use it” (traducción) «los spammers hacen un uso indebido… úsala correctamente o no la uses».
• Riesgo: no está admitido y va contra las directrices; usar varias cuentas para superar la cuota de aproximadamente 200 al día puede provocar la revocación del acceso. No necesariamente una penalización manual, pero el contenido puede no mantenerse.
• No es lo mismo que IndexNow (entre motores, Bing/Yandex/etc.; Google no lo utiliza) ni que Solicitar indexación de GSC (cualquier página, manual y ocasional).
• Para páginas normales: sitemaps + enlaces internos + calidad + Solicitar indexación ocasional en GSC.

Documentación oficial

Documentación de fuentes primarias de Google.

Google: API de indexación

• Inicio rápido de la API de indexación: resumen, restricción a JobPosting/BroadcastEvent y advertencia de detección de spam.
• Cómo usar la API de indexación: métodos URL_UPDATED/URL_DELETED y el matiz del endpoint de estado.
• Requisitos previos: proyecto de Cloud, cuenta de servicio, alcance OAuth y propiedad delegada en Search Console.
• Cuota y precios: cuota predeterminada (200) y aprobación necesaria para ampliarla.

Google: contexto para páginas generales

• Pide a Google que vuelva a rastrear tus URL: sitemaps y la vía «Solicitar indexación» de Search Console para contenido normal.
• Guía detallada sobre cómo funciona la Búsqueda de Google: dónde encajan el descubrimiento de URL y el flujo rastrear → indexar → servir.

Citas de la fuente

Declaraciones registradas de Google. Cada enlace es un enlace profundo que salta al pasaje citado en la página de origen.

Documentación de Google: la restricción

• “The Indexing API can only be used to crawl pages with either JobPosting or BroadcastEvent embedded in a VideoObject.” (traducción) «La API de indexación solo se puede utilizar para rastrear páginas que tengan JobPosting o BroadcastEvent insertado en un VideoObject». — Google Search Central, inicio rápido de la API de indexación. Ir a la cita
• “The Indexing API allows site owners to directly notify Google when their job posting or livestreaming video pages are added or removed” (traducción) «La API de indexación permite a los propietarios de sitios notificar directamente a Google cuando se añaden o eliminan sus páginas de ofertas de empleo o vídeos emitidos en directo». Ir a la cita

Documentación de Google: la advertencia de spam (añadida a la documentación alrededor de septiembre de 2024)

• “All submissions through the Indexing API undergo rigorous spam detection.” (traducción) «Todas las solicitudes enviadas mediante la API de indexación se someten a una rigurosa detección de spam». Ir a la cita
• “Any attempts to abuse the Indexing API, including the use of multiple accounts or other means to exceed usage quotas, may result in access being revoked.” (traducción) «Cualquier intento de abusar de la API de indexación, incluido el uso de varias cuentas u otros medios para superar las cuotas de uso, puede provocar la revocación del acceso». Ir a la cita

Documentación de Google: el matiz del endpoint de estado (destructor de mitos)

• “The GET request doesn’t tell you when Google indexes or removes a URL; it only returns whether you successfully submitted a request.” (traducción) «La solicitud GET no te dice cuándo indexa o retira Google una URL; solo devuelve si has enviado correctamente una solicitud». — Google Search Central, guía de uso de la API de indexación. Ir a la cita

Documentación de Google: cuota

• “The default value is set to 200.” (traducción) «El valor predeterminado se establece en 200» (solicitudes de publicación al día). — Google Search Central, cuota y precios. Ir a la cita
• “The default value is set to 180.” (traducción) «El valor predeterminado se establece en 180» (getMetadata, solicitudes de estado por minuto), y “The default value is set to 380.” (traducción) «El valor predeterminado se establece en 380» (todos los endpoints por minuto): las otras dos dimensiones de cuota que omite la mayoría de las guías. Ir a 180 · Ir a 380
• “The quota may increase or decrease based on the document quality.” (traducción) «La cuota puede aumentar o disminuir según la calidad del documento». — Google Search Central, cuota y precios. Ir a la cita

Documentación de Google: lotes y eliminación

• «…you can combine up to 100 calls to the Indexing API into a single HTTP request.» (traducción) «…puedes combinar hasta 100 llamadas a la API de indexación en una sola solicitud HTTP». — Google Search Central, documentación sobre lotes de la API de indexación. Ir a la cita
• «…the URL must return a 404 or 410 status code or the page must contain» (traducción) «…la URL debe devolver un código de estado 404 o 410, o la página debe contener» una etiqueta meta noindex, antes de solicitar la eliminación. — Google Search Central, documentación sobre la eliminación mediante la API. Ir a la cita
• “An HTTP 200 response means that Google may try to recrawl this URL soon.” (traducción) «Una respuesta HTTP 200 significa que Google puede intentar volver a rastrear esta URL pronto». — Google Search Central, explicación de URL_UPDATED en la guía de uso de la API. Ir a la cita

John Mueller, Google Search Advocate: Bluesky, aproximadamente mayo de 2025

• “We see a lot of spammers misuse the Indexing API like this, so I’d recommend just sticking to the documented & supported use-cases.” (traducción) «Vemos que muchos spammers hacen un uso indebido de la API de indexación de esta forma, así que recomendaría limitarse a los casos de uso documentados y admitidos».
• “I’d just use it properly, or not use it. If we wanted to suggest that people could use it regardless, we’d document it as such.” (traducción) «Yo optaría por usarla correctamente o no usarla. Si quisiéramos sugerir que la gente puede utilizarla de todos modos, lo documentaríamos así». Leer la cobertura

John Mueller, Google: SEO office-hours, mayo de 2022 (el enfoque de los «vehículos de construcción»)

• “The indexing API is meant for very specific kinds of content. And using it for other kinds of content doesn’t really make sense.” (traducción) «La API de indexación está pensada para tipos de contenido muy específicos. Y utilizarla para otros tipos de contenido no tiene mucho sentido».
• “It’s not that it’s illegal or that it will cause problems if you put construction vehicles on your medical website. But it doesn’t really make sense.” (traducción) «No es que sea ilegal ni que vaya a causar problemas poner vehículos de construcción en tu sitio médico. Pero no tiene mucho sentido». Leer la cobertura

API de indexación: chuleta

Casos de uso admitidos (esta es la lista completa)

Los dos métodos

Lotes: combina hasta 100 llamadas en una solicitud HTTP; la cuota sigue contando por URL, no por lote.

Datos rápidos

• La cuota predeterminada tiene tres partes: 200 solicitudes de publicación al día, 180 solicitudes de estado (getMetadata) por minuto y 380 solicitudes por minuto entre todos los endpoints. La cuota superior necesita la aprobación de Google y puede cambiar según la calidad del documento.
• 200 ≠ indexado. Una respuesta correcta confirma que se recibió el envío, nada más.
• Varias cuentas para superar la cuota = acceso revocado (según la documentación).
• Autenticación: proyecto de Google Cloud + cuenta de servicio + OAuth, con el alcance https://www.googleapis.com/auth/indexing; la cuenta de servicio se añade como propietario delegado de GSC.
• No es IndexNow (entre motores, no Google). Tampoco sustituye a los sitemaps ni a Solicitar indexación de GSC.

Una llamada de publicación mínima (solo para contenido admitido)

Esta es la forma de una notificación URL_UPDATED individual. Úsala solo con páginas que tengan datos estructurados JobPosting o BroadcastEvent: es para lo que se autoriza la API. El paso de autenticación (intercambiar la clave de la cuenta de servicio por un token OAuth) se omite por brevedad; en la práctica usarías una biblioteca cliente de Google para obtener el token.

La solicitud

POST https://indexing.googleapis.com/v3/urlNotifications:publish
Authorization: Bearer <OAUTH_TOKEN>
Content-Type: application/json

{
  "url": "https://example.com/jobs/senior-seo-analyst",
  "type": "URL_UPDATED"
}

Para indicar una eliminación (después de que la página desaparezca o tenga noindex):

{
  "url": "https://example.com/jobs/senior-seo-analyst",
  "type": "URL_DELETED"
}

Comprobar el estado: recuerda que la respuesta solo indica que se recibió la solicitud, no que se haya indexado nada:

GET https://indexing.googleapis.com/v3/urlNotifications/metadata?url=https%3A%2F%2Fexample.com%2Fjobs%2Fsenior-seo-analyst
Authorization: Bearer <OAUTH_TOKEN>

Un 200 aquí significa «hemos recibido tu envío»; no confirma que Google haya indexado (o retirado) la URL.

Enviar varias URL en lote: puedes combinar hasta 100 llamadas individuales en una sola solicitud multiparte a https://indexing.googleapis.com/batch en lugar de enviar 100 solicitudes separadas; pero la cuota sigue contando por URL, así que un lote de 100 llamadas consume 100 solicitudes de tu asignación diaria. Las bibliotecas cliente de la API de Google (Java, Python, JavaScript, PHP y .NET) se encargan del formato del lote; rara vez merece la pena crearlo a mano.

Comparativa: API de indexación, Solicitar indexación e IndexNow

El marco de decisión: averigua qué tienes y qué motor te importa, y después elige el canal.

Cómo elegir

1. ¿Tienes ofertas de empleo o emisiones en directo y quieres automatizar? → API de indexación.
2. ¿Quieres enviar páginas generales a Bing/Yandex/Yep? → IndexNow.
3. ¿Quieres que Google vuelva a rastrear una página normal una vez? → «Solicitar indexación» de GSC.
4. ¿Quieres indexar páginas generales a escala en Google? → No hay un botón de envío. Sitemaps + enlaces internos + calidad (y paciencia; consulta la frecuencia de rastreo).

El modelo mental: la API de indexación parece la más potente de las tres porque es una API, pero por tipo de contenido es la más limitada. Potencia y alcance no son lo mismo.

Herramientas

• Google Cloud Console: crea el proyecto, activa la API de indexación y genera la clave JSON de la cuenta de servicio con la que te autenticarás.
• Google Search Console: inspección de URL: para páginas normales, esta es tu herramienta real: comprueba cómo se rastreó, renderizó e indexó una URL y usa «Solicitar indexación» para casos puntuales.
• Google Search Console: Sitemaps y cobertura: envía sitemaps y comprueba qué está indexado, «Discovered – currently not indexed» o excluido.
• Bibliotecas cliente de las API de Google: la forma más limpia de gestionar el intercambio del token OAuth de las llamadas a la API de indexación (en lugar de crear firmas JWT a mano).
• Integración de IndexNow (Ahrefs Site Audit, etc.): para el canal de envío entre motores (Bing y otros, no Google). Es la herramienta correcta cuando quieres el comportamiento de envío programático que mucha gente desearía que la API de indexación ofreciera para páginas generales.

Recursos que merecen tu tiempo

Mis textos relacionados

• ¿Qué es Googlebot y cómo funciona?: dónde se sitúa la API de indexación entre las fuentes de descubrimiento de URL de Google (enlaces, sitemaps, RSS, GSC y la API).
• Cómo corregir «Discovered – currently not indexed»: la página sobre el verdadero «por qué no se indexan mis páginas»; la solución es la calidad y los enlaces internos, no una API de envío.
• La guía para principiantes de SEO técnico: dónde encajan el rastreo y la indexación en el panorama general.

Mis ponencias

• How Search Works (SlideShare): mi recorrido por el descubrimiento, rastreo, renderizado, indexación y posicionamiento; la diapositiva de descubrimiento de URL etiqueta la API de indexación como «limited use cases». (Se aplica mi aviso habitual: «This is my understanding of systems… not going to be 100% complete or accurate» (traducción) «esta es mi comprensión de los sistemas… no será 100 % completa ni exacta»).

Sobre IndexNow (el hermano entre motores; recuerda que Google no lo utiliza)

• Integración de IndexNow en Ahrefs Site Audit: el canal de envío que sí respaldo, para Bing/Yandex/Yep en lugar de Google.
• Cómo enviar páginas a IndexNow desde Site Audit.

De otros autores

• Google añade una advertencia de spam a la documentación de la API de indexación (Search Engine Journal, septiembre de 2024): documenta cuándo se incorporó el lenguaje de detección de spam.
• Google vuelve a decir que dejes de usar la API de indexación para contenido no admitido (Search Engine Roundtable, mayo de 2025): Barry Schwartz cubre la advertencia de Mueller en Bluesky sobre dejar de abusar de la API.
• El uso indebido de la API de indexación podría causar problemas de SEO (StanVentures, mayo de 2025): reproduce literalmente las citas de Mueller de mayo de 2025 y explica el riesgo de revocar el acceso.
• Google responde si usar la API de indexación para un sitio normal es bueno o malo (iLoveSEO, mayo de 2022): transcripción del enfoque de los «vehículos de construcción» de Mueller en una sesión de consulta.
• Google dice que su API de indexación está inundada de blogueros: explica cómo el uso fuera de alcance por blogueros y profesionales de SEO ha sobrecargado la API.
• r/TechSEO: comunidad para depurar problemas de rastreo e indexación.

Problemas habituales

Problemas con los que la gente se encuentra realmente al usar la API de indexación, en orden síntoma → causa → solución.

«He recibido una respuesta 200, pero la página aún no está indexada»

• Síntoma: la llamada URL_UPDATED (o el GET de estado) devuelve éxito, pero la página nunca aparece en la búsqueda o Search Console sigue mostrando «Discovered – currently not indexed».
• Causa: un 200 solo confirma que Google recibió la notificación. Según la documentación de Google, el endpoint de estado «only returns whether you successfully submitted a request» (traducción) «solo devuelve si has enviado correctamente una solicitud»; no indica si se ha rastreado, indexado o retirado algo.
• Solución: deja de tratar la respuesta de la API como confirmación de indexación. Comprueba el estado real en la herramienta de inspección de URL de Search Console o en el informe de cobertura. Si la página sigue sin indexarse tras una espera razonable, el problema es de descubrimiento/calidad (consulta «Qué hacer en su lugar» en la pestaña Avanzado), no de la llamada a la API.

«Me han revocado el acceso a la API de indexación»

• Síntoma: las llamadas que antes funcionaban empiezan a fallar, o Google Cloud/Search Console muestra que se ha retirado el acceso de la cuenta de servicio.
• Causa: Google afirma claramente que “any attempts to abuse the Indexing API, including the use of multiple accounts or other means to exceed usage quotas, may result in access being revoked.” (traducción) «cualquier intento de abusar de la API de indexación, incluido el uso de varias cuentas u otros medios para superar las cuotas, puede provocar la revocación del acceso». El desencadenante más habitual es enviar páginas que no son JobPosting/BroadcastEvent o crear cuentas de servicio adicionales para sortear la cuota predeterminada de aproximadamente 200 al día.
• Solución: audita lo que has estado enviando. Si es contenido general (artículos, páginas de producto o cualquier cosa sin datos estructurados JobPosting o BroadcastEvent), detente. La documentación no admite la API para ello y Mueller ha dicho directamente: «I’d just use it properly, or not use it.» (traducción) «yo la usaría correctamente o no la usaría». No hay una vía de apelación documentada más allá de permanecer dentro del caso de uso admitido en adelante.

«Los envíos de páginas normales no parecen hacer nada»

• Síntoma: envías URL_UPDATED para un artículo o página de producto normal y nada cambia: ni un rastreo más rápido ni una indexación más rápida.
• Causa: el tipo de contenido no es uno de los dos que admite Google. La API de indexación «can only be used to crawl pages with either JobPosting or BroadcastEvent embedded in a VideoObject.» (traducción) «solo se puede utilizar para rastrear páginas que tengan JobPosting o BroadcastEvent insertado en un VideoObject». Los envíos fuera de ese alcance no son una señal documentada ni admitida.
• Solución: no es un error que haya que corregir: es la herramienta equivocada. Para páginas generales, usa un sitemap, enlaces internos y, para casos puntuales, «Solicitar indexación» en la herramienta de inspección de URL de Search Console.

«Estoy alcanzando el límite de cuota»

• Síntoma: los envíos empiezan a fallar o a limitarse, ya sea alrededor de 200 al día o en ráfagas más cortas incluso por debajo de 200 al día.
• Causa: Google aplica realmente tres cuotas predeterminadas distintas: 200 solicitudes de publicación (URL_UPDATED/URL_DELETED) por día, 180 solicitudes de estado (getMetadata) por minuto y 380 solicitudes por minuto entre todos los endpoints. Una ráfaga de comprobaciones de estado puede limitarte por los topes por minuto mucho antes de alcanzar los 200 diarios. Superar cualquiera de estas «requires additional approval for usage and resource provisioning,» (traducción) «requiere aprobación adicional para el uso y el aprovisionamiento de recursos», y Google señala que la cuota concedida «may increase or decrease based on the document quality.» (traducción) «puede aumentar o disminuir según la calidad del documento».
• Solución: si de verdad publicas o actualizas tantas páginas JobPosting o BroadcastEvent al día, solicita un aumento de cuota mediante Google Cloud. No crees cuentas de servicio o proyectos adicionales para sortearla, porque la documentación señala explícitamente que ese tipo de abuso puede provocar la revocación del acceso.

Listas de comprobación

Antes de tocar la API de indexación

• Confirma que las páginas que quieres enviar realmente contienen datos estructurados JobPosting, o BroadcastEvent insertado en un VideoObject: son los únicos dos tipos de contenido que admite Google.
• Si ninguno se aplica, detente aquí. Usa sitemaps, enlaces internos, calidad del contenido y «Solicitar indexación» ocasional de GSC, no la API.
• Decide si el volumen de envíos cabe de forma realista dentro de la cuota predeterminada de aproximadamente 200 al día o si tendrás que solicitar un aumento.

Configuración

• Crea (o elige) un proyecto de Google Cloud y activa la API de indexación.
• Crea una cuenta de servicio y descarga su archivo de clave JSON; guárdalo de forma segura (no lo subas nunca a un repositorio público).
• Verifica tu sitio en Search Console si aún no lo has hecho.
• Añade el correo electrónico de la cuenta de servicio como propietario delegado del sitio en Search Console.
• Confirma que puedes intercambiar la clave de la cuenta de servicio por un token OAuth con el alcance https://www.googleapis.com/auth/indexing (normalmente mediante una biblioteca cliente de Google, no creando firmas JWT a mano).

Enviar una notificación

• Elige el método correcto: URL_UPDATED para una página admitida nueva o modificada; URL_DELETED después de que la página desaparezca o tenga noindex.
• Envía la URL mediante POST con el campo type correcto a https://indexing.googleapis.com/v3/urlNotifications:publish.
• Trata una respuesta 200 solo como confirmación de recepción, no como prueba de que la página se haya indexado o retirado.
• Haz seguimiento en Search Console (inspección de URL o cobertura) si necesitas confirmar el estado real de indexación.

Mantenerse dentro de las directrices

• Envía mediante esta API solo páginas JobPosting/BroadcastEvent, nada más.
• No crees varias cuentas de servicio o proyectos solo para superar la cuota; solicita un aumento legítimo.
• Si no estás seguro de que una página cumpla los requisitos, trátala como si no los cumpliera y utiliza sitemaps/enlaces internos/«Solicitar indexación».

Cuestionario

Cinco preguntas para comprobar qué has retenido realmente sobre la API de indexación.

Registro de cambios