Alan Adı Araştırması API

Domain Research API, bir alan adının organik aramadaki görünürlüğünü programatik olarak sorgulamanızı sağlayan bir arayüzdür. Bir SEO aracını açıp alan adını elle girmek yerine, kendi uygulamanızdan tek bir HTTP isteğiyle o alan adının sıralandığı kelimeleri, rakiplerini ve trafik tahminini yapılandırılmış JSON olarak alırsınız. SEO araçları geliştiren ekipler, ajanslar ve kendi raporlama altyapısını kuran şirketler için temel bir yapı taşıdır.

Semust Domain Research API tek bir endpoint üzerinden çalışır: data.semust.com/v1/domain-research adresine gönderdiğiniz POST isteğinde type parametresiyle sekiz rapordan hangisini istediğinizi belirtirsiniz. Kimlik doğrulama header tabanlıdır. Alan adını https://, www. ya da bir yolla birlikte gönderseniz de otomatik temizlenir; örnek.com.tr gibi Türkçe karakterli alan adları da kabul edilir.

Arama sonuçlarındaki rakipleriniz, iş dünyasındaki rakiplerinizle her zaman aynı değildir. Bir haber sitesi, bir forum ya da bir sözlük, hedeflediğiniz kelimelerde sizden önce sıralanıyor olabilir. competitors raporu aynı kelimeler için yarışan alan adlarını ortak kelime sayısına göre sıralar ve her biri için ortak kelimelerdeki ortalama pozisyonu, toplam kelime sayısını ve tahmini trafiği verir.

Araştırdığınız alan adının kendisi bu listede hiçbir zaman yer almaz. Liste çoğu zaman sektördeki gerçek arama rakiplerini kendi tahmininizden daha net gösterir ve kelime açığı analizinin doğal başlangıç noktasıdır: listeden seçtiğiniz bir rakibi doğrudan keyword_gap raporuna verebilirsiniz.

keywords raporu alan adının sıralandığı kelimeleri hacim, CPC, zorluk, niyet, pozisyon, sıralanan URL ve tahmini trafikle döndürür. Sonuçları minimum arama hacmine, bir pozisyon eşiğine, arama niyetine ve içerdiği metne göre daraltabilir; trafik, hacim, pozisyon, zorluk veya CPC'ye göre sıralayabilirsiniz. Metin filtresi büyük/küçük harf duyarsızdır ve Türkçe İ/ı harflerini doğru işler.

top_pages ve subdomains raporları aynı veriye sayfa ve alt alan adı düzeyinde bakar: hangi sayfanın ve hangi alt alan adının en çok organik trafik getirdiğini, kaç kelimede sıralandığını ve bunların kaçının ilk 3 ile ilk 10'da olduğunu gösterir. Bir rakibin trafiğinin hangi içeriklerden geldiğini birkaç istekte ortaya çıkarırsınız.

Fiyatlandırma satır bazlıdır: her istek için 0,0132 USD taban ücret ve dönen her satır için 0,000132 USD ödersiniz. 10 satır 0,01452 USD, 100 satır 0,0264 USD, en fazla 1.000 satır 0,1452 USD tutar. traffic_estimate'te gönderilen her alan adı bir satırdır; 3 alan adı 0,013596 USD, 1000 alan adı 0,1452 USD tutar. history ise daha yüksek fiyatlı aylık bir arşivden okur: 0,132 USD artı ay başına 0,00132 USD, yani varsayılan 12 ay 0,14784 USD.

Bakiyenizden isteğin en kötü durumu kadar tutar bloke edilir, dönmeyen satırların ücreti ise hemen iade edilir; bu yüzden limit'i ihtiyacınız kadar ayarlamak maliyeti doğrudan düşürür. Sonuç dönmeyen bir sorgu yalnızca taban ücreti öder. Önbellekten dönen yanıtlar canlı yanıtla aynı ücretle ücretlendirilir. Hatalar ise hiçbir zaman ücretlendirilmez: 4xx hataları ücret alınmadan önce yakalanır, sonrasında oluşan bir hata tamamen iade edilir.

Rakibinizin trafik aldığı ama sizin hiç görünmediğiniz kelimeler, içerik planının en verimli başlangıç noktasıdır. keyword_gap raporunun varsayılan missing modu tam olarak bu listeyi üretir: rakibin sıralandığı ve sizin sıralanmadığınız kelimeler, rakibin pozisyonu ve sıralanan sayfasıyla birlikte.

shared modu ikinizin de sıralandığı kelimeleri iki pozisyonla yan yana verir; rakibin önde olduğu kelimeler iyileştirme listenizi oluşturur. unique modu ise yalnızca sizin sıralandığınız kelimeleri gösterir ve korumanız gereken alanı ortaya koyar. Sonuçlar varsayılan olarak arama hacmine göre sıralanır ve minimum hacim, niyet ve metin filtreleriyle daraltılabilir.

traffic_estimate raporu tek çağrıda 1000 alan adına kadar tahmini organik ve ücretli trafik döndürür: organik kelime sayısı, tahmini aylık organik ziyaret ve ücretli arama için aynı iki değer. Bir ajansın potansiyel müşteri listesini, bir pazar yerinin satıcılarını ya da bir rakip setini tek istekte karşılaştırabilirsiniz.

Tekrar eden alan adları birleştirilir ve satırlar gönderdiğiniz sırayla döner, böylece sonuçları kendi listenizle doğrudan eşleştirirsiniz. Hakkında verimiz olmayan bir alan adı hata değildir; listede kendi yerinde sıfırlardan oluşan bir satır olarak yer alır ve diğer alan adları gibi ücretlendirilir.

history raporu overview rakamlarını ay ay ve 60 aya kadar geriye verir: sıralanan kelime sayısı, tahmini trafik ve trafik değeri, ilk 3 / 10 / 20 / 100'deki kelimeler ve ücretli arama verisi. Yeni, kaybedilen, yükselen ve düşen kelime sayıları her ay bir önceki ayla karşılaştırılır.

Bu seriden bir site taşımasının, bir içerik kampanyasının ya da bir algoritma güncellemesinin etkisini okuyabilir, aynı dönemi rakiplerinizin serisiyle karşılaştırabilirsiniz. Satırlar en eskiden en yeniye sıralanır; içinde bulunulan ay, tamamlanana kadar seriye eklenmez.

Entegrasyon için tek ihtiyacınız API kullanıcı adı ve şifresidir; bunları hesap panelinizdeki API Erişimi sayfasından oluşturabilirsiniz. İstekler standart HTTP POST'tur, yanıtlar JSON'dur ve herhangi bir dilden çağrılabilir. Dokümantasyonda cURL, Python ve Node.js için çalışır örnekler bulunur. Hata mesajlarını Türkçe almak için Accept-Language: tr header'ını göndermeniz yeterlidir.

60 saniyeden uzun süren istekler task_id içeren bir 202 yanıtı döndürür; sonucu GET /v1/tasks/{task_id} ile alırsınız ve sonuç 72 saat saklanır. idempotency_key ile zaman aşımına uğrayan bir isteği güvenle tekrarlarsınız ve istek bir kez ücretlendirilir. Bilinmeyen ya da yanlış yazılmış bir parametre yok sayılmaz, hatada adıyla ve bir öneriyle bildirilir; böylece bir yazım hatası sessizce yanlış sonuç döndüremez.