DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Canlı Google Organic SERP Advanced
Google'da bir anahtar kelime için sıralı sonuçları eşzamanlı olarak döndürür. keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count ve items döndürür. advanced varsayılan seçimdir; yalnızca sıralı liste önemliyse regular, yalnızca ayrıştırıcının neyi attığını görmek için html 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.
Fiyatlandırma referansı
- Ölçümlendirme: bildirilen yanıt maliyeti.
- Referans istek tahmini: USD 0.0175.
- 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)[]
- browserTür: integer | null
_screen _height tarayıcı ekran yüksekliği isteğe bağlı alan belirli bir cihaz için piksel sıralaması hesaplamak üzere özel bir tarayıcı ekran yüksekliği ayarlayabilirsiniz; şu aralıkta belirtilebilir: 240-9999; varsayılan olarak parametre şu şekilde ayarlanır: masaüstü için 1080; android'de mobile için 640; iOS'te mobile için 812; Not: bu parametreyi kullanmak için calculate_rectangles değerini true olarak ayarlayın
- browserTür: integer | null
_screen _resolution _ratio tarayıcı ekran çözünürlük oranı isteğe bağlı alan belirli bir cihaz için piksel sıralaması hesaplamak üzere özel bir tarayıcı ekran çözünürlük oranı ayarlayabilirsiniz; şu aralıkta belirtilebilir: 0.5-3; varsayılan olarak parametre şu şekilde ayarlanır: masaüstü için 1; android'de mobile için 3; iOS'te mobile için 3; Not: bu parametreyi kullanmak için calculate_rectangles değerini true olarak ayarlayın
- browserTür: integer | null Biçim: int64
_screen _width tarayıcı ekran genişliği isteğe bağlı alan belirli bir cihaz için piksel sıralaması hesaplamak üzere özel bir tarayıcı ekran genişliği ayarlayabilirsiniz; şu aralıkta belirtilebilir: 240-9999; varsayılan olarak parametre şu şekilde ayarlanır: masaüstü için 1920; android'de mobile için 360; iOS'te mobile için 375; Not: bu parametreyi kullanmak için calculate_rectangles değerini true olarak ayarlayın
- calculateTür: boolean | null
_rectangles gelişmiş sonuçlardaki SERP öğeleri için piksel sıralaması hesapla isteğe bağlı alan piksel sıralaması, sonuç snippet'i ile ekranın sol üst köşesi arasındaki mesafeyi ifade eder; Daha fazla bilgi için Yardım Merkezini ziyaret edin>> varsayılan olarak parametre false olarak ayarlanır; Not: bu parametreyi kullanmak için ek olarak $0.002 ücret alınır
- depthTür: integer | null
ayrıştırma derinliği isteğe bağlı alan SERP'teki sonuç sayısı varsayılan değer: 10 maksimum değer: 200 Hesabınız 10 sonuca kadar içeren her SERP için faturalandırılır; 10'un üzerinde derinlik ayarlamak, arama motoru 10'dan fazla sonuç döndürürse ek ücretlere yol açabilir; Maliyet Fiyatlandırma sayfasında hesaplanabilir.
- deviceTür: string | null
cihaz türü isteğe bağlı alan belirli bir cihaz türü için sonuç döndür şu değerleri alabilir: desktop, mobile varsayılan değer: desktop
- findTür: array string[] | null
_targets _in hedefler için kontrol edilecek SERP öğe türleri isteğe bağlı alan bu parametreyi etkinleştirmek için stop_crawl_on_match da etkinleştirilmelidir hangi SERP öğe türlerinin hedef eşleşmeleri için kontrol edileceğini belirtir belirtilmezse url ve domain alanlarına sahip tüm birinci düzey öğeler hedefler için kontrol edilir olası değerler: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Not: ignore_targets_in ile aynı öğe türlerini içeremez örnek: "find_targets_in": ["organic", "featured_snippet"] bu parametre hakkında daha fazla bilgiyi Yardım Merkezimizde bulabilirsiniz
- groupTür: boolean | null
_organic _results ilgili sonuçları görüntüle isteğe bağlı alan true olarak ayarlanırsa yanıttaki related_result öğesi üst organik sonucunun snippet'i olarak sağlanır; false olarak ayarlanırsa related_result öğesi ayrı bir organik sonuç olarak sağlanır; varsayılan değer: true
- ignoreTür: array string[] | null
_targets _in hedef aramasından hariç tutulacak SERP öğe türleri isteğe bağlı alan bu parametreyi etkinleştirmek için stop_crawl_on_match da etkinleştirilmelidir hedef eşleşmeleri aranırken hangi SERP öğe türlerinin hariç tutulacağını belirtir olası değerler: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Not: find_targets_in ile aynı öğe türlerini içeremez örnek: "ignore_targets_in": ["paid", "images"] bu parametre hakkında daha fazla bilgiyi Yardım Merkezimizde bulabilirsiniz
- keywordTür: string
anahtar kelime zorunlu alan keyword alanında en fazla 700 karakter belirtebilirsiniz tüm %## dizileri çözümlenir (“+” karakteri boşluk karakterine çözümlenir) keyword için “%” karakterini kullanmanız gerekiyorsa “%25” olarak belirtin; keyword için “+” karakterini kullanmanız gerekiyorsa “%2B” olarak belirtin; bu alan “allinanchor:”, “allintext:”, “allintitle:”, “allinurl:”, “cache:”, “define:”, “definition:”, “filetype:”, “id:”, “inanchor:”, “info:”, “intext:”, “intitle:”, “inurl:”, “link:”, “site:” gibi parametreler içeriyorsa görev başına ücret 5 ile çarpılır DataForSEO API'lerinde keyword ve keywords alanlarının kural ve sınırlamaları hakkında daha fazla bilgiyi bu Yardım Merkezi makalesinde bulabilirsiniz
- languageTür: string | null
_code arama motoru dil kodu language_name belirtirseniz isteğe bağlı alan bu alanı kullanırsanız language_name belirtmeniz gerekmez arama motorunun mevcut dillerinin listesini language_code değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/serp/google/languages örnek: en
- languageTür: string | null
_name arama motoru dilinin tam adı language_code belirtirseniz isteğe bağlı alan bu alanı kullanırsanız language_code belirtmeniz gerekmez arama motorunun mevcut dillerinin listesini language_name değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/serp/google/languages örnek: English
- loadTür: boolean | null
_async _ai _overview asenkron ai overview yükle isteğe bağlı alan asenkron olarak yüklenseler bile SERP'lerde ai_overview öğeleri almak için true olarak ayarlayın; false olarak ayarlanırsa ai_overview öğelerini yalnızca önbellekten alırsınız; varsayılan değer: false Not: bu parametreyi kullanmak için ek olarak $0.002 ücret alınır; öğe yoksa veya "asynchronous_ai_overview": false içeriyorsa tüm ek ücretler hesap bakiyenize iade edilir
- locationTür: integer | null
_code arama motoru konum kodu location_name veya location_coordinate belirtmezseniz zorunlu alan bu alanı kullanırsanız location_name veya location_coordinate belirtmeniz gerekmez arama motorlarının mevcut konumlarının listesini location_code değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/serp/google/locations örnek: 2840
- locationTür: string | null
_coordinate bir konumun GPS koordinatları location_name veya location_code belirtirseniz isteğe bağlı alan bu alanı kullanırsanız location_name veya location_code belirtmeniz gerekmez location_coordinate parametresi "latitude,longitude,radius" biçiminde belirtilmelidir "latitude" ve "longitude" için maksimum ondalık basamak sayısı: 7 "radius" için minimum değer: 199 (mm) "radius" için maksimum değer: 199999 (mm) örnek: 53.476225,-2.243572,200
- locationTür: string | null
_name arama motoru konumunun tam adı location_code veya location_coordinate belirtmezseniz zorunlu alan bu alanı kullanırsanız location_code veya location_coordinate belirtmeniz gerekmez arama motorunun mevcut konumlarının listesini location_name değerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz: https://api.dataforseo.com/v3/serp/google/locations örnek: London,England,United Kingdom
- matchTür: string | null
_type hedef eşleşme türü stop_crawl_on_match belirtilirse zorunlu alan match_value için eşleşme türü olası değerler: domain – belirli alan adı veya alt alan adı with_subdomains – ana alan adı ve alt alan adları wildcard – joker deseni
- matchTür: string | null
_value hedef alan adı, alt alan adı veya joker değeri stop_crawl_on_match belirtilirse zorunlu alan hedef alan adı, alt alan adı veya joker değeri belirtin; Not: alan adı veya alt alan adı istek protokolü olmadan belirtilmelidir; örnek: "match_value": "dataforseo.com", "match_value": "/blog/post-*"
- maxTür: integer | null
_crawl _pages sayfa tarama limiti isteğe bağlı alan taranacak arama sonuçları sayfası sayısı maksimum değer: 100 Not: taranan her sayfa için ücret alınır (sayfa başına 10 organik sonuç); fiyatlandırma hakkında daha fazla bilgi için Fiyatlandırma sayfasına bakın; Not#2: max_crawl_pages ve depth parametreleri birbirini tamamlar; daha fazla bilgi için yardım merkezimize bakın
- osTür: string | null
cihaz işletim sistemi isteğe bağlı alan device alanında desktop belirtirseniz şu değerlerden birini seçin: windows, macos varsayılan değer: windows device alanında mobile belirtirseniz şu değerlerden birini seçin: android, ios varsayılan değer: android
- peopleTür: integer | null
_also _ask _click _depth ilgili öğeye yapılan tıklamalar isteğe bağlı alan ek people_also_ask_element öğeleri almak için people_also_ask öğesindeki tıklama derinliğini belirtin; Not: her tıklama için hesabınızdan $0.00015 ek ücret alınır; öğe yoksa veya belirttiğinizden daha az tıklama yaparsak tüm ek ücretler hesap bakiyenize iade edilir olası değerler: 1 ile 4 arası
- removeTür: array string[] | null
_from _url URL'lerden belirli parametreleri kaldırma isteğe bağlı alan bu alanı kullanarak sonuçtaki URL'lerden kaldırılacak en fazla 10 parametre belirtebilirsiniz örnek: "remove_from_url": ["srsltid"] Not: target alanı belirtilirse belirtilen URL parametreleri aramadan önce kaldırılır
- seTür: string | null
_domain arama motoru alan adı isteğe bağlı alan ilgili arama motoru alan adını belirttiğiniz konum ve dile göre otomatik olarak seçeriz ancak bu alanda özel bir arama motoru alan adı ayarlayabilirsiniz örnek: google.co.uk, google.com.au, google.de vb.
- searchTür: string | null
_param arama sorgusunun ek parametreleri isteğe bağlı alan mevcut parametrelerin listesini ve ek ayrıntıları burada bulabilirsiniz Not: aşağıdaki arama motoru parametreleri desteklenmez ve belirtilirse otomatik olarak kaldırılır: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- stopTür: array (object | null)[] | null
_crawl _on _match taramayı durduracak hedef dizisi isteğe bağlı alan belirtilirse yanıt, belirtilen match_value dahil olmak üzere bu değere kadar SERP sonuçlarını içerir; bu dizide en fazla 10 hedef değer belirtebilirsiniz örnek: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] bu parametre hakkında daha fazla bilgi için Yardım Merkezimize bakın — https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Hesabınız, belirtilen hedefler üzerinden taranan her SERP için faturalandırılır
- matchTür: string | null
_type hedef eşleme türü stop_crawl_on_match belirtilirse zorunlu alan; match_value için eşleme türü olası değerler: domain, with_subdomains, wildcard
- matchTür: string | null
_value hedef alan adı veya joker değeri stop_crawl_on_match belirtilirse zorunlu alan; bir hedef alan adı veya joker değeri belirtin; Not: alan adı istek protokolü olmadan belirtilmelidir; örnek: dataforseo.com
- tagTür: string | null
Kullanıcı tanımlı görev tanımlayıcısı. İsteğe bağlı alan. Karakter sınırı 255'tir. Bu parametreyi görevi tanımlamak ve sonuçla eşleştirmek için kullanabilirsiniz. Belirtilen tag değerini yanıtın data nesnesinde bulacaksınız.
- targetTür: string | null
sonuçların alınacağı hedef alan adı, alt alan adı veya web sayfası isteğe bağlı alan alan adı veya alt alan adı https:// ve www. olmadan belirtilmelidir target özelindeki görevlerin sonuçlarının yalnızca url dizesi içeren SERP öğelerini kapsayacağını unutmayın; sonuçları daraltmak için SERP'te arama desenini belirtmek üzere joker karakter (‘’) de kullanabilirsiniz; örnekler: example.com - https://example.com, https://www.example.com/ veya https://example.com/ gibi URL'lerle web sitesinin ana sayfası için sonuç döndürür; example.com - tüm sayfaları dahil olmak üzere alan adı için sonuç döndürür; example.com - tüm sayfaları ve alt alan adları dahil olmak üzere tüm alan adı için sonuç döndürür; example.com - alt alan adından bağımsız olarak ana sayfa için sonuç döndürür, örneğin https://en.example.com; example.com/example-page - tam URL için sonuç döndürür; example.com/example-page - belirtilen dizeyle başlayan tüm alan adı URL'leri için sonuç döndürür
- targetTür: string | null
_search _mode hedef eşleştirme modu isteğe bağlı alan bu parametreyi etkinleştirmek için stop_crawl_on_match da etkinleştirilmelidir stop_crawl_on_match içinde birden fazla hedef belirtildiğinde taramanın nasıl durdurulacağını tanımlar olası değerler: all, any all – tarama yalnızca belirtilen tüm hedefler bulunduğunda durur any – herhangi bir tek hedef bulunduğunda tarama durur varsayılan değer: any bu parametre hakkında daha fazla bilgiyi Yardım Merkezimizde bulabilirsiniz
- urlTür: string | null
arama sorgusunun doğrudan URL'si isteğe bağlı alan doğrudan bir URL belirtebilirsiniz ve biz bunu gerekli alanlara ayırırız. Bu yöntemin API'miz için işlenmesi en zor yöntem olduğunu ve URL'de tam dil ile konum belirtmenizi gerektirdiğini unutmayın. Çoğu durumda bu yöntemi önermeyiz. örnek: https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS Not: aşağıdaki arama motoru parametreleri desteklenmez ve belirtilirse otomatik olarak kaldırılır: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- Tür: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo200
- 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_SerpGoogleOrganicLiveAdvancedTaskInfo
- 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
- checkTür: string | null
_url arama motoru sonuçlarına doğrudan URL. Tam sonuçlar sağladığımızdan emin olmak için kullanabilirsiniz
- datetimeTür: string | null
sonucun alındığı tarih ve saat, UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”, örnek: 2019-11-15 12:57:46 +00:00
- itemTür: array (string | null)[] | null
_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, 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, recipes, top_sights, scholarly_articles, popular_products, questions_and_answers, find_results_on, stocks_box, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, short_videos, refine_products, perspectives, discussions_and_forums, compare_sites, ai_overview
- itemsTür: array (object | null)[] | null
öğenin bileşenleri
- pageTür: integer | null
arama sonuçları sayfa numarası
öğenin bulunduğu SERP sayfasının numarasını belirtir - positionTür: string | null
öğenin SERP'teki hizalaması
şu değerleri alabilir:left,right - rectangleTür: object | null · Response36Afe1097B20_AiModeRectangleInfo
dikdörtgen parametreleri
sonuç snippet'inin SERP'teki kartezyen koordinatlarını ve piksel boyutlarını içerir
POST isteğindekicalculate_rectanglestrueolarak ayarlanmamışsanulldeğerini alır- heightTür: number | null Biçim: double
öğenin piksel cinsinden yüksekliği
- widthTür: number | null Biçim: double
öğenin piksel cinsinden genişliği
- xTür: number | null Biçim: double
x ekseni koordinatı sonuç parçacığının sol üst köşesinin x ekseni koordinatı; başlangıç noktası ekranın sol üst köşesidir
- yTür: number | null Biçim: double
y ekseni koordinatı sonuç parçacığının sol üst köşesinin y ekseni koordinatı; başlangıç noktası ekranın sol üst köşesidir
- typeTür: string | null
öğe türü
- xpathTür: string | null
öğenin XPath değeri
- itemsTür: integer | null Biçim: int64
_count items dizisinde döndürülen sonuç sayısı.
- keywordTür: string | null
POST dizisinde alınan anahtar kelime anahtar kelime, %## çözülmüş olarak döndürülür (“+” karakteri boşluk karakterine çözülür)
- languageTür: string | null
_code POST dizisindeki dil kodu.
- locationTür: integer | null
_code POST dizisindeki konum kodu.
- pagesTür: integer | null Biçim: int64
_count alınan toplam arama sonucu sayfası sonuçta alınan toplam SERP sayısı
- refinementTür: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips arama iyileştirme çipleri
- itemsTür: array (object | null)[] | null
öğenin bileşenleri
- domainTür: string | null
SERP'teki alan adı
- optionsTür: array (object | null)[] | null
daha fazla arama daraltma seçeneği
- domainTür: string | null
SERP'teki alan adı
- titleTür: string | null
öğenin başlığı
- typeTür: string | null
öğe türü
- urlTür: string | null
daraltma parametreleri içeren arama URL'si
- titleTür: string | null
öğenin başlığı
- typeTür: string | null
öğe türü
- urlTür: string | null
daraltma parametreleri içeren arama URL'si
- typeTür: string | null
öğe türü
- xpathTür: string | null
öğenin XPath değeri
- seTür: string | null
_domain POST dizisindeki arama motoru alan adı
- seTür: integer | null Biçim: int64
_results _count SERP'teki toplam sonuç sayısı
- spellTür: object | null · Response36Afe1097B20_SpellInfo
arama motorunun otomatik düzeltmesi. Arama motoru düzeltilmiş bir anahtar kelime için sonuç sağladıysa, arama motorunun düzelttiği anahtar kelimeyi ve otomatik düzeltme türünü belirtiriz
- keywordTür: string | null
arama motorunun otomatik düzeltmesi sonucunda elde edilen anahtar kelime sonuçlar düzeltilmiş anahtar kelime için sağlanır
- typeTür: string | null
otomatik düzeltme türü olası değerler: did_you_mean, showing_results_for, no_results_found_for, including_results_for not: Yahoo ve Yandex yalnızca şu otomatik düzeltme türünü destekler: including_results_for
- typeTür: string | null
öğe 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/serp/google/organic/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein",
"calculate_rectangles": true
}
]'
{
"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": [
{
"keyword": null,
"type": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"refinement_chips": {
"type": null,
"xpath": null,
"items": [
"[Max Depth Exceeded]"
]
},
"item_types": [
null
],
"se_results_count": null,
"pages_count": null,
"items_count": null,
"items": [
{
"type": null,
"page": null,
"position": null,
"xpath": null,
"rectangle": "[Max Depth Exceeded]"
}
]
}
]
}
]
}