Docs
Dokümanlarda ara...⌘K

Ücretli sayfalar

API + MCP
GET/v3/site-explorer/paid-pages

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

ads_count: Bir sayfayla ilişkili benzersiz reklam sayısı.
type: integer

ads_count_diff: Seçtiğiniz tarihler arasındaki reklam sayısı değişimi.
type: integer

ads_count_prev: Karşılaştırma tarihinde reklam sayısı.
type: integer

cpc
type: integer nullable

cpc_prev: Karşılaştırma tarihinde CPC metriği.
type: integer nullable

description: Arama sonuçlarında görünen reklam açıklaması.
type: string

description_prev: Karşılaştırma tarihinde reklam açıklaması.
type: string

has_thumbnail: Pozisyonda küçük resim (thumbnail) vardır.
type: boolean

has_thumbnail_prev: Karşılaştırma tarihinde pozisyonda küçük resim (thumbnail) vardır.
type: boolean

has_video: Pozisyonda video vardır.
type: boolean

has_video_prev: Karşılaştırma tarihinde pozisyonda video vardır.
type: boolean

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

keyword_difficulty (10 units): 100 puanlık ölçekte bir anahtar kelime için ilk 10 organik arama sonucunda sıralanmanın ne kadar zor olduğuna dair tahmin.
type: integer nullable

keyword_difficulty_prev (10 units): Karşılaştırma tarihinde anahtar kelime zorluğu.
type: integer nullable

keyword_prev: Karşılaştırma tarihinde hedefinizin sıralandığı anahtar kelime.
type: string

keywords: Hedefinizin ücretli arama sonuçlarında sıralandığı toplam anahtar kelime sayısı.
type: integer

keywords_diff: Seçtiğiniz tarihler arasındaki anahtar kelime değişimi.
type: integer

keywords_diff_percent: Seçtiğiniz tarihler arasındaki anahtar kelime değişimi (yüzde).
type: integer

keywords_merged: Sıralama için optimize edilmiş toplam anahtar kelime sayısı.
type: integer

keywords_prev: Karşılaştırma tarihinde anahtar kelime sayısı.
type: integer

position: Hedefinizin bir anahtar kelime için ücretli arama sonuçlarında aldığı sıra.
type: integer

position_kind: Bir pozisyonun türü: organik, ücretli veya bir SERP özelliği. Bu, en iyi pozisyon seçilmeden önce belirli bir anahtar kelime ve URL için tüm pozisyonlara uygulanır.
type: 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"

position_kind_prev: Karşılaştırma tarihinde bir pozisyonun türü.
type: 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"

position_prev: Karşılaştırma tarihinde hedefinizin ilgili anahtar kelime için aldığı sıra.
type: integer

raw_url: Kodlanmış biçimde sıralama sayfası URL’si.
type: string

raw_url_prev: Karşılaştırma tarihinde kodlanmış biçimde sıralama sayfası URL’si.
type: string

referring_domains (5 units): Bir sayfaya bağlantı veren benzersiz etki alanlarının sayısı.
type: integer nullable

serp_features
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 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"

status: Bir sayfanın durumu: ücretli sonuçlarda yeni sıralanmaya başlayan sayfa ("left"), ücretli sonuçlardan kaybolan sayfa ("right") veya değişiklik yok ("both").
type: string
enum: "left" "right" "both"

sum_traffic (10 units): Bir sayfanın sıralandığı tüm anahtar kelimelerden aldığı tahmini aylık ücretli arama trafiği.
type: integer nullable

sum_traffic_merged (10 units): Sıralama için optimize edilmiş ücretli trafik alanı.
type: integer

sum_traffic_prev (10 units): Karşılaştırma tarihinde ücretli trafik.
type: integer nullable

title: Arama sonuçlarında görünen reklam başlığı.
type: string

title_prev: Karşılaştırma tarihinde reklam başlığı.
type: string

top_keyword: Bir sayfaya en çok ücretli trafik getiren anahtar kelime.
type: string nullable

top_keyword_best_position: Bir sayfanın en iyi anahtar kelimesi için sahip olduğu sıralama pozisyonu.
type: integer nullable

top_keyword_best_position_diff: Seçtiğiniz tarihler arasındaki en iyi pozisyon değişimi.
type: integer nullable

top_keyword_best_position_kind: En iyi pozisyonun 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"

top_keyword_best_position_kind_prev: Karşılaştırma tarihinde en iyi pozisyonun 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"

top_keyword_best_position_prev: Karşılaştırma tarihinde en iyi pozisyon.
type: integer nullable

top_keyword_best_position_title: En iyi anahtar kelimesinin SERP’inde sayfa için gösterilen başlık.
type: string nullable

top_keyword_best_position_title_prev: Karşılaştırma tarihinde en iyi anahtar kelimesinin SERP’inde sayfa için gösterilen başlık.
type: string nullable

top_keyword_country: Bir sayfanın en iyi anahtar kelimesi için sıralandığı ülke.
type: string nullable
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"

top_keyword_country_prev: Karşılaştırma tarihinde bir sayfanın en iyi anahtar kelimesi için sıralandığı ülke.
type: string nullable
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"

top_keyword_prev: Karşılaştırma tarihinde bir sayfaya en çok ücretli trafik getiren anahtar kelime.
type: string nullable

top_keyword_volume (10 units): "volume_mode" parametresine bağlı olarak, en iyi anahtar kelime için son ayda veya bilinen en son 12 aylık veride ortalama aylık arama sayısı tahmini.
type: integer nullable

top_keyword_volume_prev (10 units): Karşılaştırma tarihinde Arama Hacmi.
type: integer nullable

traffic (10 units): Bir anahtar kelime için hedefinizin ücretli aramadan aldığı tahmini aylık ziyaretçi sayısı.
type: integer

traffic_diff: Seçtiğiniz tarihler arasındaki trafik değişimi.
type: integer

traffic_diff_percent: Seçtiğiniz tarihler arasındaki trafik değişimi (yüzde).
type: integer

traffic_prev (10 units): Karşılaştırma tarihinde bir anahtar kelimeden gelen trafik.
type: integer

ur: URL Derecelendirmesi (UR), hedef sayfanızın geri bağlantı profilinin 100 puanlık logaritmik ölçekte gücünü gösterir.
type: float nullable

url: Sıralama sayfası URL’si.
type: url nullable

url_prev: Karşılaştırma tarihinde sıralama sayfası URL’si.
type: url nullable

url_visual: Arama sonuçlarında görünen reklam URL’si.
type: string

url_visual_prev: Karşılaştırma tarihinde reklam URL’si.
type: string

value (10 units): Bir sayfanın aylık ücretli arama trafiğinin tahmini maliyeti (USD cent).
type: integer nullable

value_diff: Seçtiğiniz tarihler arasındaki trafik değeri değişimi.
type: integer

value_diff_percent: Seçtiğiniz tarihler arasındaki trafik değeri değişimi (yüzde).
type: integer

value_merged (10 units): Sıralama için optimize edilmiş trafik değeri alanı.
type: integer nullable

value_prev (10 units): Karşılaştırma tarihinde trafik değeri.
type: integer nullable

volume (10 units): Son ay için bir anahtar kelimenin Arama Hacmi tahmini.
type: integer nullable

volume_prev (10 units): Karşılaştırma tarihinde Arama Hacmi.
type: integer nullable

words: Bir anahtar kelimedeki kelime sayısı.
type: integer

words_prev: Karşılaştırma tarihinde bir anahtar kelimedeki kelime sayısı.
type: integer

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.

protocolstring

Hedefinizin protokolü.

İzin verilen değerler:bothhttphttps
Varsayılan:both
targetstringGerekli

Arama hedefi: bir etki alanı veya bir URL.

modestring

Girdiğiniz hedefe göre aramanın kapsamı.

İzin verilen değerler:exactprefixdomainsubdomains
Varsayılan:subdomains
countrystring

İki harfli ülke kodu (ISO 3166-1 alpha-2).

İzin verilen değerler:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
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.

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

Yanıtlar

pagesarray<object>
ads_countinteger or null

Bir sayfaya sahip özgün reklamların sayısı.

ads_count_diffinteger

Seçili tarihleriniz arasında reklamlardaki değişim.

ads_count_previnteger or null

Karşılaştırma tarihindeki reklam sayısı.

keywordsinteger or null

Hedefinizin ücretli arama sonuçlarında sıralandığı anahtar kelimelerin toplam sayısı.

keywords_diffinteger

Seçili tarihleriniz arasında anahtar kelimelerdeki değişim.

keywords_diff_percentinteger

Seçili tarihleriniz arasında anahtar kelimelerdeki değişim, yüzde olarak.

keywords_mergedinteger

Sıralama için optimize edilmiş toplam anahtar kelime sayısı.

keywords_previnteger or null

Karşılaştırma tarihinde hedefinizin sıralama aldığı anahtar kelime.

raw_urlstring

Sıralama sayfası URL'sinin kodlanmış biçimi.

raw_url_prevstring or null

Karşılaştırma tarihindeki sıralama sayfası URL'sinin kodlanmış biçimi.

referring_domainsinteger or null

(5 birim) Bir sayfaya bağlantı veren benzersiz etki alanlarının sayısı.

statusstring

Bir sayfanın durumu: ücretli sonuçlarda sıralanmaya yeni başlayan yeni sayfa ("left"), ücretli sonuçlardan kaybolan kayıp sayfa ("right") veya değişiklik yok ("both").

Allowed values:leftrightboth
sum_trafficinteger or null

(10 birim) Bir sayfanın sıralama aldığı tüm anahtar kelimelerden elde ettiği aylık ücretli arama trafiğinin tahmini.

sum_traffic_mergedinteger

(10 birim) Sıralama için optimize edilmiş ücretli trafik alanı.

sum_traffic_previnteger or null

(10 birim) Karşılaştırma tarihindeki ücretli trafik.

top_keywordstring or null

Bir sayfaya en çok trafiği getiren anahtar kelime.

top_keyword_best_positioninteger or null

Bir sayfanın en iyi anahtar kelimesinin sıralandığı konum.

top_keyword_best_position_diffinteger or null

Seçtiğiniz tarihler arasındaki en iyi pozisyon değişikliği.

top_keyword_best_position_kindstring or null

En iyi pozisyonun türü: organik, ücretli veya SERP Özellikleri.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
top_keyword_best_position_kind_prevstring or null

Karşılaştırma tarihindeki en üst konumun türü.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
top_keyword_best_position_previnteger or null

Karşılaştırma tarihindeki en üst konum.

top_keyword_best_position_titlestring or null

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

top_keyword_best_position_title_prevstring or null

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

top_keyword_countrystring or null

Bir sayfanın En İyi Anahtar Kelime için sıralandığı ülke.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
top_keyword_country_prevstring or null

Karşılaştırma tarihinde bir sayfanın En İyi Anahtar Kelime için sıralandığı ülke.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
top_keyword_prevstring or null

Karşılaştırma tarihinde bir sayfaya en fazla ücretli trafiği getiren anahtar kelime.

top_keyword_volumeinteger or null

(10 birim) "volume_mode" parametresine bağlı olarak en son ay veya bilinen son 12 aylık verilere göre en iyi anahtar kelime için aylık ortalama arama sayısının tahmini.

top_keyword_volume_previnteger or null

(10 birim) Karşılaştırma tarihindeki arama hacmi.

traffic_diffinteger

Seçili tarihleriniz arasında trafikteki değişim.

traffic_diff_percentinteger

Seçili tarihleriniz arasında trafikteki değişim, yüzde olarak.

urnumber or null

URL Derecelendirmesi (UR), hedef sayfanızın geri bağlantı profilinin gücünü 100 puanlık bir logaritmik ölçekte gösterir.

urlstring or null

Sıralamadaki sayfanın URL’si.

url_prevstring or null

Karşılaştırma tarihindeki sıralama sayfasının URL'si.

valueinteger or null

(10 birim) Bir sayfanın aylık ücretli arama trafiğinin ABD doları senti cinsinden tahmini maliyeti.

value_diffinteger

Seçili tarihleriniz arasında trafik değerindeki değişim.

value_diff_percentinteger

Seçili tarihleriniz arasında trafik değerindeki değişim, yüzde olarak.

value_mergedinteger or null

(10 birim) Sıralama için optimize edilmiş Trafik Değeri alanı.

value_previnteger or null

(10 birim) Karşılaştırma tarihindeki Trafik Değeri.