IndexNow: avisar al instante a Bing, Yandex y otros · Lección 3 de 4
Enviar avisos: una dirección, una lista y las respuestas
Una dirección se avisa con un GET a api.indexnow.org/indexnow?url=…&key=…. Una lista, con un POST en JSON con host, key, keyLocation y urlList (hasta 10.000 direcciones por envío). 200 o 202 es éxito; 403 es clave inválida; 422, direcciones de otro dominio.
Una dirección (GET)
https://api.indexnow.org/indexnow?url=https://tusitio.com/pagina-nueva&key=<clave>Se puede pegar en el navegador. Sirve para probar o para una página suelta.
Una lista (POST)
POST https://api.indexnow.org/indexnow
Content-Type: application/json; charset=utf-8
{
"host": "tusitio.com",
"key": "<clave>",
"keyLocation": "https://tusitio.com/<clave>.txt",
"urlList": [
"https://tusitio.com/pagina-1",
"https://tusitio.com/pagina-2"
]
}- Todas las direcciones tienen que ser del mismo
host. - Hasta 10.000 por envío; con más, partí la lista en tandas.
- Avisá solo direcciones nuevas, cambiadas o borradas. Reenviar todo el sitio cada día no acelera nada: la documentación del protocolo pide avisar solo lo que cambió.
Las respuestas
| Código | Significado | Qué hacer |
|---|---|---|
| 200 | Recibido | Nada |
| 202 | Recibido; la clave todavía se está validando | Nada; es normal en el primer envío |
| 400 | Pedido mal armado | Revisar el JSON |
| 403 | Clave inválida (no se encontró o no coincide) | Abrir /<clave>.txt y comprobar que responda 200 con la clave exacta |
| 422 | Direcciones que no son del host o no coinciden con la clave | Revisar que todas las direcciones sean del mismo dominio |
| 429 | Demasiados pedidos | Esperar y enviar menos seguido |
Ejercicio sobre tu sitio
- Avisá una página de tu sitio con la dirección GET en el navegador y anotá la respuesta.
- Armá el JSON del POST con 3 direcciones y envialo con
curlo con el script de la próxima lección. - Al día siguiente, revisá en Bing Webmaster si el aviso figura recibido.
Preguntas frecuentes
¿A qué dirección mando el aviso?
A api.indexnow.org/indexnow o a la de cualquier buscador participante, como www.bing.com/indexnow. El aviso se comparte con todos los participantes.
¿Qué hago si recibo 403?
La clave no se pudo validar: abrí https://tusitio.com/<clave>.txt, comprobá que responda 200 sin redirecciones y que el contenido sea exactamente la clave, sin HTML ni espacios.