La referencia de solicitudes de la API IndexNow es un protocolo técnico que permite a los propietarios de sitios web notificar a motores de búsqueda como Yandex sobre contenido nuevo, actualizado o eliminado al instante. Mediante una solicitud HTTP simple con la URL de la página y una clave única, usted se asegura de que los rastreadores prioricen sus cambios recientes sin tener que esperar un ciclo de rastreo habitual. Este método reduce la carga del servidor y acelera la indexación de información reciente en la web.
¿Qué es la API de IndexNow y por qué importa?
El rastreo tradicional se basa en que los motores de búsqueda descubran enlaces o comprueben sitemaps a su propio ritmo. Esto a menudo genera una brecha entre la publicación y la indexación. IndexNow cambia esto al devolver el control al propietario del sitio web. Le indicas al motor de búsqueda que una página está lista, y este responde programando una visita.
El protocolo es especialmente útil para sitios que publican muchas páginas todos los días. Por ejemplo, un portal de noticias o un gran sitio minorista necesita que sus datos más recientes aparezcan en los resultados de búsqueda lo antes posible. Sin esta API, un nuevo artículo podría tardar horas o días en ser descubierto por un rastreador estándar.
¿Cómo estructurar una solicitud válida de la API de IndexNow?
Una solicitud estándar requiere tres elementos principales: el host, la lista de URLs y la clave. El host es el nombre de dominio donde ocurrieron los cambios. La lista de URLs puede contener hasta 10.000 enlaces por solicitud, aunque las actualizaciones individuales son comunes. La clave es una cadena que demuestra que eres dueño del dominio. Ten en cuenta que la clave debe estar alojada en tu servidor para ser verificada.
- El endpoint de la API, como yandex.com/indexnow.
- El encabezado content-type debe configurarse como application/json.
- Un cuerpo JSON que contiene el host, la clave y una lista de URLs.
- El keyLocation, que especifica la ruta a tu archivo de verificación.
La solicitud se puede enviar como POST o GET. El método POST se prefiere para agrupar múltiples URLs. Al usar POST, el cuerpo de la solicitud contiene los datos en un formato estructurado. El método GET es más simple pero solo admite una URL a la vez. La mayoría de los desarrolladores eligen POST por su eficiencia.
Descubrimos que muchos desarrolladores olvidan hacer coincidir exactamente la clave entre el cuerpo de la API y el archivo de texto. Una sola diferencia de carácter o un espacio adicional hará que la verificación falle de inmediato.
Equipo de SEO de Alien Road
¿Cuáles son los componentes clave para la validación?
La seguridad se maneja a través de un archivo de texto colocado en el directorio raíz. Este archivo contiene la misma cadena de clave utilizada en la llamada a la API. Los motores de búsqueda verifican la solicitud obteniendo este archivo de tu servidor. Si la clave en la solicitud coincide con la clave en el archivo de tu servidor, la solicitud se autentica.
La clave en sí debe tener al menos 8 caracteres de longitud, pero usar una cadena alfanumérica de 32 caracteres es un estándar más confiable. Debes nombrar el archivo de texto según la clave. Por ejemplo, si tu clave es ‘abc123’, tu archivo debe ser ‘abc123.txt’. Esto permite que el motor de búsqueda lo encuentre sin conjeturas.
¿Cómo manejar los errores comunes de respuesta de la API?
Al igual que los errores de feeds RSS mencionados en la documentación técnica, las solicitudes de IndexNow fallan si la sintaxis es incorrecta. Un 400 Bad Request generalmente significa que el formato JSON no es válido o falta un campo obligatorio. Un 403 Forbidden sugiere que la clave es incorrecta o el rastreador no puede acceder al archivo de claves. Observa que la higiene técnica es vital para el éxito.
- 400: Sintaxis no válida. Comprueba si faltan comillas o comas en tu JSON.
- 403: La verificación de la clave falló. Verifica que el archivo esté en el directorio raíz.
- 422: La URL no pertenece al host especificado en la solicitud.
- 429: Demasiadas solicitudes. Reduce la frecuencia de tus llamadas a la API.
Si ves un error 403, comprueba si tu servidor está bloqueando el agente de usuario del motor de búsqueda. A veces, los firewalls evitan que el rastreador obtenga el archivo de claves. Debes permitir el acceso a la URL de verificación específica para mantener una conexión fluida entre tu sitio y el motor de búsqueda.
Cómo Alien Road aplica la referencia de solicitud de la API indexnow
En Alien Road, integramos la API de IndexNow en el flujo de trabajo del CMS para nuestros clientes. Para un sitio de comercio electrónico típico con miles de productos, la indexación manual es imposible. Configuramos un activador automatizado que se ejecuta cada vez que cambia el precio de un producto o se agrega un nuevo artículo. Esto garantiza que el motor de búsqueda tenga los datos más actualizados sin demora.
En un compromiso típico, primero generamos una clave única y la colocamos en la raíz del servidor del cliente. Luego configuramos su backend para agrupar URLs y enviarlas al endpoint de Yandex cada hora. Esto evita que el servidor se sature mientras garantiza que las bajadas de precios o las actualizaciones de stock aparezcan en los resultados de búsqueda en cuestión de minutos. Para una tienda de Shopify que vende artículos para el hogar, este proceso mantiene sus datos de inventario precisos para los clientes potenciales.
Usar IndexNow para migraciones a gran escala es una estrategia sólida. En lugar de esperar semanas a que se reconozca un cambio de sitio, enviamos las nuevas URLs directamente, lo que ayuda a mantener la estabilidad del tráfico durante la transición.
Equipo de SEO de Alien Road
Especificaciones técnicas y límites
Si bien la API es potente, tiene límites que debes respetar. No puedes enviar más de 10.000 URLs en una sola solicitud POST. Además, todas las URLs deben pertenecer al mismo host. Si administras múltiples subdominios, cada uno requiere su propia clave y su propia llamada a la API para ser procesado correctamente.
El formato de la carga útil JSON es estricto. Al igual que los requisitos para los feeds de noticias, las URLs en IndexNow deben ser absolutas y estar totalmente calificadas. Deben usar el protocolo correcto, ya sea HTTP o HTTPS. Los caracteres especiales deben escaparse adecuadamente utilizando la codificación UTF-8. Una comilla adicional o un atributo cerrado incorrectamente detendrán la indexación de todo el lote.
Comparación de IndexNow con Sitemaps XML
Los sitemaps XML son archivos pasivos que los motores de búsqueda consultan ocasionalmente. IndexNow es un sistema de notificación activa. Si bien debes seguir manteniendo un sitemap para una visibilidad completa de la estructura del sitio, la API es la mejor opción para actualizaciones urgentes. El uso de ambos métodos juntos proporciona una estrategia de indexación completa.
Los sitemaps a veces pueden volverse muy grandes, lo que provoca tiempos de procesamiento lentos. IndexNow evita esto centrándose únicamente en lo que ha cambiado recientemente. Este enfoque dirigido es más eficiente tanto para tu servidor como para los recursos del motor de búsqueda. Reduce la necesidad de que el rastreador visite páginas sin cambios repetidamente.
Por dónde empezar esta semana
Comienza verificando si tu CMS tiene un plugin nativo de IndexNow. Si no lo tiene, genera una clave de 32 caracteres y súbela a la raíz de tu servidor como un archivo .txt. Prueba una sola URL utilizando una herramienta de línea de comandos simple para verificar que recibes una respuesta 200 OK. Una vez que hayas verificado la conexión, automatiza el proceso para todas las actualizaciones de contenido nuevas para mantener fresca tu presencia en las búsquedas.
Monitorea los registros de tu servidor para ver la visita del motor de búsqueda después de enviar una solicitud. Esto confirma que el sistema está funcionando. Si notas errores, consulta la lista de códigos de error y verifica tu sintaxis JSON en busca de errores comunes como caracteres no escapados o llaves faltantes.