DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
En Çok Arananlar
Bir konumdaki en yüksek hacimli anahtar kelimeler, seed veya site filtresi olmadan. limit, offset ve offset_token ile sayfalanır; ilk sayfalardan sonra tokenı kullanın. 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. Bu, ailenin keşif ucudur: henüz seed anahtar kelime yokken kullanın, sonra post_dataforseo_labs_google_keyword_ideas_live ile daraltın.
Fiyatlandırma referansı
- Ölçümlendirme: bildirilen yanıt maliyeti.
- Referans istek tahmini: USD 0.1356.
- 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)[]
- filtersTür: array (object | null)[] | null
sonuç filtreleme parametreleri dizisi
isteğe bağlı alan
aynı anda birkaç filtre ekleyebilirsiniz (en fazla 8 filtre)
koşullar arasındaand,ormantıksal operatörünü ayarlamalısınız
şu operatörler desteklenir:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,match,not_match,ilike,not_ilike,like,not_like%operatörünülikevenot_likeile, ayrıcailikevenot_ilikeile kullanarak sıfır veya daha fazla karakterden oluşan herhangi bir dizeyle eşleşebilirsiniz
örnek:["keyword_info.search_volume",">",0][["keyword_info.search_volume","in",[0,1000]],
"and",
["keyword_info.competition_level","=","LOW"]][["keyword_info.search_volume",">",100],
"and",
[["keyword_info.cpc","<",0.5],
"or",["keyword_info.high_top_of_page_bid","<=",0.5]]]
filtreler hakkında daha fazla bilgi için Dataforseo Labs - Filters veya bu yardım merkezi kılavuzuna bakınBoş nesne - ignoreTür: boolean | null
_synonyms çok benzer anahtar kelimeleri yoksay
isteğe bağlı alantrueolarak ayarlanırsa yalnızca temel anahtar kelimeler döndürülür, çok benzeyen tüm anahtar kelimeler hariç tutulur;
varsayılan değer:false - 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 - 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 - limitTür: integer | null
döndürülen maksimum anahtar kelime sayısı
isteğe bağlı alan
Not: her sonraki isteğe verilen yanıtta sağlananoffset_tokenile 1000'den fazla sonuç alabilirsiniz
varsayılan değer:1000
maksimum değer:1000 - 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 - offsetTür: integer | null
döndürülen anahtar kelimelerin sonuç dizisindeki offset
isteğe bağlı alan
varsayılan değer:010değerini belirtirseniz sonuç dizisindeki ilk on anahtar kelime atlanır ve veriler sonraki anahtar kelimeler için sağlanır
Not: bu parametreyi yalnızca 10.000'e kadar sonuç alırken kullanmanızı öneririz
10.000'den fazla sonuç almak için bunun yerineoffset_tokenkullanın. - offsetTür: string | null
_token sonraki istekler için offset tokenı
isteğe bağlı alan
her isteğe verilen yanıtın aynı adlı alanında sağlanır;
tek bir istekte 10.000'den fazla sonuç almaya çalışırken zaman aşımlarını önlemek için bu parametreyi kullanın;
yanıt dizisindeki benzersizoffset_tokendeğerini belirterek ilk görevin sonraki sonuçlarını alırsınız;offset_tokendeğerleri her sonraki görev için benzersizdir
Not: istekteoffset_tokenbelirtilirse, bir görev işlenirkenlimitdışındaki tüm diğer parametreler dikkate alınmaz.
bu parametre hakkında daha fazla bilgiyi Yardım Merkezimizde bulabilirsiniz - orderTür: array string[] | null
_by sonuç sıralama kuralları
isteğe bağlı alan
sonuçları sıralamak içinfiltersdizisindekiyle aynı değerleri kullanabilirsiniz
olası sıralama türleri:asc— sonuçlar artan düzende sıralanırdesc— sonuçlar azalan düzende sıralanır
sıralama türünü ayarlamak için virgül kullanmalısınız
örnek:["keyword_info.competition,desc"]
varsayılan kural:["keyword_info.search_volume,desc"]
tek bir istekte en fazla üç sıralama kuralı ayarlayabileceğinizi unutmayın
birden çok sıralama kuralını virgülle ayırmalısınız
örnek:["keyword_info.search_volume,desc","keyword_info.cpc,desc"] - 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_DataforseoLabsGoogleTopSearchesLiveResponseInfo200
- 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_DataforseoLabsGoogleTopSearchesLiveTaskInfo
- 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 kelimede organik olarak sıralanan ilk 10 web sayfası arasındaki ortalama sıra 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
döndürülen anahtar kelime fikri
- keywordTür: object | null · Response36Afe1097B20_KeywordInfo
_info döndürülen anahtar kelime fikri 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ü
- 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
- offsetTür: integer | null
geçerli offset değeri
- offsetTür: string | null
_token sonraki istekler için ofset token'ı
bu alanda sağlanan dizeyi, ilk görevin sonraki sonuçlarını almak için kullanabilirsiniz;
not:offset_tokendeğerleri her sonraki görev için benzersizdir - seTür: string | null
_type arama motoru türü
- totalTür: integer | null Biçim: int64
_count veritabanımızda isteğinizle ilgili toplam sonuç sayısı
- 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/top_searches/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_name": "English",
"location_code": 2840,
"limit": 3
}
]'
{
"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,
"total_count": null,
"items_count": null,
"offset": null,
"offset_token": null,
"items": [
{
"se_type": null,
"keyword": null,
"location_code": null,
"language_code": 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]"
}
]
}
]
}
]
}