Documentação

Submeter Um URL

Para submeter um URL através de um pedido de HTTP (substitua pelo URL fornecido pelo motor de busca), emita o pedido para o seguir URL:

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

• url-changed é um URL no seu site que foi adicionado, atualizado ou eliminado. O URL tem de ser um URL com escape codificado. Certifique-se de que os seus URLs estão em conformidade com a norma RFC-3986 para URIs.
• your-key deve ter um mínimo de 8 e um máximo de 128 carateres hexadecimais. A chave só pode conter os seguintes carateres: carateres em minúsculas (a-z), carateres em maiúsculas (A-Z), números (0-9) e traços (-).

Por exemplo, se pretender notificar os motores de busca sobre a atualização de https://www.example.com/product.html e pretender utilizar esta chave , o seu URL será:

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

Pode emitir o pedido de HTTP através do browser, wget, curl ou qualquer outro mecanismo da sua preferência. Um pedido com êxito irá devolver um código de resposta HTTP 200, Se receber uma resposta diferente, verifique se não o submeteu demasiadas vezes e se a chave e o URL são válidos. Em seguida, volte a submeter o pedido. O código de resposta HTTP 200 indica apenas que o motor de busca recebeu o seu URL.

Submeter conjuntos de URLs

Para submeter um conjunto de URLs através de um pedido de HTTP, emita o seu pedido POST JSON para o URL fornecido pelos Motores de Busca. Substitua pelo nome do anfitrião do motor de busca.

                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"
                      ]
                }
            

Pode submeter até 10.000 URLs por publicação e, se necessário, incluir URLs http e https.

Pode emitir o pedido de HTTP através de wget, curl ou outro mecanismo da sua preferência. Um pedido com êxito irá devolver um código de resposta HTTP 200. Se receber uma resposta diferente, deve verificar o pedido e, caso não encontre nenhum problema, volte a submetê-lo. O código de resposta HTTP 200 indica apenas que o motor de busca recebeu o seu conjunto de URLs.

A forma recomendada é automatizar a submissão de URLs assim que o conteúdo for adicionado, atualizado ou eliminado até um determinado limite. Consulte as melhores práticas para conteúdo gerado pelo utilizador nas Perguntas Mais Frequentes.

Verificar a propriedade através da chave

Para submeter URLs, tem de "provar" a propriedade do anfitrião para o qual os URLs estão a ser submetidos ao alojar, pelo menos, um ficheiro de texto no anfitrião. Depois de submeter os seus URLs nos motores de busca, estes pesquisam o ficheiro de chave para verificarem a propriedade e utilizarem a chave até que a altere. A chave e a localização do ficheiro de chave só devem ser conhecidas por si e pelos motores de busca.

Disponibilizamos duas formas de verificar a propriedade.

                    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"
                          ]
                    }