Genel Bakış
API + MCPBu uç noktaya yapılan istekler ücretsizdir ve herhangi bir API birimi tüketmez.
Sorgu parametreleri
Saniye cinsinden manuel zaman aşımı süresi.
Döndürülecek sonuç sayısı.
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.
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).
best_position_has_thumbnail: En üst pozisyonda (veya ayarlandıysa hedef URL'de) küçük resim vardır.
type: boolean nullable
best_position_has_thumbnail_previous: Karşılaştırma tarihinde en üst pozisyonda (veya ayarlandıysa hedef URL'de) küçük resim vardır.
type: boolean nullable
best_position_has_video_preview: En üst pozisyonda (veya ayarlandıysa hedef URL'de) video önizlemesi vardır.
type: boolean nullable
best_position_has_video_preview_previous: Karşılaştırma tarihinde en üst pozisyonda (veya ayarlandıysa hedef URL'de) video önizlemesi vardır.
type: boolean nullable
best_position_kind: En üst pozisyonun (veya ayarlandıysa hedef URL'nin) türü: organik, ücretli veya bir SERP özelliği.
type: string nullable
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"
best_position_kind_previous: Karşılaştırma tarihinde en üst pozisyonun (veya ayarlandıysa hedef URL'nin) türü.
type: string nullable
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"
clicks: Tıklamalar metriği, hedef anahtar kelimeyi ararken kullanıcıların arama sonuçlarına yaptığı ortalama aylık tıklama sayısını ifade eder. Bazı aramalar birden fazla sonuçta tıklama üretirken, bazıları hiç tıklamayla sonuçlanmayabilir.
type: integer nullable
clicks_per_search: Arama Başına Tıklamalar, Tıklamaların Anahtar Kelime Arama Hacmine oranıdır. Belirli bir ülkede insanlar hedef anahtar kelimeyi aradığında ortalama olarak kaç farklı arama sonucunun tıklandığını gösterir.
type: float nullable
cost_per_click: Tıklama Başına Maliyet, bir anahtar kelime için ücretli arama sonuçlarında reklamverenlerin her reklam tıklaması için ödediği ortalama ücreti gösterir.
type: integer nullable
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"
country_prev: Karşılaştırma tarihinde 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"
created_at: Bir anahtar kelimenin projeye eklendiği tarih.
type: datetime
is_branded: Kullanıcı niyeti: markalı. Kullanıcı belirli bir marka veya şirket adını arıyor.
type: boolean
is_commercial: Kullanıcı niyeti: ticari. Kullanıcı satın alma kararı vermeden önce ürün veya hizmetleri karşılaştırıyor.
type: boolean
is_informational: Kullanıcı niyeti: bilgi amaçlı. Kullanıcı bilgi veya belirli bir sorunun yanıtını arıyor.
type: boolean
is_local: Kullanıcı niyeti: yerel. Kullanıcı belirli bir konuma ilişkin bilgileri veya yakınındaki hizmetleri arıyor.
type: boolean
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
is_navigational: Kullanıcı niyeti: gezinme amaçlı. Kullanıcı belirli bir web sitesi veya web sayfası arıyor.
type: boolean
is_transactional: Kullanıcı niyeti: işlemsel. Kullanıcı genellikle bir satın alma olmak üzere bir eylemi tamamlamaya hazırdır.
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
keyword_prev: Karşılaştırma tarihinde hedefinizin sıralandığı anahtar kelime.
type: string
keyword_words: Bir anahtar kelimedeki kelime sayısı.
type: integer
keyword_words_prev: Karşılaştırma tarihinde bir anahtar kelimedeki kelime sayısı.
type: integer
language: Belirli bir anahtar kelime için takip edilen SERP dili.
type: string
language_prev: Karşılaştırma tarihindeki SERP dili.
type: string
location: Belirli bir anahtar kelimenin takip edildiği konum (ülke, eyalet/il veya şehir).
type: string
location_prev: Karşılaştırma tarihinde belirli bir anahtar kelimenin takip edildiği konum (ülke, eyalet/il veya şehir).
type: string
parent_topic: Ana Konu, sayfanızda daha genel bir konuyu hedefleyerek de hedef anahtar kelimeniz için sıralama alıp alamayacağınızı belirler. Ana Konuyu belirlemek için, anahtar kelimeniz için 1. sıradaki sayfayı alır ve o sayfaya en fazla trafiği getiren anahtar kelimeyi buluruz.
type: string nullable
position: Organik aramada en üst pozisyon (veya ayarlandıysa hedef URL).
type: integer nullable
position_diff: Seçilen tarihler arasında en üst pozisyondaki (veya ayarlandıysa hedef URL'deki) değişim.
type: integer nullable
position_prev: Karşılaştırma tarihinde en üst pozisyon (veya ayarlandıysa hedef URL).
type: integer nullable
search_type_image: Arama türü Görsel, bir anahtar kelime için yapılan aramaların yüzde kaçının görsel arama olduğunu gösterir ve görsel içeriğe olan ilgiyi ortaya koyar.
type: float nullable
search_type_news: Arama türü Haberler, bir anahtar kelime için yapılan aramaların yüzde kaçının haber makalelerini hedeflediğini gösterir.
type: float nullable
search_type_video: Arama türü Video, bir anahtar kelime için yapılan aramaların yüzde kaçının video arama olduğunu gösterir ve video içeriğe olan ilgiyi yansıtır.
type: float nullable
search_type_web: Arama türü Web, bir anahtar kelime için yapılan aramaların yüzde kaçının genel web içeriğini hedeflediğini gösterir ve geniş bir bilgi yelpazesine olan ilgiyi yansıtır.
type: float nullable
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_features_prev: Karşılaştırma tarihinde 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)
tags_prev: Karşılaştırma tarihinde belirli bir anahtar kelimeye atanmış etiketlerin listesi.
type: array(string)
target_positions_count: Bir anahtar kelimede sıralanan hedef URL sayısı.
type: integer
traffic: "volume_mode" parametresine bağlı olarak, en son aya veya bilinen en son 12 aylık verilere göre bir sayfanın organik aramadan aldığı tahmini aylık ziyaret sayısı.
type: integer nullable
traffic_diff: Seçtiğiniz tarihler arasındaki trafik değişimi.
type: integer nullable
traffic_prev: "volume_mode" parametresine bağlı olarak, en son aya veya bilinen en son 12 aylık verilere göre bir sayfanın organik aramadan aldığı tahmini aylık ziyaret sayısı.
type: integer nullable
url: Organik aramada en üst sıradaki URL (veya ayarlandıysa hedef URL).
type: string nullable
url_prev: Karşılaştırma tarihinde en üst sıradaki URL (veya ayarlandıysa hedef URL).
type: string nullable
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
volume_desktop_pct: Toplam arama hacminin masaüstü cihazlardan gelen yüzdesi.
type: float nullable
volume_mobile_pct: Toplam arama hacminin mobil cihazlardan gelen yüzdesi.
type: float nullable
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.
Metrikleri karşılaştırmak için YYYY-MM-DD formatında bir tarih.
YYYY-MM-DD biçiminde, metriklerin raporlanacağı tarih.
Mobil ve masaüstü sıralamaları arasında seçim yapın.
Projenin benzersiz tanımlayıcısı. Ahrefs'teki Rank Tracker projenizin URL'sinde bulabilirsiniz: https://app.ahrefs.com/rank-tracker/overview/#project_id#
Arama hacmi hesaplama modu: aylık veya ortalama. Hacmi, trafiği ve Trafik Değeri'ni etkiler.
Çıktı formatı.
Yanıtlar
En üst pozisyonda (veya ayarlandıysa hedef URL’de) küçük resim vardır.
Karşılaştırma tarihinde en üst pozisyonda (veya ayarlandıysa hedef URL’de) küçük resim vardır.
En üst pozisyonda (veya ayarlandıysa hedef URL’de) video önizlemesi vardır.
Karşılaştırma tarihinde en üst pozisyonda (veya ayarlandıysa hedef URL’de) video önizlemesi vardır.
En üst pozisyonun (veya ayarlandıysa hedef URL’nin) türü: organik, ücretli veya bir SERP özelliği.
Karşılaştırma tarihindeki en üst konumun (veya ayarlandıysa hedef URL'lerin) türü.
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.
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.
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.
Belirli bir anahtar kelimenin izlendiği ülke. İki harfli ülke kodu (ISO 3166-1 alfa-2).
Karşılaştırma tarihindeki belirli bir anahtar kelimenin izlendiği ülke. İki harfli ülke kodu (ISO 3166-1 alfa-2).
Anahtar kelimenin projeye eklendiği tarih.
Kullanıcı amacı: markalı. Kullanıcı, belirli bir marka veya şirket adı arıyor.
Kullanıcı amacı: ticari. Kullanıcı, bir satın alma kararı vermeden önce ürün veya hizmetleri karşılaştırıyor.
Kullanıcı amacı: bilgilendirici. Kullanıcı, bilgi veya belirli bir soruya yanıt arıyor.
Kullanıcı niyeti: yerel. Kullanıcı, belirli bir konum veya yakındaki hizmetlerle ilgili bilgi arıyor.
Kullanıcı niyeti: yönlendirici. Kullanıcı, belirli bir web sitesi veya web sayfasını arıyor.
Kullanıcı niyeti: işlemsel. Kullanıcı, bir işlemi (genellikle bir satın alma) tamamlamaya hazır.
Hedefinizin sıralama aldığı anahtar kelime.
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.
Anahtar kelime hâlâ işleniyorsa ve henüz SERP getirilmediyse false döndürür.
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.
Karşılaştırma tarihinde hedefinizin sıralama aldığı anahtar kelime.
Belirli bir anahtar kelimenin izlendiği SERP dili.
Karşılaştırma tarihindeki SERP dili.
Belirli bir anahtar kelimenin izlendiği konum (ülke, eyalet/il veya şehir).
Karşılaştırma tarihindeki belirli bir anahtar kelimenin izlendiği konum (ülke, eyalet/il veya şehir).
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.
Organik aramadaki en üst konum (veya ayarlandıysa hedef URL'ler).
Seçili tarihler arasındaki en üst konumdaki (veya ayarlandıysa hedef URL'lerdeki) değişim.
Karşılaştırma tarihindeki en üst konum (veya ayarlandıysa hedef URL'ler).
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.
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.
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.
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.
Bir anahtar kelime için arama sonuçlarında gösterilen SERP özellikleri.
Karşılaştırma tarihinde bir anahtar kelime için arama sonuçlarında görünen SERP Özellikleri.
Bir anahtar kelime için arama motoru sonuçlarını en son kontrol ettiğimiz tarih.
Karşılaştırma tarihine kadar arama motoru sonuçlarını kontrol ettiğimiz tarih.
Belirli bir anahtar kelimeye atanmış etiketlerin listesi.
Karşılaştırma tarihinde belirli bir anahtar kelimeye atanmış etiketlerin listesi.
Bir anahtar kelime için sıralanan hedef URL sayısı.
"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.
Seçili tarihleriniz arasında trafikteki değişim.
"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.
Organik aramadaki en üst sıradaki URL (veya ayarlanmışsa hedef URL).
Karşılaştırma tarihindeki en üst sıradaki URL (veya ayarlanmışsa hedef URL).
"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.
Toplam arama hacminin masaüstü cihazlardan gelen yüzdesi.
Toplam arama hacminin mobil cihazlardan gelen yüzdesi.