IndexNow API istek kılavuzu; web sitesi sahiplerinin yeni, güncellenmiş veya silinmiş içerikleri Yandex gibi arama motorlarına anında bildirmesini sağlayan teknik bir protokoldür. Sayfa URL’si ve benzersiz bir anahtar içeren basit bir HTTP isteği göndererek, arama botlarının standart tarama döngüsünü beklemeden en son değişikliklerinize öncelik vermesini sağlarsınız. Bu yöntem, sunucu yükünü hafifletir ve web üzerindeki güncel bilgilerin keşfedilme sürecini hızlandırır.
IndexNow API nedir ve neden önemlidir?
Geleneksel tarama, arama motorlarının kendi hızlarında bağlantıları keşfetmesine veya site haritalarını kontrol etmesine dayanır. Bu durum genellikle içerik yayınlama ile dizine eklenme arasında bir boşluk yaratır. IndexNow, kontrolü web sitesi sahibine geri vererek bunu değiştirir. Arama motoruna bir sayfanın hazır olduğunu söylersiniz ve o da bir ziyaret planlayarak yanıt verir.
Bu protokol, özellikle her gün birçok sayfa yayınlayan siteler için oldukça faydalıdır. Örneğin bir haber portalı veya büyük bir e-ticaret sitesi, en yeni verilerinin olabildiğince çabuk arama sonuçlarında görünmesine ihtiyaç duyar. Bu API olmadan, yeni bir makalenin standart bir tarayıcı tarafından keşfedilmesi saatler veya günler sürebilir.
Geçerli bir IndexNow API isteği nasıl yapılandırılır?
Standart bir istek üç ana öğe gerektirir: ana bilgisayar (host), URL listesi ve anahtar (key). Ana bilgisayar, değişikliklerin gerçekleştiği etki alanı adıdır. URL listesi, tekli güncellemeler yaygın olsa da, istek başına 10.000’e kadar bağlantı içerebilir. Anahtar, etki alanına sahip olduğunuzu kanıtlayan bir dizedir. Doğrulanabilmesi için anahtarın sunucunuzda barındırılması gerektiğini unutmayın.
- yandex.com/indexnow gibi API uç noktası.
- Content-type üst bilgisi application/json olarak ayarlanmalıdır.
- Ana bilgisayarı, anahtarı ve URL listesini içeren bir JSON gövdesi.
- Doğrulama dosyanızın yolunu belirten keyLocation.
İstek POST veya GET olarak gönderilebilir. Birden fazla URL’yi toplu halde işlemek için POST yöntemi tercih edilir. POST kullanıldığında, isteğin gövdesi verileri yapılandırılmış bir biçimde içerir. GET yöntemi daha basittir ancak aynı anda yalnızca tek bir URL’yi destekler. Çoğu geliştirici verimliliği nedeniyle POST’u seçer.
Birçok geliştiricinin, API gövdesi ile metin dosyası arasındaki anahtarı tam olarak eşleştirmeyi unuttuğunu fark ediyoruz. Tek bir karakterlik fark veya fazladan bir boşluk, doğrulamanın anında başarısız olmasına neden olur.
Alien Road SEO ekibi
Doğrulama için temel bileşenler nelerdir?
Güvenlik, kök dizine yerleştirilen bir metin dosyası aracılığıyla sağlanır. Bu dosya, API çağrısında kullanılan anahtar dizesinin aynısını içerir. Arama motorları, bu dosyayı sunucunuzdan çekerek isteği doğrular. İsteğin içindeki anahtar, sunucunuzdaki dosyanın içindeki anahtarla eşleşirse istek kimlik doğrulamasından geçer.
Anahtarın kendisi en az 8 karakter uzunluğunda olmalıdır, ancak 32 karakterlik alfasayısal bir dize kullanmak daha güvenilir bir standarttır. Metin dosyasını anahtarın adıyla adlandırmalısınız. Örneğin, anahtarınız ‘abc123’ ise dosyanız ‘abc123.txt’ olmalıdır. Bu, arama motorunun tahmin yürütmeden onu bulmasını sağlar.
Yaygın API yanıt hataları nasıl ele alınır?
Teknik belgelerde bahsedilen RSS akışı hataları gibi, sözdizimi yanlışsa IndexNow istekleri başarısız olur. 400 Bad Request genellikle JSON biçiminin geçersiz olduğunu veya zorunlu bir alanın eksik olduğunu gösterir. 403 Forbidden, anahtarın yanlış olduğunu veya anahtar dosyasına tarayıcı tarafından erişilemediğini gösterir. Teknik hijyenin başarı için hayati önem taşıdığını unutmayın.
- 400: Geçersiz sözdizimi. JSON’ınızda eksik tırnak işaretleri veya virgüller olup olmadığını kontrol edin.
- 403: Anahtar doğrulaması başarısız oldu. Dosyanın kök dizinde olduğunu doğrulayın.
- 422: URL, istekte belirtilen ana bilgisayara ait değil.
- 429: Çok fazla istek. API çağrılarınızın sıklığını azaltın.
Bir 403 hatası görürseniz, sunucunuzun arama motorunun kullanıcı aracısını (user agent) engellediğini kontrol edin. Bazen güvenlik duvarları tarayıcının anahtar dosyasını çekmesini engeller. Siteniz ile arama motoru arasındaki akıcı bağlantıyı korumak için belirli doğrulama URL’sine erişime izin vermelisiniz.
Alien Road, indexnow api istek referansını nasıl uygular
Alien Road olarak, müşterilerimiz için IndexNow API’sini CMS iş akışına entegre ediyoruz. Binlerce ürünü olan tipik bir e-ticaret sitesi için manuel dizine ekleme imkansızdır. Bir ürün fiyatı her değiştiğinde veya yeni bir ürün eklendiğinde tetiklenen otomatik bir kural (trigger) kuruyoruz. Bu, arama motorunun gecikmeden en güncel verilere sahip olmasını sağlar.
Tipik bir çalışmada, önce benzersiz bir anahtar oluşturur ve bunu müşteri sunucusunun kök dizinine yerleştiririz. Ardından, arka uçlarını URL’leri toplu hale getirecek ve her saat başı Yandex uç noktasına gönderecek şekilde yapılandırırız. Bu, sunucunun aşırı yüklenmesini önlerken fiyat düşüşlerinin veya stok güncellemelerinin arama sonuçlarında dakikalar içinde görünmesini sağlar. Ev eşyaları satan bir Shopify mağazası için bu süreç, envanter verilerini potansiyel müşteriler için doğru tutar.
Büyük ölçekli geçişler için IndexNow kullanmak güçlü bir stratejidir. Bir site taşınmasının fark edilmesini haftalarca beklemek yerine, yeni URL’leri doğrudan göndeririz; bu da geçiş sırasında trafik istikrarını korumaya yardımcı olur.
Alien Road SEO ekibi
Teknik özellikler ve sınırlar
API güçlü olsa da, saygı duymanız gereken sınırları vardır. Tek bir POST isteğinde 10.000’den fazla URL gönderemezsiniz. Ek olarak, URL’lerin tümü aynı ana bilgisayara ait olmalıdır. Birden fazla alt alan adını (subdomain) yönetiyorsanız, doğru şekilde işlenebilmesi için her biri kendi anahtarına ve kendi API çağrısına ihtiyaç duyar.
JSON yükünün (payload) biçimlendirilmesi katıdır. Haber akışları gereksinimlerine çok benzer şekilde, IndexNow’daki URL’ler mutlak ve tam nitelikli olmalıdır. HTTP veya HTTPS gibi doğru protokolü kullanmalıdırlar. Özel karakterler UTF-8 kodlaması kullanılarak uygun şekilde kaçış karakterleriyle (escaped) düzenlenmelidir. Fazladan bir tırnak işareti veya yanlış kapatılmış bir öznitelik, tüm partinin dizine eklenmesini durduracaktır.
IndexNow’ı XML Site Haritaları ile Karşılaştırma
XML site haritaları, arama motorlarının ara sıra kontrol ettiği pasif dosyalardır. IndexNow ise aktif bir bildirim sistemidir. Eksiksiz site yapısı görünürlüğü için yine de bir site haritası bulundurmanız gerekse de, API zamana duyarlı güncellemeler için daha iyi bir seçimdir. Her iki yöntemi birlikte kullanmak eksiksiz bir dizine ekleme stratejisi sağlar.
Site haritaları bazen çok büyüyebilir ve bu da yavaş işleme sürelerine neden olabilir. IndexNow, yalnızca yakın zamanda neyin değiştiğine odaklanarak bundan kaçınır. Bu hedef odaklı yaklaşım, hem sunucunuz hem de arama motorunun kaynakları için daha verimlidir. Tarayıcının değişmemiş sayfaları tekrar tekrar ziyaret etme ihtiyacını azaltır.
Bu hafta nereden başlamalı
CMS’nizde yerleşik bir IndexNow eklentisi olup olmadığını kontrol ederek başlayın. Yoksa, 32 karakterlik bir anahtar oluşturun ve bunu bir .txt dosyası olarak sunucu kök dizininize yükleyin. 200 OK yanıtı aldığınızı doğrulamak için basit bir komut satırı aracı kullanarak tek bir URL’yi test edin. Bağlantıyı doğruladıktan sonra, arama varlığınızı taze tutmak için tüm yeni içerik güncellemeleri için süreci otomatikleştire.
Bir istek gönderdikten sonra arama motorunun ziyareti için sunucu günlüklerinizi (logs) izleyin. Bu, sistemin çalıştığını doğrular. Hatalar fark ederseniz, hata kodu listesine geri dönün ve kaçış karakteri unutulmuş karakterler veya eksik parantezler gibi yaygın hatalar için JSON sözdiziminizi kontrol edin.