Documentație

Remiterea unui URL


Pentru remiterea unui URL printr-o cerere HTTP (înlocuiți cu URL-ul furnizat de motorul de căutare), trimiteți cererea dvs. la următorul URL:

                https://<searchengine>/indexnow?url=url-changed&key=your-key
            
  • url-changed este un URL de pe site-ul dvs. web care a fost adăugat, actualizat sau șters. URL trebuie să fie un URL cu escape aplicat și codificat; asigurați-vă cu URL-urile dvs. respectă standardul RFC-3986 pentru URI-uri.
  • Your-key trebuie să aibă minim 8 și maxim 128 caractere hexazecimale. Cheia poate conține doar următoarele caractere: minuscule (a-z), majuscule (A-Z), cifre (0-9) și cratime (-).

De exemplu,dacă doriți să notificați motoarele de căutare care https://www.example.com/product.html au fost actualizate și doriți să utilizați această cheie , URL-ul dvs. va fi:

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

Puteți emite cererea HTTP utilizând browser-ul dvs., wget, curl sau orice mecanism ales de dvs. O cerere de succes va returna un cod de răspuns HTTP 200; dacă primiți un răspuns diferit, asigurați-vă că nu remiteți prea des și că URL-ul și cheia sunt valide, apoi remiteți cererea din nou. Codul de răspuns HTTP 200 indică numai că motorul de căutare a primit URL-ul dvs.

Remiterea seturilor de URL-uri


Pentru a remite un set de URL-uri utilizând o cerere HTTP, emiteți cererea dvs. POST JSON către URL-ul furnizat de motoarele de căutare. Înlocuiți cu numele de gazdă al motorului de căutare.

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

Puteți remite până la 10.000 URL-uri per postare, amestecând URL-uri http și https, dacă este necesar.

Puteți emite cererea HTTP utilizând wget, curl sau alt mecanism ales de dvs. O cerere de succes va returna un cod de răspuns HTTP 200; dacă primiți un răspuns diferit, ar trebui să vă verificați cererea și, dacă totul pare în regulă, să o remiteți din nou. Codul de răspuns HTTP 200 indică numai că motorul de căutare a primit setul dvs. de URL-uri.

Calea recomandată este automatizarea remiterii URL-urilor imediat ce conținutul este adăugat, actualizat sau șters într-o anumită limită; consultați cele mai bune practici pentru conținut generat de utilizator în Întrebări frecvente.

Verificarea proprietății prin intermediul cheii


Pentru a remite URL-uri, trebuie să „dovediți” că sunteți proprietarul gazdei pentru care sunt remise URL-uri, prin găzduirea a cel puțin un fișier text în gazdă. După ce vă remiteți URL-urile la motoarele de căutare, motoarele de căutare vor accesa cu crawlere fișierul cheie pentru a verifica proprietatea și a utiliza cheia, până când o modificați. Doar dvs. și motoarele de căutare ar trebui să știți cheia și localizarea fișierului dvs. cheie.

Vă oferim două căi de a verifica proprietatea.

Opțiunea 1
Găzduirea unui fișier cheie text în directorul rădăcină al gazdei dvs.

Trebuie să găzduiți un fișier cheie text codificat UTF-8 {your-key}.txt care listează cheia în fișierul din directorul rădăcină al site-ului dvs. web.

De exemplu, pentru exemplele anterioare, va trebui să găzduiți fișierul dvs. cheie UTF-8 la https://www.example.com/.txt, iar acest fișier trebuie să conțină cheia

Opțiunea 2
Găzduirea unui fișier cheie text în gazda dvs.

Puteți și să găzduiți unul sau mai multe fișiere cheie text codificat UTF-8 în alte locații din aceeași gazdă și trebuie să comunicați motoarelor de căutare localizarea acestui fișier cheie text în fiecare notificare IndexNow prin specificarea localizării utilizând variabila keyLocation.

Dacă remiteți un URL, specificați localizarea de fișier cheie drept valoare de parametru URL-uri keyLocation.

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

Dacă remiteți un set de URL-uri, specificați localizarea fișierului cheie ca variabilă keyLocation în conținutul JSON.

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

În această opțiune 2, localizarea fișierului cheie determină setul de URL-uri care poate fi inclus în această cheie. Un fișier cheie localizat la http://example.com/catalog/key12457EDd.txt poate include orice URL-uri care încep cu http://example.com/catalog/, dar nu poate include URL-urile începând cu http://example.com/help/.

URL-urile care nu sunt considerate valide în http://example.com/catalog/sitemap.xml includ:

URL-urile care nu sunt considerate valide în opțiunea 2 pot fi luate în considerare la indexare. Vă recomandăm cu tărie să utilizați Opțiunea 1 și să plasați cheia dvs. de fișier în directorul rădăcină al serverului web.

Response format


HTTP Code
Response
Reasons
200
OK
URL submitted successfully
202
Accepted
URL received. IndexNow key validation pending.
400
Bad request
Invalid format
403
Forbidden
In case of key not valid (e.g. key not found, file found but key not in the file)
422
Unprocessable Entity
In case of URLs which don’t belong to the host or the key is not matching the schema in the protocol
429
Too Many Requests
Too Many Requests (potential Spam)

Requirement for search engines


Search engines adopting the IndexNow protocol agree that submitted URLs will be automatically shared with all other participating search engines. To participate, search engines must have a noticeable presence in at least one market or be closely linked to the search market and make a significant contribution to the number of url submissions. Learn more