Genel Bakış

API + MCP

GET/v3/keywords-explorer/overview

Bu istekte kullanıldığında regex filtresi sınırlı işlevselliğe sahiptir ve sözdizimi diğer isteklerden farklıdır. Joker karakter olarak yıldız (*) simgesini bekler.

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 kullanılacak bir sütun. Geçerli sütun tanımlayıcıları için yanıt şemasına bakın; ancak bu uç nokta için order_by içinde volume_monthly desteklenmez.

Example:field_a,field_b:asc,field_c:desc

wherestring

Filtre ifadesi. Aşağıdaki sütun tanımlayıcıları kabul edilir (bunlar, select parametresinin kabul ettiği tanımlayıcılardan farklıdır).

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.

volume_monthly_date_tostring (date)

volume_monthly_history alanında geçmiş aylık Arama Hacmi değerlerini almak için YYYY-AA-GG biçimindeki bitiş tarihi. Yalnızca volume_monthly_history istendiğinde gereklidir.

volume_monthly_date_fromstring (date)

volume_monthly_history alanında geçmiş aylık Arama Hacmi değerlerini almak için YYYY-AA-GG biçimindeki başlangıç tarihi. Yalnızca volume_monthly_history istendiğinde gereklidir.

target_modestring

Belirttiğiniz hedef URL'nin kapsamı.

İzin verilen değerler:exactprefixdomainsubdomains

targetstring (url)

Aramanın hedefi: bir alan adı veya URL.

target_positionstring

Belirtilen target öğesinin sıralama konumuna göre anahtar kelimeleri filtreler.

İzin verilen değerler:in_top10in_top100

countrystringGerekli

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

İzin verilen değerler:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

keywordsstring

Metriklerin gösterileceği anahtar kelimelerin virgülle ayrılmış listesi.

keyword_list_idinteger

Metriklerin gösterileceği mevcut bir anahtar kelime listesinin kimliği.

outputstring

Çıktı formatı.

İzin verilen değerler:jsonphpxml

Yanıtlar

keywordsarray<object>

clicksinteger or null

Kullanıcıların hedef anahtar kelimeyi ararken arama sonuçlarında yaptıkları aylık ortalama tıklama sayısı.

cpcinteger or null

Tıklama Başına Maliyet, bir anahtar kelime için reklamverenlerin ücretli arama sonuçlarındaki her bir reklam tıklaması için ödediği ortalama fiyatı ABD doları sent cinsinden gösterir.

cpsnumber (float) or null

Arama Başına Tıklamalar (veya CPS), Tıklamalar ile 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.

difficultyinteger or null

(10 birim) Bir anahtar kelime için ilk 10 organik arama sonucunda yer almanın ne kadar zor olduğuna dair 100 puanlık ölçek üzerinden bir tahmin.

first_seenstring (date-time) or null

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

global_volumeinteger or null

(10 units) Veri tabanımızdaki tüm ülkelerde kullanıcıların hedef anahtar kelimeyi ayda ortalama kaç kez aradığını gösterir.

intentsobject or null

(10 birim) Kullanıcının arama sorgusunun arkasındaki amacı gösterir. Nesne alanları: informational, navigational, commercial, transactional, branded veya local. Tüm alanlar bool türündedir; olası değerler true veya false olabilir.

keywordstring

parent_topicstring or null

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.

parent_volumeinteger or null

(10 birim) Ana Konu'nun Arama Hacmi.

searches_pct_clicks_organic_and_paidnumber (float) or null

Hedef anahtar kelime aranırken hem organik hem de ücretli sonuçların her ikisine de tıklayan kişilerin ortalama aylık yüzdesi.

searches_pct_clicks_organic_onlynumber (float) or null

Hedef anahtar kelime aranırken yalnızca organik sonuçlara tıklayan kişilerin ortalama aylık yüzdesi.

searches_pct_clicks_paid_onlynumber (float) or null

Hedef anahtar kelime aranırken yalnızca ücretli sonuçlara tıklayan kişilerin ortalama aylık yüzdesi.

serp_featuresarray<string>

Bir arama motoru sonuçları sayfasındaki (SERP) zenginleştirilmiş sonuçlardan geleneksel organik olmayanlar.

Allowed values:ai_overview_sitelinksnippetai_overviewlocal_packsitelinknewsimagevideodiscussiontweetpaid_toppaid_bottompaid_sitelinkshoppingknowledge_cardknowledge_panelquestionimage_thvideo_thorganic_shopping

serp_last_updatestring (date-time) or null

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

traffic_potentialinteger or null

(10 birim) Hedef anahtar kelimeniz için 1 numarada sıralanan sayfanın, sıralandığı tüm anahtar kelimelerden aldığı Organik Trafik toplamı.

volumeinteger or null

(10 birim) Bilinen son 12 ayın verilerine dayanarak bir anahtar kelime için aylık ortalama arama sayısının tahmini.

volume_desktop_pctnumber (float) or null

Bir anahtar kelime için masaüstü cihazlarda yapılan aramaların yüzdesi.

volume_mobile_pctnumber (float) or null

Bir anahtar kelime için mobil cihazlarda yapılan aramaların yüzdesi.

volume_monthlyinteger or null

(10 birim) Bir anahtar kelime için son ayda yapılan arama sayısının tahmini. Bu alan order_by parametresinde kullanılamayabilir.

volume_monthly_historyarray<object>

(Geçmişteki her ay için 2 birim, en az 50 birim) volume_monthly_date_from ve volume_monthly_date_to parametreleriyle belirlenen dönem için bir anahtar kelimenin geçmiş aylık Arama Hacmi tahminleri.