SERP Genel Görünüm

API + MCP

GET/v3/rank-tracker/serp-overview

Bu uç noktaya yapılan istekler ücretsizdir ve herhangi bir API birimi tüketmez.

Sorgu parametreleri

project_idintegerGerekli

Projenin benzersiz tanımlayıcısı. Ahrefs’teki Rank Tracker projenizin URL’sinde bulabilirsiniz: https://app.ahrefs.com/rank-tracker/overview/#project_id#

keywordstringGerekli

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

language_codestring

İzlenen bir anahtar kelimenin dil kodu. İzlenen anahtar kelimeleriniz için ülke kodlarını, dil kodlarını ve konum ID’lerini almak üzere management/project-keywords uç noktasını kullanabilirsiniz.

countrystringGerekli

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

İzin verilen değerler:adaeafagaialamaoarasatauawazba…

location_idinteger

İzlenen bir anahtar kelimenin konum ID’si. İzlenen anahtar kelimeleriniz için ülke kodlarını, dil kodlarını ve konum ID’lerini almak üzere management/project-keywords uç noktasını kullanabilirsiniz.

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.

devicestringGerekli

Mobil ve masaüstü sıralamaları arasında seçim yapın.

İzin verilen değerler:desktopmobile

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.

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ı.

nr_wordsinteger or null

Bir web sayfasının HTML'sinde bulunan toplam 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

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

Bilinen son 12 ayın verilerine dayalı en iyi anahtar kelime için aylık ortalama arama sayısının tahmini.

trafficinteger or null

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: ai_overview, ai_overview_sitelink, discussion, image, image_th, knowledge_card, knowledge_panel, local_pack, organic, organic_shopping, paid_top, paid_bottom, paid_right, question, sitelink, snippet, top_story, tweet, video, video_th.

update_datestring (date)

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

urlstring (url) 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

Bir sayfanın aylık organik arama trafiğinin tahminî değeri, ABD doları sent cinsinden.