La référence de requête API IndexNow est un protocole technique permettant aux éditeurs de sites d’alerter instantanément les moteurs comme Yandex lors de la création, de la mise à jour ou de la suppression de contenus. En envoyant une simple requête HTTP contenant l’URL ciblée et une clé unique, vous vous assurez que les robots explorent en priorité vos dernières modifications sans attendre le cycle de crawl standard. Cette approche allège la charge serveur et accélère l’accès aux nouveaux contenus sur le web.
Qu’est-ce que l’API IndexNow et pourquoi est-ce important ?
Le crawling traditionnel repose sur la découverte de liens par les moteurs de recherche ou sur la vérification de sitemaps à leur propre rythme. Cela entraîne souvent un décalage entre la publication et l’indexation. IndexNow change la donne en redonnant le contrôle au propriétaire du site web. Vous informez le moteur de recherche qu’une page est prête, et il répond en planifiant une visite.
Le protocole est particulièrement utile pour les sites qui publient de nombreuses pages chaque jour. Par exemple, un portail d’actualités ou un grand site e-commerce a besoin que ses données les plus récentes apparaissent dans les résultats de recherche le plus rapidement possible. Sans cette API, un nouvel article peut devoir attendre des heures ou des jours pour être découvert par un crawler standard.
Comment structurer une requête API IndexNow valide ?
Une requête standard nécessite trois éléments principaux : l’hôte, la liste des URL et la clé. L’hôte est le nom de domaine où les modifications ont eu lieu. La liste des URL peut contenir jusqu’à 10 000 liens par requête, bien que les mises à jour uniques soient courantes. La clé est une chaîne de caractères qui prouve que vous êtes propriétaire du domaine. Notez que la clé doit être hébergée sur votre serveur pour être vérifiée.
- L’endpoint de l’API, tel que yandex.com/indexnow.
- L’en-tête content-type doit être défini sur application/json.
- Un corps JSON contenant l’hôte, la clé et une liste d’URL.
- Le keyLocation, qui spécifie le chemin d’accès à votre fichier de vérification.
La requête peut être envoyée en tant que POST ou GET. La méthode POST est privilégiée pour regrouper plusieurs URL par lots. Lors de l’utilisation de POST, le corps de la requête contient les données dans un format structuré. La méthode GET est plus simple mais ne prend en charge qu’une seule URL à la fois. La plupart des développeurs choisissent POST pour son efficacité.
Nous constatons que de nombreux développeurs oublient de faire correspondre exactement la clé entre le corps de l’API et le fichier texte. Une simple différence de caractère ou un espace supplémentaire entraînera l’échec immédiat de la vérification.
Équipe SEO d’Alien Road
Quels sont les composants clés pour la validation ?
La sécurité est gérée via un fichier texte placé dans le répertoire racine. Ce fichier contient la même chaîne de clé que celle utilisée dans l’appel API. Les moteurs de recherche vérifient la requête en récupérant ce fichier sur votre serveur. Si la clé de la requête correspond à la clé du fichier sur votre serveur, la requête est authentifiée.
La clé elle-même doit comporter au moins 8 caractères, mais l’utilisation d’une chaîne alphanumérique de 32 caractères est une norme plus fiable. Vous devez nommer le fichier texte d’après la clé. Par exemple, si votre clé est ‘abc123’, votre fichier doit être ‘abc123.txt’. Cela permet au moteur de recherche de le trouver sans deviner.
Comment gérer les erreurs courantes de réponse de l’API ?
À l’instar des erreurs de flux RSS mentionnées dans la documentation technique, les requêtes IndexNow échouent si la syntaxe est erronée. Un code 400 Bad Request signifie généralement que le format JSON n’est pas valide ou qu’un champ obligatoire est manquant. Un code 403 Forbidden suggère que la clé est incorrecte ou que le fichier de clé ne peut pas être atteint par le crawler. Notez que l’hygiène technique est essentielle au succès.
- 400 : Syntaxe invalide. Vérifiez l’absence de guillemets ou de virgules manquants dans votre JSON.
- 403 : Échec de la vérification de la clé. Vérifiez que le fichier se trouve dans le répertoire racine.
- 422 : L’URL n’appartient pas à l’hôte spécifié dans la requête.
- 429 : Trop de requêtes. Réduisez la fréquence de vos appels API.
Si vous voyez une erreur 403, vérifiez si votre serveur bloque l’agent utilisateur du moteur de recherche. Parfois, les pare-feu empêchent le crawler de récupérer le fichier de clé. Vous devez autoriser l’accès à l’URL de vérification spécifique pour maintenir une connexion fluide entre votre site et le moteur de recherche.
Comment Alien Road applique la référence de requête API indexnow
Chez Alien Road, nous intégrons l’API IndexNow dans le workflow CMS de nos clients. Pour un site e-commerce typique comptant des milliers de produits, l’indexation manuelle est impossible. Nous configurons un déclencheur automatisé qui s’active chaque fois que le prix d’un produit change ou qu’un nouvel article est ajouté. Cela garantit que le moteur de recherche dispose des données les plus récentes sans délai.
Dans le cadre d’une prestation typique, nous générons d’abord une clé unique et la plaçons à la racine du serveur client. Nous configurons ensuite leur backend pour regrouper les URL par lots et les envoyer à l’endpoint Yandex toutes les heures. Cela évite de surcharger le serveur tout en garantissant que les baisses de prix ou les mises à jour de stock apparaissent dans les résultats de recherche en quelques minutes. Pour une boutique Shopify vendant des articles pour la maison, ce processus maintient leurs données d’inventaire précises pour les clients potentiels.
L’utilisation d’IndexNow pour des migrations à grande échelle est une stratégie solide. Au lieu d’attendre des semaines qu’un changement de site soit reconnu, nous poussons les nouvelles URL directement, ce qui aide à maintenir la stabilité du trafic pendant la transition.
Équipe SEO d’Alien Road
Spécifications techniques et limites
Bien que l’API soit puissante, elle possède des limites que vous devez respecter. Vous ne pouvez pas soumettre plus de 10 000 URL dans une seule requête POST. De plus, les URL doivent toutes appartenir au même hôte. Si vous gérez plusieurs sous-domaines, chacun nécessite sa propre clé et son propre appel API pour être traité correctement.
Le formatage de la charge utile JSON est strict. Tout comme les exigences pour les flux d’actualités, les URL dans IndexNow doivent être absolues et pleinement qualifiées. Elles doivent utiliser le bon protocole, soit HTTP, soit HTTPS. Les caractères spéciaux doivent être correctement échappés à l’aide de l’encodage UTF-8. Un guillemet supplémentaire ou un attribut mal fermé arrêtera l’indexation de l’ensemble du lot.
Comparaison d’IndexNow avec les sitemaps XML
Les sitemaps XML sont des fichiers passifs que les moteurs de recherche consultent occasionnellement. IndexNow est un système de notification active. Bien que vous deviez toujours conserver un sitemap pour une visibilité complète de la structure du site, l’API est le meilleur choix pour les mises à jour urgentes. L’utilisation conjointe des deux méthodes offre une stratégie d’indexation complète.
Les sitemaps peuvent parfois devenir très volumineux, ce qui entraîne des temps de traitement lents. IndexNow évite cela en se concentrant uniquement sur ce qui a changé récemment. Cette approche ciblée est plus efficace à la fois pour votre serveur et pour les ressources du moteur de recherche. Elle réduit la nécessité pour le crawler de visiter à plusieurs reprises des pages inchangées.
Par où commencer cette semaine
Commencez par vérifier si votre CMS dispose d’un plugin IndexNow natif. Si ce n’est pas le cas, générez une clé de 32 caractères et téléchargez-la à la racine de votre serveur sous forme de fichier .txt. Testez une seule URL à l’aide d’un simple outil en ligne de commande pour vérifier que vous recevez une réponse 200 OK. Une fois la connexion vérifiée, automatisez le processus pour toutes les nouvelles mises à jour de contenu afin de garder votre présence sur les moteurs de recherche fraîche.
Surveillez les journaux de votre serveur pour détecter la visite du moteur de recherche après l’envoi d’une requête. Cela confirme que le système fonctionne. Si vous remarquez des erreurs, reportez-vous à la liste des codes d’erreur et vérifiez la syntaxe de votre JSON pour détecter les erreurs courantes telles que les caractères non échappés ou les accolades manquantes.