Rakip Sayfaları

API + MCP

GET/v3/rank-tracker/competitors-pages

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.

target_and_tracked_competitors_onlyboolean

Sayfaları hedef ve takip edilen rakiplerle sınırlayın

Varsayılan:false

outputstring

Çıktı formatı.

İzin verilen değerler:jsoncsvxmlphp

Yanıtlar

competitors-pagesarray<object>

keywordsinteger

Hedefinizin en iyi 100 organik arama sonucunda sıralamaya girdiği toplam anahtar kelime sayısı.

share_of_traffic_valuenumber (float)

Hedefinizin organik arama trafik değerinin, izlenen tüm anahtar kelimeler için toplam organik arama trafik değerine kıyasla oranı.

share_of_traffic_value_prevnumber (float)

Karşılaştırma tarihindeki trafik değeri payı.

share_of_voicenumber (float)

Hedefinizin organik arama trafiğinin, izlenen tüm anahtar kelimeler için toplam organik arama trafiğine kıyasla oranı.

share_of_voice_prevnumber (float)

Karşılaştırma tarihindeki görünürlük payı.

statusstring

Bir sayfanın durumu: yeni sıralanmaya başlayan sayfa ("left"), arama sonuçlarından kaybolan sayfa ("right") veya değişiklik yok ("both").

İzin verilen değerler:leftrightboth

titlestring or null

Sayfanın, En İyi Anahtar Kelime SERP'inde görüntülenen başlığı.

title_prevstring or null

Karşılaştırma tarihindeki başlık.

trafficinteger

Bir sayfanın organik aramalardan aldığı tahminî aylık ziyaret sayısı.

traffic_previnteger

Karşılaştırma tarihindeki trafik.

traffic_valueinteger or null

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

traffic_value_previnteger or null

Karşılaştırma tarihindeki trafik değeri.

urlstring (url)

Sayfa URL'si.