Rakiplere Genel Bakış

API + MCP

GET/v3/rank-tracker/competitors-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

Metriklerin raporlanacağı tarih (YYYY-MM-DD biçiminde).

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:jsonphp

Yanıtlar

keywordsarray<object>

competitors_listarray<object>

Belirli bir anahtar kelime için rakip bilgileri. Şu alanlar dahildir: url, url_prev, position, position_prev, best_position_kind, best_position_kind_prev, traffic, traffic_prev, value, value_prev. prev ile biten alanlar yalnızca karşılaştırma görünümünde yer alır.

countrystring

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

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

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.

languagestring

Belirli bir anahtar kelimenin izlendiği SERP dili.

locationstring

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

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

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.