Documentation

Soumettre une URL

Pour soumettre une URL à l’aide d’une requête HTTP (remplacer par l’URL fournie par le moteur de recherche), envoyez votre requête vers l’URL suivante :

                https://<searchengine>/indexnow?url=url-changed&key=your-key
            

• url-changed est l’URL de votre site Web qui a été ajoutée, mise à jour ou supprimée. L’URL doit être une URL contenant une séquence d’échappement et encodée. Veillez à ce que vos URL respectent la norme RFC-3986 pour les URI.
• Vous devez avoir 8 caractères hexadécimaux au minimum et 128 caractères hexadécimaux au maximum. La clé doit contenir uniquement les caractères suivants : caractères en minuscule (a-z), caractères en majuscule (A-Z), chiffres (0-9) et tirets (-).

Par exemple, si vous souhaitez signaler aux moteurs de recherche que la page https://www.exemple.org/product.html a été mise à jour et que vous souhaitez utiliser cette clé , votre URL sera la suivante :

                https://<searchengine>/indexnow?url=https://www.example.com/product.html&key=
            

Vous pouvez envoyer la requête HTTP à l’aide de votre navigateur, d’une commande wget, curl ou d’un autre mécanisme de votre choix. Une requête qui aboutit renverra un code de réponse HTTP 200 ; si vous recevez une autre réponse, vérifiez que vous ne l’envoyez pas trop souvent, que la clé et l’URL sont valides et soumettez à nouveau la requête. Le code de réponse HTTP 200 indique uniquement que le moteur de recherche a reçu votre URL.

Soumettre un ensemble d’URL

Pour soumettre un ensemble d’URL à l’aide d’une requête HTTP, envoyez votre requête POST en JSON vers l’URL fournie par les moteurs de recherche. Remplacez par le nom d’hôte du moteur de recherche.

                POST /indexnow HTTP/1.1
                Content-Type: application/json; charset=utf-8
                Host: <searchengine>
                {
                  "host": "www.example.com",
                  "key": "",
                  "urlList": [
                      "https://www.example.com/url1",
                      "https://www.example.com/folder/url2",
                      "https://www.example.com/url3"
                      ]
                }
            

Vous pouvez soumettre jusqu’à 10 000 URL par requête post, en combinant des URL http et https si nécessaire.

Vous pouvez envoyer la requête HTTP à l’aide d’une commande wget, curl ou d’un autre mécanisme de votre choix. Une requête qui aboutit renverra un code de réponse HTTP 200 ; si vous recevez une autre réponse, vérifiez votre requête et si elle semble correcte, soumettez-la à nouveau. Le code de réponse HTTP 200 indique uniquement que le moteur de recherche a reçu votre ensemble d’URL.

Il est recommandé d’automatiser la soumission des URL dès que le contenu est ajouté, mis à jour ou supprimé jusqu’à une certaine limite. Reportez-vous aux meilleures pratiques pour le contenu généré par les utilisateurs dans le forum aux questions.

Vérifier la propriété via la clé

Pour soumettre des URL, vous devez « prouver » la propriété de l’hôte pour lequel les URL sont soumises en hébergeant au moins un fichier texte au sein de l’hôte. Lorsque vous soumettez vos URL aux moteurs de recherche, ces derniers analysent le fichier de clé pour vérifier la propriété et utilisent la clé jusqu’à ce que vous la modifiiez. Seuls vous et les moteurs de recherche doivent connaître la clé et l’emplacement du fichier de clé.

Nous proposons deux moyens de vérifier la propriété :

                    https://<searchengine>/indexnow?url=http://www.example.com/product.html&key=&keyLocation=http://www.example.com/myIndexNowKey63638.txt
                

                    POST /indexnow HTTP/1.1
                    Content-Type: application/json; charset=utf-8
                    Host: <searchengine>
                    {
                      "host": "www.example.com",
                      "key": "",
                      "keyLocation": "https://www.example.com/myIndexNowKey63638.txt",
                      "urlList": [
                          "https://www.example.com/url1",
                          "https://www.example.com/folder/url2",
                          "https://www.example.com/url3"
                          ]
                    }