Protokol IndexNow

IndexNow je snadný způsob, jak mohou vlastníci webových stránek okamžitě informovat vyhledávače o nejnovějších změnách obsahu na jejich webové stránce. Více informací najdete na stránce Indexnow.org.

Pro hromadné informování vyhledávače o nových nebo změněných URL už Seznam provozuje funkci přidat URL do hledání v rámci nástroje Seznam Webmaster. Zatímco Seznam Webmaster poskytuje limitované API, které zaručuje přidat do indexu až 500 URL denně se zpožděním v řádu minut, IndexNow API není počtem URL limitované. Zaslání URL adresy do IndexNow je bráno pouze jako informace, se kterou algoritmy vyhledávače dále pracují. Není tedy zaručené, že dojde ke stažení URL robotem a k indexaci. URL u kterých algoritmy vyhledávače rozhodnou o indexaci se do výsledků dostanou do týdne. Nezávisle na rozhodnutí o stažení nebo indexaci URL jsou ostatní zapojené vyhledávače informovány hned po ověření klíče, který ve volání API s URL přišel.

Aby se web zapojil do protokolu IndexNow u Seznamu, stačí umístit IndexNow klíč na web a začít zasílat změněné URL buď jednotlivě GET požadavkem, nebo hromadně POST požadavkem. V případě nejasností si prosím přečtěte odpovědi na nejčastější otázky k IndexNow.

IndexNow klíč

Chcete-li odesílat adresy URL, potřebujeme si ověřit, že jste vlastníkem webu, pro který odesíláte data. Pro ověření se použije speciální klíč. Ten je potřeba vygenerovat a umístit soubor, který jej obsahuje, na svůj web. Seznam.cz stáhne a zkontroluje klíč při správném požadavku na API. Validovaný klíč se následně drží v cache a nestahuje se s úplně každým dotazem. Nejvýše po 24 hodinách se znovu zkontroluje. Vygenerovat klíč si můžete snadno sami. Stačí pouze dodržet několik podmínek.

Požadavky na klíč

• Podporováno je pouze kódování UTF-8.
• Minimální počet znaků v klíči je 8, maximální je 128.
• Klíč může obsahovat znaky a-z, A-Z, 0-9, -.
• Použijte soubor TXT nebo jiný formát s textovými daty.
• Soubor nesmí obsahovat značky HTML nebo data navíc jako například BOM.

Umístění klíče

Klíč může být umístěn v root webserveru nebo ve složce.

1. Root adresář (doporučená možnost). V tomto případě musí mít soubor s klíčem název klíč+“.txt“. Například pro klíč „myIndexNowKey63638“ bude název a umístění souboru vypadat takto: https://www.example.com/myIndexNowKey63638.txt
2. Ve složce vašeho webu. V případě této možnosti musíte v každém požadavku API odeslat umístění souboru v proměnné keyLocation. Požadavek s klíčem může obsahovat pouze stránky umístěné ve stejném adresáři a podadresáři jako klíč. Soubor klíče umístěný například na URL https://example.com/catalog/key12457EDd.txt lze použít pro odeslání URL začínajících https://example.com/catalog/, ale nelze s ním odesílat adresy URL začínající https://example.com/help/.

Odeslání jedné stránky

Chcete-li odeslat jednu URL adresu pomocí požadavku HTTP, zadejte svůj požadavek na následující adresu URL:

https://search.seznam.cz/indexnow?url=url&key=klic

GET https://search.seznam.cz/indexnow
 ? url=<String>
 & key=<String>
 & [keyLocation=<String>]

Kde:

• url je adresa URL vašeho webu, která byla přidána, aktualizována nebo odstraněna. Adresa URL musí být URL-escaped a zakódována. Dále se ujistěte, že vaše adresy URL odpovídají standardu RFC-3986 pro identifikátory URI.
• keyLocation je URL uložení vašeho klíče.

HTTP/1.1 200 Ok
Content-Type: text/plain; charset=utf-8

Tabulka ostatních návratových kódu (API vrací text v angličtině):

Kód	Důvod	Popis
403	Špatný klíč	Klíč se nepodařilo načíst nebo neodpovídá adresám URL uvedeným v požadavku.
405	Metoda není povolena	Jsou podporovány metody GET a POST.
422	Nevalidní parametr url	Požadavek obsahuje neplatnou adresu URL, nebo předaný klíč není vhodný pro jeho zpracování.
422	Nevalidní parametr key location	Parametr keyLocation je zadán nesprávně.
422	Klíč musí mít alespoň 8 znaků	Klíč musí mít alespoň 8 znaků.
422	Klíč obsahuje více než 128 znaků	Klíč obsahuje více než 128 znaků.
422	Klíč se musí skládat poze ze znaků a-z, A-Z, 0-9 nebo –	Klíč obsahuje neplatné znaky.
422	Nebyl poskytnut žádný klíč	V požadavku chybí klíč.
422	Nebyla zadána žádná adresa URL	V požadavku chybí parametr url.
429	Příliš mnoho požadavků	Byl překročen počet požadavků na jednu IP adresu.

Odeslání více stránek jedním požadavkem

Chcete-li odeslat více URL adres pomocí požadavku HTTP, zadejte svůj požadavek na následující adresu URL:

POST https://search.seznam.cz/indexnow

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

Kde:

Parametr	Typ	Vyžadováno	Popis
host	Řetězec	Ano	URL vaší stránky
key	Řetězec	Ano	Klíč pro verifikaci
keyLocation	Řetězec	Ne	Umístění klíče na serveru
urlList	Pole	Ano	Seznam URL adres

HTTP/1.1 200 Ok
Content-Type: text/plain; charset=utf-8

Tabulka ostatních návratových kódu (API vrací text v angličtině):

Kód	Důvod	Popis
400	Špatné parametry	V požadavku byly odeslány nesprávné parametry.
403	Špatný klíč	Klíč se nepodařilo načíst nebo neodpovídá adresám URL uvedeným v požadavku.
405	Metoda není povolena	Jsou podporovány metody GET a POST.
422	Nevalidní parametr url	Požadavek obsahuje neplatnou adresu URL nebo předaný klíč není vhodný pro jeho zpracování.
422	Nevalidní parametr key location	Parametr keyLocation je zadán nesprávně.
422	Klíč musí mít alespoň 8 znaků	Klíč musí mít alespoň 8 znaků.
422	Klíč obsahuje více než 128 znaků.	Klíč obsahuje více než 128 znaků.
422	Klíč se musí skládat poze ze znaků a-z, A-Z, 0-9 nebo –	Klíč obsahuje neplatné znaky.
422	Nebyl poskytnut žádný host	V požadavku chybí host.
422	Nebyl poskytnut žádný klíč	V požadavku chybí klíč.
422	Nebyla zadána žádná adresa URL	V požadavku chybí parametr url.
422	Ne více než 10 000 URL	Parametr urlList obsahuje více než 10 000 adres URL.
422	Url list musí být pole	Chybí parametr urlList nebo se nejedná o pole.
422	Url list je prázdný	Parametr urlList je prázdný.
422	Url list musí obsahovat řetězce	Parametr urlList musí obsahovat pouze řetězce.
429	Příliš mnoho požadavků	Byl překročen počet požadavků na jednu IP adresu.

Nejčastější dotazy