Qué es la API de Indexación de Google y cómo se usa
La Indexing API —API de Indexación— es un servicio gratuito de Google que permite avisarle por programa que una página de tu sitio se publicó, se actualizó o se dio de baja. En vez de esperar a que Googlebot pase por tu sitio, le mandás un pedido directo.
Este artículo explica qué es, qué hace falta para usarla y cuáles son sus límites. Si lo que buscás es la discusión sobre para qué tipos de página funciona de verdad, está en la verdad sobre la Indexing API.
Qué hace exactamente
La API tiene dos operaciones:
URL_UPDATED— avisar que una dirección se publicó o cambió.URL_DELETED— avisar que una dirección se dio de baja.
Le mandás una dirección por pedido y Google la encola para rastrear. La segunda operación es tan importante como la primera: sirve para sacar rápido de los resultados algo que ya no existe.
Lo que la API no hace: no indexa. Le avisa a Google. La decisión de indexar, y de en qué posición mostrarte, sigue siendo enteramente de Google.
Para qué tipos de página está habilitada
Este es el punto que más malentendidos genera y conviene decirlo antes de que pierdas una tarde configurando. La documentación oficial dice:
The Indexing API can only be used to crawl pages with eitherJobPostingorBroadcastEvent
O sea: avisos de empleo y transmisiones en vivo. Google la diseñó para contenido de vida corta, donde el rastreo normal llega tarde por definición.
Para otros tipos de página la API acepta el envío y responde 200 OK, pero eso significa "recibí el pedido", no "lo voy a rastrear".
Qué necesitás para conectarla
Son cuatro cosas y ninguna es opcional. Este es, con diferencia, el trámite más molesto de la API.
1. Un proyecto en Google Cloud. Gratis, pero hay que crearlo.
2. Una cuenta de servicio. Es un usuario que no es una persona: sirve para que un programa se identifique ante Google. Al crearla se descarga un archivo JSON con una clave privada. Ese archivo es una credencial: quien lo tiene puede actuar en nombre de tu sitio. Se guarda como se guarda una contraseña.
3. Habilitar la Indexing API en ese proyecto de Google Cloud.
4. Dar de alta esa cuenta de servicio como propietaria en Search Console, en la propiedad del sitio que vas a enviar. Sin este paso, todos los envíos van a fallar con un error de permisos, y es el error más común de todos.
Recién con las cuatro cosas hechas se puede mandar el primer pedido.
El límite diario
200 URLs por día, y es por proyecto de Google Cloud, no por sitio.
Ese detalle importa más de lo que parece: si administrás varios sitios desde el mismo proyecto, comparten el mismo cupo de 200. Google permite pedir una ampliación, con justificación.
Para un portal de empleos que publica cincuenta avisos por día, 200 alcanza sin problema. Para un catálogo de veinte mil productos, no.
Cómo se ve un pedido
El pedido es un POST al endpoint de la API, autenticado con la cuenta de servicio, con un cuerpo simple:
{
"url": "https://tusitio.com/empleos/desarrollador-backend",
"type": "URL_UPDATED"
}La respuesta trae la confirmación de que el pedido se recibió y cuándo. Nada más. No hay forma de preguntarle a la API si esa URL terminó indexada: eso se mira en Search Console.
Los errores que te vas a encontrar
| Qué te dice | Qué significa |
|---|---|
403 Permission denied | La cuenta de servicio no está como propietaria en Search Console. Es el error más común |
429 Quota exceeded | Se acabaron las 200 del día |
400 Invalid request | La dirección está mal formada, o no coincide con la propiedad verificada |
200 OK | El pedido se recibió. No significa que la página se vaya a indexar |
Cuándo conviene y cuándo no
Conviene si tenés un sitio con avisos de empleo o transmisiones en vivo, y sobre todo si el volumen es alto y los contenidos vencen. Ahí la API está hecha para vos, y Google recomienda usarla por encima del sitemap.
No conviene si tenés un blog, una tienda o un sitio institucional. No porque sea difícil, sino porque no está habilitada para eso y vas a estar automatizando un pedido que Google no va a atender. Para esos casos, lo que funciona es un sitemap al día, enlaces internos desde páginas que Google visita seguido, y contenido que valga la pena indexar.
Alternativas
- Sitemap XML: el mecanismo oficial de descubrimiento para cualquier tipo de página. Menos inmediato, pero es el que Google usa de verdad. El "ping" para avisar que el sitemap cambió fue retirado en 2023.
- Solicitar indexación en Search Console: manual, con cupo diario chico, ideal para páginas puntuales.
- IndexNow: protocolo abierto que acepta cualquier tipo de página, usado por Bing, Yandex, Seznam y Naver. Google no lo adoptó.