DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Anahtar kelime özeti
Labs'in bir keywords listesi hakkında bildiği her şey tek çağrıda: hacim, zorluk, niyet, rekabet ve tetikledikleri SERP özellikleri. se_type, location_code, language_code, items_count ve items döndürür. Bu uç nokta limit parametresi almaz, ancak öğe başına değil çağrı başına fiyatlandırılır, bu yüzden tüm listeyi tek seferde gönderin. DataForSEO zarfına sarılıdır: veriler tasks[0].result içinde, sonuç tasks[0].status_code içinde — reddedilen bir istek yine de HTTP 200 döndürür. Anahtar kelimeleriniz varsa buradan başlayın; daha fazlasına ihtiyaç duyduğunuzda gideceğiniz yer post_dataforseo_labs_google_keyword_ideas_live.
Fiyatlandırma referansı
- Ölçümlendirme: bildirilen yanıt maliyeti.
- Referans istek maliyeti tahmini: USD 0.0254.
- Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.
Yalnızca referans üst verisidir — hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.
- Tür: array (object | null)[]
- includeTür: boolean | null
_clickstream _data sonuçta tıklama akışına dayalı metriklerden verileri dahil et veya hariç tut
isteğe bağlı alan
parametretrueolarak ayarlanırsa yanıttaclickstream_keyword_info,keyword_info_normalized_with_clickstreamvekeyword_info_normalized_with_bingalanlarını alırsınız
varsayılan değer:false
bu parametre etkinleştirildiğinde istek için iki kat ücret alınırtıklama akışına dayalı metriklerin nasıl hesaplandığı hakkında daha fazla bilgiyi bu Yardım Merkezi makalesinde bulabilirsiniz
- includeTür: boolean | null
_serp _info her anahtar kelime için SERP verilerini dahil et
isteğe bağlı alantrueolarak ayarlanırsa yanıttaki her anahtar kelime için SERP verilerini (arama sonucu sayısı, ilgili URL ve SERP özellikleri) içeren birserp_infodizisi döndürürüz
varsayılan değer:false - keywordsTür: array string[]
anahtar kelimeler
zorunlu alan
belirtebileceğiniz maksimum anahtar kelime sayısı: 700
her anahtar kelime için maksimum karakter sayısı: 80
her anahtar kelime ifadesi için maksimum kelime sayısı: 10
belirtilen anahtar kelimeler küçük harf biçimine dönüştürülür, veriler ayrı bir dizide sağlanırbu dizide belirtilen bazı anahtar kelimeler aldığınız sonuçlarda yer almıyorsa veritabanımızın bu tür anahtar kelimeleri içermediğini ve bunlara ilişkin veri döndüremeyeceğini unutmayın
sonuçlarda yer almayan anahtar kelimeler için ücret alınmazDataForSEO API'lerinde
keywordvekeywordsalanlarının kuralları ve sınırlamaları hakkında daha fazla bilgiyi bu Yardım Merkezi makalesinde bulabilirsiniz - languageTür: string | null
_code dil kodu
language_namebelirtmezseniz zorunlu alan
Not:language_nameveyalanguage_codedeğerlerinden biri belirtilmelidir
kullanılabilir konumların listesinilanguage_codeile birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
örnek:en - languageTür: string
_name dilin tam adı
language_codebelirtmezseniz zorunlu alan
Not:language_nameveyalanguage_codedeğerlerinden biri belirtilmelidir
kullanılabilir konumların listesinilanguage_nameile birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
örnek:English - locationTür: integer
_code konum kodu
location_namebelirtmezseniz zorunlu alan
Not:location_nameveyalocation_codedeğerlerinden biri belirtilmelidir
kullanılabilir konumların listesinilocation_codeile birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
örnek:2840 - locationTür: string
_name konumun tam adı
location_codebelirtmezseniz zorunlu alan
Not:location_nameveyalocation_codedeğerlerinden biri belirtilmelidir
kullanılabilir konumların listesinilocation_nameile birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
örnek:United Kingdom - tagTür: string | null
kullanıcı tanımlı görev tanımlayıcısı
isteğe bağlı alan
karakter sınırı 255
bu parametreyi görevi tanımlamak ve sonuçla eşleştirmek için kullanabilirsiniz
belirtilentagdeğerini yanıtındatanesnesinde bulacaksınız
- Tür: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveResponseInfo200
- Tür: number | null Biçim: doublecost
toplam görev maliyeti, USD
- Tür: integer | nullstatus
_code genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz
- Tür: string | nullstatus
_message genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz
- Tür: array (object | null)[] | nulltasks
görev dizisi
- Tür: object | null · Response36Afe1097B20_DataforseoLabsGoogleKeywordOverviewLiveTaskInfo
- costTür: number | null Biçim: double
toplam görev maliyeti, USD
- dataTür: object | null
POST isteğinde belirttiğiniz parametrelerin aynısını içerir
- propertyTür: object | null
Name
- idTür: string | null
görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı
- pathTür: array (string | null)[] | null
URL yolu
- resultTür: array (object | null)[] | null
sonuç dizisi
- itemsTür: array (object | null)[] | null
anahtar kelimeleri ve ilgili verileri içerir
- avgTür: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info döndürülen anahtar kelime için geri bağlantı verileri
bu nesne ortalama geri bağlantı, yönlendiren sayfa ve alan adı sayısının yanı sıra anahtar kelime için organik olarak sıralanan ilk 10 web sitesi arasındaki ortalama rank değerlerini sağlar- backlinksTür: number | null
ortalama geri bağlantı sayısı
- dofollowTür: number | null
ortalama dofollow bağlantı sayısı
- lastTür: string | null
_updated _time anahtar kelime verilerinin güncellendiği tarih ve saat
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:2019-11-15 12:57:46 +00:00 - mainTür: number | null
_domain _rank - rankTür: number | null
- referringTür: number | null
_domains ortalama yönlendiren alan adı sayısı
- referringTür: number | null
_main _domains ortalama yönlendiren ana alan adı sayısı
- referringTür: number | null
_pages ortalama yönlendiren sayfa sayısı
- seTür: string | null
_type arama motoru türü
- clickstreamTür: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info döndürülen anahtar kelime için clickstream verileri
bu alanın sonuçlarını almak içininclude_clickstream_dataparametresitrueolarak ayarlanmalıdır- ageTür: object | null
_distribution - propertyTür: integer | null Biçim: int64
Name Signed 64-bit integers (long type).
- genderTür: object | null
_distribution - propertyTür: integer | null Biçim: int64
Name Signed 64-bit integers (long type).
- lastTür: string | null
_updated _time anahtar kelime verilerinin güncellendiği tarih ve saat
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:2019-11-15 12:57:46 +00:00 - monthlyTür: array (object | null)[] | null
_searches aylık aramalar
bu anahtar sözcük fikrinin (son on iki ay için mevcut olan) belirtilen coğrafi konumlara yönelik arama sayısını (yaklaşık olarak) temsil eder- monthTür: integer | null
Ay.
- searchTür: integer | null
_volume aylık ortalama arama hacmi oranı
- yearTür: integer | null
Yıl.
- searchTür: integer | null Biçim: int64
_volume ortalama aylık arama hacmi oranı
belirli anahtar sözcük fikrinin google.com'da (yaklaşık) arama sayısını temsil eder
- keywordTür: string | null
anahtar kelime
anahtar kelime %## kodları çözülmüş olarak döndürülür ('+' karakteri boşluk karakteri olarak çözülür) - keywordTür: object | null · Response36Afe1097B20_KeywordInfo
_info döndürülen anahtar kelime için anahtar kelime verileri
- categoriesTür: array integer[] | null
- competitionTür: number | null
rekabet
verilen anahtar kelimeyle ilişkili göreli rekabet miktarını gösterir. Bu değer Google Ads verilerine dayanır ve 0 ile 1 arasında (dahil) olabilir - competitionTür: string | null
_level - cpcTür: number | null
tıklama başına maliyet
anahtar kelime için geçmişte ödenen ortalama tıklama başına maliyeti (USD) gösterir - highTür: number | null
_top _of _page _bid reklamın ilk sayfanın üstünde gösterilmesi için maksimum teklif
reklamların gösterildiği en düşük tekliflerin yaklaşık %80'inden yüksek olan değeri belirtir (reklamverenler için Google Ads istatistiklerine göre)
değer, POST isteğinde belirtilen konuma göre farklılık gösterebilir - lastTür: string | null
_updated _time anahtar kelime verilerinin güncellendiği tarih ve saat
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:2019-11-15 12:57:46 +00:00 - lowTür: number | null
_top _of _page _bid reklamın ilk sayfanın üstünde gösterilmesi için minimum teklif
reklamların gösterildiği en düşük tekliflerin yaklaşık %20'sinden yüksek olan değeri belirtir (reklamverenler için Google Ads istatistiklerine göre)
değer, POST isteğinde belirtilen konuma göre farklılık gösterebilir - monthlyTür: array (object | null)[] | null
_searches aylık aramalar
bu anahtar sözcük fikrinin (son on iki ay için mevcut olan) belirtilen coğrafi konumlara yönelik arama sayısını (yaklaşık olarak) temsil eder- monthTür: integer | null
Ay.
- searchTür: integer | null
_volume aylık ortalama arama hacmi oranı
- yearTür: integer | null
Yıl.
- seTür: string | null
_type arama motoru türü
- searchTür: integer | null Biçim: int64
_volume ortalama aylık arama hacmi oranı
belirli anahtar sözcük fikrinin google.com'da (yaklaşık) arama sayısını temsil eder - searchTür: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend arama hacmi trendi değişiklikleri
arama hacminin önceki döneme göre yüzde olarak değişimini gösterir- monthlyTür: integer | null
arama hacminin önceki aya göre yüzde olarak değişimi
- quarterlyTür: integer | null
arama hacminin önceki çeyreğe göre yüzde olarak değişimi
- yearlyTür: integer | null
arama hacminin önceki yıla göre yüzde olarak değişimi
- keywordTür: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing Bing arama hacmiyle normalleştirilmiş anahtar kelime arama hacmini içerir
- isTür: boolean | null
_normalized anahtar kelime bilgileri normalleştirilmiştir true ise değerler Bing verileriyle normalleştirilir
- lastTür: string | null
_updated _time veri kümesinin güncellendiği tarih ve saat UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00” örnek: 2019-11-15 12:57:46 +00:00
- monthlyTür: array (object | null)[] | null
_searches aylık arama hacmi oranları bir yılın belirli bir ayındaki arama hacmi oranlarını içeren nesne dizisi
- monthTür: integer | null
Ay.
- searchTür: integer | null
_volume aylık ortalama arama hacmi oranı
- yearTür: integer | null
Yıl.
- searchTür: integer | null
_volume bir anahtar kelimenin güncel arama hacmi oranı
- keywordTür: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream clickstream verileriyle normalleştirilmiş anahtar kelime arama hacmini içerir
- isTür: boolean | null
_normalized anahtar kelime bilgileri normalleştirilmiştir true ise değerler Bing verileriyle normalleştirilir
- lastTür: string | null
_updated _time veri kümesinin güncellendiği tarih ve saat UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00” örnek: 2019-11-15 12:57:46 +00:00
- monthlyTür: array (object | null)[] | null
_searches aylık arama hacmi oranları bir yılın belirli bir ayındaki arama hacmi oranlarını içeren nesne dizisi
- monthTür: integer | null
Ay.
- searchTür: integer | null
_volume aylık ortalama arama hacmi oranı
- yearTür: integer | null
Yıl.
- searchTür: integer | null
_volume bir anahtar kelimenin güncel arama hacmi oranı
- keywordTür: object | null · Response36Afe1097B20_KeywordProperties
_properties anahtar kelime hakkında ek bilgiler
- coreTür: string | null
_keyword gruptaki ana anahtar kelime
eş anlamlı kümeleme algoritması tarafından belirlenen gruptaki ana anahtar kelimeyi içerir
değernullise veritabanımızda ilgili algoritmanınkeywordile eş anlamlı olarak tanımlayabileceği hiçbir anahtar kelime yoktur - detectedTür: string | null
_language anahtar kelimenin algılanan dili
anahtar kelimenin sistemimiz tarafından belirlenen dilini gösterir - isTür: boolean | null
_another _language anahtar kelimenin algılanan dili ayarlanan dilden farklı
trueise istekte ayarlanan dil, sistemimizin belirli bir anahtar kelime için belirlediği dille eşleşmez - keywordTür: integer | null
_difficulty bir anahtar kelimenin ilk 10 organik sonuç arasına girme zorluğu
bir anahtar kelime için ilk 10 organik sonuç arasına girme şansını 0'dan 100'e kadar logaritmik bir ölçekte gösterir;
diğer parametrelerin yanı sıra SERP'teki ilk 10 sayfanın bağlantı profilleri analiz edilerek hesaplanır;
metrik hakkında daha fazla bilgi için bu yardım merkezi kılavuzuna bakın - seTür: string | null
_type arama motoru türü
- synonymTür: string | null
_clustering _algorithm eş anlamlıları tanımlamak için kullanılan algoritma
olası değerler:keyword_metrics-keyword_infoparametrelerine dayanan algoritmayı belirtirtext_processing- metin tabanlı algoritmayı belirtir
değernullise veritabanımızda ilgili algoritmanınkeywordile eş anlamlı olarak tanımlayabileceği hiçbir anahtar kelime yoktur - wordsTür: integer | null Biçim: int64
_count anahtar kelimedeki sözcük sayısı
anahtar kelimenin kaç sözcükten oluştuğunu gösterir
- languageTür: string | null
_code POST dizisindeki dil kodu
- locationTür: integer | null
_code POST dizisindeki konum kodu
- seTür: string | null
_type arama motoru türü
- searchTür: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignTür: array (string | null)[] | null
_intent tamamlayıcı arama niyetleri
olası değerler:informational,navigational,commercial,transactional - lastTür: string | null
_updated _time anahtar kelime verilerinin güncellendiği tarih ve saat
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:2019-11-15 12:57:46 +00:00 - mainTür: string | null
_intent ana arama niyeti
olası değerler:informational,navigational,commercial,transactional - seTür: string | null
_type arama motoru türü
- searchTür: boolean | null
_partners Google ve iş ortağı siteleri için verileri gösterir
trueise sonuçlar Google ve Google aramasını barındıran iş ortağı siteleri genelindeki sahip olunan, işletilen ve sendikasyon ağları için döndürülür;falseise sonuçlar yalnızca Google arama siteleri için döndürülür - serpTür: object | null · Response36Afe1097B20_SerpInfo
_info SERP verileri
nulldeğeri, POST dizisindeinclude_serp_infoalanınıtrueolarak ayarlamadıysanız veya veritabanımızda bu anahtar kelime için SERP verisi yoksa döner- checkTür: string | null
_url arama motoru sonuçlarına doğrudan URL
doğru sonuçlar sunduğumuzdan emin olmak için kullanabilirsiniz - lastTür: string | null
_updated _time anahtar kelime verilerinin güncellendiği tarih ve saat
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:2019-11-15 12:57:46 +00:00 - previousTür: string | null
_updated _time en son SERP verisi güncellemesinden bir önceki tarih ve saat
UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”
örnek:2019-10-15 12:57:46 +00:00 - seTür: integer | null Biçim: int64
_results _count döndürülen anahtar kelime için arama sonucu sayısı
- seTür: string | null
_type arama motoru türü
- serpTür: array (string | null)[] | null
_item _types SERP'teki arama sonucu türleri
SERP'te bulunan arama sonucu türlerini (items) içerir
olası öğe türleri:answer_box,app,carousel,multi_carousel,featured_snippet,google_flights,google_reviews,third_party_reviews,google_posts,images,jobs,knowledge_graph,local_pack,hotels_pack,map,organic,paid,people_also_ask,related_searches,people_also_search,shopping,top_stories,twitter,video,events,mention_carousel,recipes,top_sights,scholarly_articles,popular_products,podcasts,questions_and_answers,find_results_on,stocks_box,visual_stories,commercial_units,local_services,google_hotels,math_solver,currency_box,product_considerations,found_on_web,short_videos,refine_products,explore_brands,perspectives,discussions_and_forums,compare_sites,courses,ai_overview;
not gerçek sonuçlar yalnızcaorganic,paid,featured_snippetvelocal_packöğeleri için döndürülür
- itemsTür: integer | null Biçim: int64
_count itemsdizisinde döndürülen sonuç sayısı - languageTür: string | null
_code POST dizisindeki dil kodu
- locationTür: integer | null
_code POST dizisindeki konum kodu
- seTür: string | null
_type arama motoru türü
- resultTür: integer | null Biçim: int64
_count result dizisindeki öğe sayısı
- statusTür: integer | null
_code görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz
- statusTür: string | null
_message görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz
- timeTür: string | null
yürütme süresi, saniye
- Tür: integer | null Biçim: int64tasks
_count tasks dizisindeki görev sayısı
- Tür: integer | null Biçim: int64tasks
_error tasks dizisinde hata ile dönen görev sayısı
- Tür: string | nulltime
toplam yürütme süresi, saniye
- Tür: string | nullversion
API'nin geçerli sürümü
application/json - 400
İstek işlenemedi. İstek parametrelerini kontrol edin.
- 401
Geçerli bir Felo API anahtarı gerekir.
- 402
Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.
- 403
Hesabın bu işlemi gerçekleştirme izni yok.
- 429
İstek veya harcama sınırına ulaşıldı.
- 502
Hizmet isteği tamamlayamadı.
- 503
API veya faturalandırma hizmeti geçici olarak kullanılamıyor.
- 504
İstek işlenirken hizmet zaman aşımına uğradı.
- default
Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/keyword_overview/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"include_clickstream_data": true,
"include_serp_info": true,
"keywords": [
"iphone"
]
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"se_type": null,
"location_code": null,
"language_code": null,
"items_count": null,
"items": [
{
"se_type": null,
"keyword": null,
"location_code": null,
"language_code": null,
"search_partners": null,
"keyword_info": "[Max Depth Exceeded]",
"keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
"keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
"clickstream_keyword_info": "[Max Depth Exceeded]",
"keyword_properties": "[Max Depth Exceeded]",
"serp_info": "[Max Depth Exceeded]",
"avg_backlinks_info": "[Max Depth Exceeded]",
"search_intent_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}