SERP Genel Görünüm

API + MCP

GET/v3/serp-overview/serp-overview

Sorgu parametreleri

selectstringGerekli

Döndürülecek sütunların virgülle ayrılmış listesi. Geçerli sütun tanımlayıcıları için yanıt şemasına bakın.

keywordstringGerekli

SERP Genel Görünüm'ün döndürüleceği anahtar kelime.

countrystringGerekli

İki harfli ülke kodu (ISO 3166-1 alpha-2).

İzin verilen değerler:adaeafagaialamaoarasatauawazba…

datestring (date-time)

YYYY-MM-DDThh:mm:ss biçiminde, mevcut en son SERP Genel Görünümü’nün döndürüleceği zaman damgası. Belirtilmezse en güncel SERP Genel Görünümü döndürülür.

top_positionsinteger

Döndürülecek en üst organik SERP pozisyonlarının sayısı. Belirtilmezse mevcut tüm pozisyonlar döndürülür.

typestring

Filtrelemek için SERP özellik türlerinin virgülle ayrılmış listesi. Yalnızca type alanı verilen değerlerden en az birini içeren konumlar döndürülür. Belirtilmezse tüm türlerdeki konumlar döndürülür.

İzin verilen değerler:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…

outputstring

Çıktı formatı.

İzin verilen değerler:jsonphpxml

Yanıtlar

positionsarray<object>

ahrefs_rankinteger or null

Veri tabanımızdaki diğer web sitelerine oranla bir alan adının geri bağlantı profilinin gücü; 1. sıra en güçlü olanı ifade eder.

backlinksinteger or null

Diğer web sitelerinden bir arama sonucuna işaret eden bağlantıların toplam sayısı.

domain_ratingnumber (float) or null

100 puanlık bir ölçekte, veri tabanımızdaki diğerlerine kıyasla bir alan adının geri bağlantı profilinin gücü.

keywordsinteger or null

Bir arama sonucunun ilk 100 organik konumda yer aldığı toplam anahtar kelime sayısı.

page_typestring or null

Sıralanan sayfa için Yapay zekâ tarafından tahmin edilen hiyerarşik sayfa türü yollarının virgülle ayrılmış listesi. Her değer, eğik çizgiyle başlayan bir yoldur (örn. /Article/How_to).

positioninteger

Arama sonucunun SERP'teki konumu.

refdomainsinteger or null

(5 units) Bir arama sonucuna bağlanan benzersiz etki alanlarının toplam sayısı.

titlestring or null

Sıralamadaki sayfanın başlığı.

top_keywordstring or null

Bir arama sonucuna en organik trafiği getiren anahtar kelime.

top_keyword_volumeinteger or null

(10 units) Bilinen son 12 aylık verilere göre en iyi anahtar kelime için aylık ortalama arama sayısının tahmini.

trafficinteger or null

(10 units) Bir sonucun, sıralandığı tüm anahtar kelimelerden aldığı aylık organik arama trafiğinin tahmini.

typearray<string>

Pozisyon türü: organik, ücretli veya bir SERP özelliği.

İzin verilen değerler:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…

update_datestring (date-time)

Bir anahtar kelime için arama motoru sonuçlarını kontrol ettiğimiz tarih.

urlstring or null

Sıralamadaki sayfanın URL'si.

url_ratingnumber (float) or null

100 puanlık logaritmik bir ölçekte bir sayfanın geri bağlantı profilinin gücü.

valueinteger or null

(10 units) Bir sayfanın aylık organik arama trafiğinin, USD senti cinsinden tahminî değeri.