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

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.

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

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

limitinteger

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

Varsayılan:1000

timeoutinteger

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

volume_modestring

Arama hacmi hesaplama modu: aylık veya ortalama. Hacmi, trafiği ve trafik değerini etkiler.

İzin verilen değerler:monthlyaverage

Varsayılan:monthly

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#

devicestringGerekli

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

İzin verilen değerler:desktopmobile

datestring (date)Gerekli

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

date_comparedstring (date)

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

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

İzin verilen değerler:ADAEAFAGAIALAMAOAQARASATAUAWAX…

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.

İzin verilen değerler:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…

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.