Docs
Dokümanlarda ara...⌘K

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ı tanınır (bu liste, select parametresinin tanıdığı tanımlayıcılardan farklıdır).

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

cpc: 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 fiyatı ABD doları senti cinsinden gösterir.
type: integer nullable

cps: 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.
type: float nullable

difficulty (10 units): 100 puanlık bir ölçekte, bir anahtar kelimenin ilk 10 organik arama sonucunda sıralanmasının ne kadar zor olduğuna dair bir tahmin.
type: integer nullable

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

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

intents (10 units): 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'tur.
type: object nullable

keyword:
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 Konu'yu belirlemek için anahtar kelimeniz için 1 numarada yer alan sayfayı alır ve o sayfaya en fazla trafiği getiren anahtar kelimeyi buluruz.
type: string nullable

parent_volume (10 units): Ana Konu için Arama Hacmi.
type: integer nullable

serp_domain_rating_top10_min: Anahtar kelimenin, DR değeri en fazla bu değer olan en az bir ilk 10 sıralaması olmalıdır.
type: float nullable

serp_domain_rating_top5_min: Anahtar kelimenin, DR değeri en fazla bu değer olan en az bir ilk 5 sıralaması olmalıdır.
type: float nullable

serp_features: Bir arama motoru sonuç sayfasındaki (SERP) geleneksel organik sonuçlar dışındaki zenginleştirilmiş sonuçlar.
type: array(string)
enum: "ai_overview_sitelink" "snippet" "ai_overview" "local_pack" "sitelink" "news" "image" "video" "discussion" "tweet" "paid_top" "paid_bottom" "paid_sitelink" "shopping" "knowledge_card" "knowledge_panel" "question" "image_th" "video_th" "organic_shopping"

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

traffic_potential (10 units): Hedef anahtar kelimeniz için 1 numarada yer alan sayfanın, sıralandığı tüm anahtar kelimelerden aldığı Organik Trafik toplamı.
type: integer nullable

volume (10 units): Bilinen en güncel 12 aylık veriye göre, bir anahtar kelimenin aylık ortalama arama sayısına ilişkin Arama Hacmi tahmini.
type: integer nullable

volume_desktop_pct: Bir anahtar kelime için masaüstü cihazlarda yapılan aramaların yüzdesi.
type: float nullable

volume_mobile_pct: Bir anahtar kelime için mobil cihazlarda yapılan aramaların yüzdesi.
type: float nullable

word_count:
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.

volume_monthly_date_tostring

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

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

Arama hedefi: bir etki alanı veya bir 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
search_enginestring

[5 Ağustos 2024 itibarıyla kullanımdan kaldırıldı].

İzin verilen değerler:google
Varsayılan:google
keywordsstring

Metriklerini göstermek için virgülle ayrılmış anahtar kelime listesi.

keyword_list_idinteger

Metriklerini göstermek için mevcut bir anahtar kelime listesinin id'si.

outputstring

Çıktı formatı.

İzin verilen değerler:jsoncsvxmlphp

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

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

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