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

country: Belirli bir anahtar kelimenin takip edildiği ülke. İki harfli ülke kodu (ISO 3166-1 alpha-2).
type: string
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"

is_main_position: AI Overview, Sitelinkler, En önemli haberler, Görsel paketleri, Videolar, Tartışmalar ve forumlar ile X (Twitter) gönderilerindeki pozisyonları hariç tutar.
type: boolean

is_main_position_prev: Karşılaştırma tarihinde AI Overview, Sitelinkler, En önemli haberler, Görsel paketleri, Videolar, Tartışmalar ve forumlar ile X (Twitter) gönderilerindeki pozisyonları hariç tutar.
type: boolean

keyword: Hedefinizin sıralandığı anahtar kelime.
type: string

keyword_difficulty: 100 puanlık ölçekte, bir anahtar kelime için ilk 10 organik arama sonucunda sıralama elde etmenin ne kadar zor olduğuna dair bir tahmin.
type: integer nullable

keyword_has_data: Anahtar kelime hâlâ işleniyorsa ve henüz SERP çekilmediyse false döndürür.
type: boolean

keyword_is_frozen: Bir anahtar kelimenin planınızdaki takip edilen anahtar kelime limitini aşıp aşmadığını gösterir. Bu tür anahtar kelimeler "dondurulur"; yani sıralamaları güncellenmez.
type: boolean

language: Belirli bir anahtar kelime için takip edilen SERP dili.
type: string

location: Belirli bir anahtar kelimenin takip edildiği konum (ülke, eyalet/il veya şehir).
type: string

serp_features: Bir anahtar kelime için arama sonuçlarında görünen SERP Özellikleri.
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

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

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

tags: Belirli bir anahtar kelimeye atanmış etiketlerin listesi.
type: array(string)

volume: "volume_mode" parametresine bağlı olarak, en son aya veya bilinen en son 12 aylık verilere göre bir anahtar kelime için tahmini ortalama aylık arama sayısı.
type: integer nullable

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

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

datestringGerekli

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: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 or null

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

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