Docs
Dokümanlarda ara...⌘K

Genel Bakış

API + MCP
GET/v3/rank-tracker/overview

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

Sorgu parametreleri

timeoutinteger

Saniye cinsinden manuel zaman aşımı süresi.

limitinteger

Döndürülecek sonuç sayısı.

Varsayılan:1000
order_bystring

Sonuçları sıralamak için (isteğe bağlı yön bilgisiyle birlikte) virgülle ayrılmış bir sütun listesi. Geçerli sütun tanımlayıcıları için yanıt şemasına bakın.

Example:field_a,field_b:asc,field_c:desc
wherestring

Filtre ifadesi. Aşağıdaki sütun tanımlayıcıları tanınır (bu, select parametresinin tanıdığı tanımlayıcılardan farklıdır).

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.

date_comparedstring (date)

Metrikleri karşılaştırmak için YYYY-MM-DD formatında bir tarih.

datestring (date)Gerekli

YYYY-MM-DD biçiminde, metriklerin raporlanacağı tarih.

devicestringGerekli

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

İzin verilen değerler:desktopmobile
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#

volume_modestring

Arama hacmi hesaplama modu: aylık veya ortalama. Hacmi, trafiği ve Trafik Değeri'ni etkiler.

İzin verilen değerler:monthlyaverage
Varsayılan:monthly
outputstring

Çıktı formatı.

İzin verilen değerler:jsoncsvxmlphp

Yanıtlar

overviewsarray<object>
best_position_has_thumbnailboolean or null

En üst pozisyonda (veya ayarlandıysa hedef URL’de) küçük resim vardır.

best_position_has_thumbnail_previousboolean or null

Karşılaştırma tarihinde en üst pozisyonda (veya ayarlandıysa hedef URL’de) küçük resim vardır.

best_position_has_video_previewboolean or null

En üst pozisyonda (veya ayarlandıysa hedef URL’de) video önizlemesi vardır.

best_position_has_video_preview_previousboolean or null

Karşılaştırma tarihinde en üst pozisyonda (veya ayarlandıysa hedef URL’de) video önizlemesi vardır.

best_position_kindstring or null

En üst pozisyonun (veya ayarlandıysa hedef URL’nin) türü: organik, ücretli veya bir SERP özelliği.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_previousstring or null

Karşılaştırma tarihindeki en üst konumun (veya ayarlandıysa hedef URL'lerin) türü.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
clicksinteger or null

Tıklama ölçümü, insanların hedef anahtar kelimeyi ararken arama sonuçlarına yaptıkları aylık ortalama tıklama sayısını ifade eder. Bazı aramalar birden fazla sonuçta tıklama oluştururken bazıları hiç tıklama ile sonuçlanmayabilir.

clicks_per_searchnumber (float) or null

Arama Başına Tıklamalar, Tıklama ve Anahtar Kelime Arama hacmi oranıdır. Belirli bir ülkede hedef anahtar kelimeyi aradıklarında ortalama olarak kaç farklı arama sonucunun tıklandığını gösterir.

cost_per_clickinteger or null

Tıklama Başı Maliyet, bir anahtar kelime için reklamverenlerin ücretli arama sonuçlarındaki her bir reklam tıklaması için ödediği ortalama fiyatı gösterir.

countrystring

Belirli bir anahtar kelimenin izlendiği ülke. İki harfli ülke kodu (ISO 3166-1 alfa-2).

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
country_prevstring

Karşılaştırma tarihindeki belirli bir anahtar kelimenin izlendiği ülke. İki harfli ülke kodu (ISO 3166-1 alfa-2).

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
created_atstring (date-time)

Anahtar kelimenin projeye eklendiği tarih.

is_brandedboolean

Kullanıcı amacı: markalı. Kullanıcı, belirli bir marka veya şirket adı arıyor.

is_commercialboolean

Kullanıcı amacı: ticari. Kullanıcı, bir satın alma kararı vermeden önce ürün veya hizmetleri karşılaştırıyor.

is_informationalboolean

Kullanıcı amacı: bilgilendirici. Kullanıcı, bilgi veya belirli bir soruya yanıt arıyor.

is_localboolean

Kullanıcı niyeti: yerel. Kullanıcı, belirli bir konum veya yakındaki hizmetlerle ilgili bilgi arıyor.

is_navigationalboolean

Kullanıcı niyeti: yönlendirici. Kullanıcı, belirli bir web sitesi veya web sayfasını arıyor.

is_transactionalboolean

Kullanıcı niyeti: işlemsel. Kullanıcı, bir işlemi (genellikle bir satın alma) tamamlamaya hazır.

keywordstring

Hedefinizin sıralama aldığı anahtar kelime.

keyword_difficultyinteger or null

Bir anahtar kelime için 100 puanlık bir ölçekte ilk 10 organik arama sonucunda sıralamanın ne kadar zor olduğuna dair bir tahmin.

keyword_has_databoolean

Anahtar kelime hâlâ işleniyorsa ve henüz SERP getirilmediyse false döndürür.

keyword_is_frozenboolean

Bir anahtar kelimenin planınızdaki izlenen anahtar kelime sınırını aşıp aşmadığını belirtir. Bu tür anahtar kelimeler "dondurulur"; yani sıralamaları güncellenmez.

keyword_prevstring

Karşılaştırma tarihinde hedefinizin sıralama aldığı anahtar kelime.

languagestring

Belirli bir anahtar kelimenin izlendiği SERP dili.

language_prevstring

Karşılaştırma tarihindeki SERP dili.

locationstring

Belirli bir anahtar kelimenin izlendiği konum (ülke, eyalet/il veya şehir).

location_prevstring

Karşılaştırma tarihindeki belirli bir anahtar kelimenin izlendiği konum (ülke, eyalet/il veya şehir).

parent_topicstring or null

Ana Konu, sayfanızda daha genel bir konuyu hedeflerken hedef anahtar kelimeniz için sıralanıp sıralanamayacağınızı belirler. Ana Konu'yu belirlemek adına, anahtar kelimeniz için en iyi sıralanan sayfayı alıp o sayfaya en fazla trafiği göndermekten sorumlu anahtar kelimeyi buluruz.

positioninteger or null

Organik aramadaki en üst konum (veya ayarlandıysa hedef URL'ler).

position_diffinteger or null

Seçili tarihler arasındaki en üst konumdaki (veya ayarlandıysa hedef URL'lerdeki) değişim.

position_previnteger or null

Karşılaştırma tarihindeki en üst konum (veya ayarlandıysa hedef URL'ler).

search_type_imagenumber (float) or null

Görsel arama türü, bir anahtar kelime için yapılan görsel arama yüzdesini gösterir ve görsel içeriğe olan ilgiyi vurgular.

search_type_newsnumber (float) or null

Arama türü Haberler, bir anahtar kelime için yapılan aramaların haber makaleleri için yapılan yüzde oranını gösterir.

search_type_videonumber (float) or null

Video arama türü, bir anahtar kelime için yapılan aramaların yüzdesini gösterir ve video içeriğine olan ilgiyi yansıtır.

search_type_webnumber (float) or null

Arama türü Web, geniş bir bilgi yelpazesine olan ilgiyi gösteren genel web içeriği için yapılan anahtar kelime aramalarının yüzdesini gösterir.

serp_featuresarray<string>

Bir anahtar kelime için arama sonuçlarında gösterilen SERP özellikleri.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_features_prevarray<string>

Karşılaştırma tarihinde bir anahtar kelime için arama sonuçlarında görünen SERP Özellikleri.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_updatedstring (date-time) or null

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

serp_updated_prevstring (date-time) or null

Karşılaştırma tarihine kadar arama motoru sonuçlarını kontrol ettiğimiz tarih.

tagsarray<string>

Belirli bir anahtar kelimeye atanmış etiketlerin listesi.

tags_prevarray<string>

Karşılaştırma tarihinde belirli bir anahtar kelimeye atanmış etiketlerin listesi.

target_positions_countinteger

Bir anahtar kelime için sıralanan hedef URL sayısı.

trafficinteger or null

"volume_mode" parametresine bağlı olarak, son aya veya bilinen son 12 aylık veriye göre bir sayfanın organik aramadan aldığı aylık ziyaret sayısının tahmini.

traffic_diffinteger or null

Seçili tarihleriniz arasında trafikteki değişim.

traffic_previnteger or null

"volume_mode" parametresine bağlı olarak, son aya veya bilinen son 12 aylık veriye göre bir sayfanın organik aramadan aldığı aylık ziyaret sayısının tahmini.

urlstring (url) or null

Organik aramadaki en üst sıradaki URL (veya ayarlanmışsa hedef URL).

url_prevstring (url) or null

Karşılaştırma tarihindeki en üst sıradaki URL (veya ayarlanmışsa hedef URL).

volumeinteger or null

"volume_mode" parametresine bağlı olarak, son aya veya bilinen son 12 aylık veriye göre bir anahtar kelimenin ortalama aylık arama sayısının tahmini.

volume_desktop_pctnumber (float) or null

Toplam arama hacminin masaüstü cihazlardan gelen yüzdesi.

volume_mobile_pctnumber (float) or null

Toplam arama hacminin mobil cihazlardan gelen yüzdesi.