Documentação

Enviar uma URL

Para enviar uma URL usando uma solicitação HTTP (substitua pela URL fornecida pelo mecanismo de pesquisa), emita sua solicitação para a seguinte URL:

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

• url-changed é uma URL de seu site que foi adicionada, atualizada ou excluída. A URL deve ter escape de URL e codificação. Verifique se as URLs seguem o padrão RFC-3986 para URIs.
• A chave deve ter no mínimo 8 e no máximo 128 caracteres hexadecimais. A chave só pode conter os seguintes caracteres: caracteres minúsculos (a-z), caracteres maiúsculos (A-Z), números (0-9) e traços (-).

Por exemplo, se você desejar notificar os mecanismos de pesquisa de que https://www.example.com/product.html foi atualizado e desejar usar esta chave , a URL será:

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

Você pode emitir a solicitação HTTP usando seu navegador, wget, curl ou qualquer outro mecanismo de sua escolha. Uma solicitação bem-sucedida retornará um código de resposta HTTP 200. Se você receber uma resposta diferente, verifique se não envia com muita frequência e se a chave e a URL são válidos e reenvie a solicitação. O código de resposta HTTP 200 indica apenas que o mecanismo de pesquisa recebeu a URL.

Enviar um conjunto de URLs

Para enviar um conjunto de URLs usando uma solicitação HTTP, emita a solicitação POST JSON para a URL fornecida pelos mecanismos de pesquisa. Substitua pelo nome do host do mecanismo de pesquisa.

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

Você pode enviar até 10.000 URLs por postagem, combinando URLs http e https, se necessário.

Você pode emitir a solicitação HTTP usando wget, curl ou outro mecanismo de sua escolha. Uma solicitação bem-sucedida retornará um código de resposta HTTP 200. Se receber uma resposta diferente, você deverá verificar a solicitação e, se tudo estiver certo, reenviá-la. O código de resposta HTTP 200 indica apenas que o mecanismo de pesquisa recebeu o conjunto de URLs.

A maneira recomendada é automatizar o envio de URLs assim que o conteúdo for adicionado, atualizado ou excluído até certo limite. Consulte as práticas recomendadas para conteúdo gerado pelo usuário nas Perguntas Frequentes.

Verificar a propriedade por meio da chave

Para enviar URLs, você deve "provar" a propriedade do host para o qual as URLs estão sendo enviadas, hospedando pelo menos um arquivo de texto no host. Depois que você enviar as URLs aos mecanismos de pesquisa, eles rastrearão o arquivo da chave para verificar a propriedade e usarão a chave até que você a altere. Apenas você e os mecanismos de pesquisa devem saber a chave e a localização da chave do arquivo.

Oferecemos duas maneiras 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"
                          ]
                    }