DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
OnPage Görevlerini Ayarlama
target için bir tarama başlatır ve tasks[0].id içinde bir görev id değeri döndürür — bu id, bu ailedeki diğer tüm araçların ihtiyaç duyduğu tutamaçtır, bu yüzden saklayın. max_crawl_pages taramayı sınırlar, start_url, max_crawl_depth, priority_urls ve crawl_delay onu şekillendirir, store_raw_html ise post_dataforseo_on_page_raw_html uç noktasının daha sonra sunacak bir şeyi olup olmayacağını belirler. 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, alışılmış submit/fetch ikilisi değildir: tarama, ardından bir düzine başka aracın id ile sorguladığı bir oturumdur. crawl_progress finished olana kadar get_dataforseo_on_page_summary yoklayın; example.com'un tek sayfalık taraması bir dakikadan çok daha kısa sürdü.
Fiyatlandırma referansı
- Ölçümlendirme: bildirilen yanıt maliyeti.
- Referans istek tahmini: USD 0.003.
- 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)[]
- acceptTür: string | null
_language web sitesine erişim için dil başlığı
isteğe bağlı alan
tüm yerel ayar biçimleri desteklenir (xx, xx-XX, xxx-XX, vb.)
Not: bu parametreyi belirtmezseniz bazı web siteleri erişimi reddedebilir; bu durumda sayfalar yanıt dizisinde"type":"brokendeğeriyle döndürülür - allowTür: boolean | null
_subdomains alt alan adlarındaki sayfaları dahil et
isteğe bağlı alan
hedef web sitesinin tüm alt alan adlarını taramak istiyorsanıztrueolarak ayarlayın
varsayılan değer:false - allowedTür: array string[] | null
_subdomains taranacak alt alan adları
isteğe bağlı alan
taramak istediğiniz alt alan adlarını belirtin
örnek:["blog.site.com", "my.site.com", "shop.site.com"]
Not: bu parametreyi kullanmak içinallow_subdomainsparametresifalseolarak ayarlanmalıdır;
aksi haldeallowed_subdomainsalanının içeriği yok sayılır ve sonuçlar tüm alt alan adları için döndürülür - browserTür: string | null
_preset tarayıcı ekran parametreleri için ön ayar
isteğe bağlı alan
bu alanı kullanırsanızbrowser_screen_width,browser_screen_height,browser_screen_scale_factordeğerlerini belirtmeniz gerekmezolası değerler:desktop,mobile,tabletdesktopön ayarı şu değerleri uygular:browser_screen_width: 1920browser_screen_height: 1080browser_screen_scale_factor: 1mobileön ayarı şu değerleri uygular:browser_screen_width: 390browser_screen_height: 844browser_screen_scale_factor: 3tabletön ayarı şu değerleri uygular:browser_screen_width: 1024browser_screen_height: 1366browser_screen_scale_factor: 2
Not: bu parametreyi kullanmak içinenable_javascriptveyaenable_browser_renderingdeğerinitrueolarak ayarlayın - browserTür: integer | null
_screen _height tarayıcı ekran yüksekliği
isteğe bağlı alan
belirli bir cihaz için denetim gerçekleştirmek üzere özel bir tarayıcı ekran yüksekliği ayarlayabilirsiniz;
bu alanı kullanırsanız yok sayılacağındanbrowser_presetbelirtmeniz gerekmez;
Not: bu parametreyi kullanmak içinenable_javascriptveyaenable_browser_renderingdeğerinitrueolarak ayarlayınpiksel cinsinden minimum değer:240
piksel cinsinden maksimum değer:9999 - browserTür: number | null
_screen _scale _factor tarayıcı ekran ölçek faktörü
isteğe bağlı alan
belirli bir cihaz için denetim gerçekleştirmek üzere özel bir tarayıcı ekran çözünürlük oranı ayarlayabilirsiniz;
bu alanı kullanırsanız yok sayılacağındanbrowser_presetbelirtmeniz gerekmez;
Not: bu parametreyi kullanmak içinenable_javascriptveyaenable_browser_renderingdeğerinitrueolarak ayarlayınminimum değer:0.5
maksimum değer:3 - 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 denetim gerçekleştirmek üzere özel bir tarayıcı ekran genişliği ayarlayabilirsiniz;
bu alanı kullanırsanız yok sayılacağındanbrowser_presetbelirtmeniz gerekmez;
Not: bu parametreyi kullanmak içinenable_javascriptveyaenable_browser_renderingdeğerinitrueolarak ayarlayınpiksel cinsinden minimum değer:240
piksel cinsinden maksimum değer:9999 - calculateTür: boolean | null
_keyword _density hedef alan adı için anahtar kelime yoğunluğunu hesapla
isteğe bağlı alan
web sitesi sayfaları için anahtar kelime yoğunluğunu hesaplamak istiyorsanıztrueolarak ayarlayın
varsayılan değer:false
Not: bu parametreyi kullanırsanız ek ücretler uygulanır; bu parametreyle çalıştırılan görevlerin maliyeti hakkında daha fazla bilgiyi yardım makalemizde bulabilirsiniz
tarama tamamlandıktan sonra anahtar kelime yoğunluğu değerlerini Keyword Density uç noktası ile alabilirsiniz - checkTür: boolean | null
_spell - checkTür: array string[] | null
_spell _exceptions yazım denetiminden hariç tutulan sözcükler
isteğe bağlı alan
yazım denetiminden hariç tutmak istediğiniz sözcükleri belirtin
maksimum sözcük uzunluğu: 100 karakter
maksimum sözcük sayısı: 1000
örnek:"SERP", "minifiers", "JavaScript" - checkTür: string | null
_spell _language yazım denetimi dili
isteğe bağlı alan
desteklenen diller: 'hy', 'eu', 'bg', 'ca', 'hr', 'cs', 'da', 'nl', 'en', 'eo', 'et', 'fo', 'fa', 'fr', 'fy', 'gl', 'ka', 'de', 'el', 'he', 'hu', 'is', 'ia', 'ga', 'it', 'rw', 'la', 'lv', 'lt', 'mk', 'mn', 'ne', 'nb', 'nn', 'pl', 'pt', 'ro', 'gd', 'sr', 'sk', 'sl', 'es', 'sv', 'tr', 'tk', 'uk', 'vi'
Not: dil belirtilmezse sayfa içeriğine göre otomatik olarak ayarlanır - checksTür: object | null
_threshold denetimler için özel eşik değerleri
isteğe bağlı alan
OnPage API yanıtlarınınchecksnesnesinde yer alan parametreler için özel eşik değerleri belirleyebilirsiniz;
Not: yalnızca tam sayı eşik değerleri değiştirilebilir;
örneğinhigh_loading_timevelarge_page_sizeparametreleri varsayılan olarak sırasıyla 3 saniye ve 1 megabayt olarak ayarlanmıştır;
bu eşikleri 1 saniye ve 1000 kB olarak değiştirmek istiyorsanız aşağıdaki kod parçacığını kullanın:"checks_threshold": {<br>"high_loading_time": 1,<br>"large_page_size": 1000<br>}
varsayılan değerleriyle özelleştirilebilir kullanılabilir parametreler:"title_too_short", default value: 30, type: "int"<br>"title_too_long", default value: 65, type: "int"<br>"small_page_size", default value: 1024, type: "int"<br>"large_page_size", default value: 1048576 (1024 * 1024), type: "int"<br>"low_character_count", default value: 1024, type: "int"<br>"high_character_count", default value: 256000 (250 * 1024), type: "int"<br>"low_content_rate", default value: 0.1, type: "float"<br>"high_content_rate", default value: 0.9, type: "float"<br>"high_loading_time", default value: 3000, type: "int"<br>"high_waiting_time", default value: 1500, type: "int"<br>"low_readability_rate", default value: 15.0, type: "float"<br>"irrelevant_description", default value: 0.2, type: "float"<br>"irrelevant_title", default value: 0.3, type: "float"<br>"irrelevant_meta_keywords", default value: 0.6, type: "float"- propertyTür: integer | null Biçim: int64
Name Signed 64-bit integers (long type).
- crawlTür: integer | null
_delay istekler arasındaki gecikme, ms
isteğe bağlı alan
crawler'ın sunucuya gönderdiği istekler arasındaki özel gecikme
varsayılan değer:2000 - crawlTür: boolean | null
_sitemap _only yalnızca sitemap'te belirtilen sayfaları tara
isteğe bağlı alan
yalnızca sitemap'te belirtilen sayfaları taramak istiyorsanıztrueolarak ayarlayın
bu parametreyitrueolarak ayarlar vecustom_sitemapbelirtmezseniz varsayılan sitemap'i tararız
varsayılan değer:false
Not: bu parametreyi kullanmak istiyorsanızrespect_sitemapdeğeritrueolmalıdır - customTür: string | null
_js özel javascript
isteğe bağlı alan
Not: buraya girdiğiniz betiğin yürütme süresi en fazla 700 ms olmalıdır. Örneğin, sitenin Google Tag Manager'ı birscrözniteliği olarak içerip içermediğini kontrol etmek için aşağıdaki JS parçacığını kullanabilirsiniz:let meta = { haveGoogleAnalytics: false, haveTagManager: false };rnfor (var i = 0; i < document.scripts.length; i++) {rn let src = document.scripts[i].getAttribute("src");rn if (src != undefined) {rn if (src.indexOf("analytics.js") >= 0)rn meta.haveGoogleAnalytics = true;rntif (src.indexOf("gtm.js") >= 0)rn meta.haveTagManager = true;rn }rn}rnmeta;döndürülen değer bu alana belirttiğiniz şeye bağlıdır. Örneğin, aşağıdaki betiği belirtirseniz:meta = {}; meta.url = document.URL; meta.test = 'test'; meta;
yanıt olarak aşağıdaki verileri alırsınız:"custom_js_response": {<br>"url": "https://dataforseo.com/",<br>"test": "test"<br>}
Not: girdiğiniz betiğin uzunluğu 2000 karakteri aşmamalıdır - customTür: string | null
_robots _txt özel robots.txt ayarları
isteğe bağlı alan
örnek:Disallow: /directory1/ - customTür: string | null
_sitemap özel sitemap url'si
isteğe bağlı alan
alternatif sitemap'in bulunduğu sayfanın URL'si
Not: bu parametreyi kullanmak istiyorsanızrespect_sitemapdeğeritrueolmalıdır - customTür: string | null
_user _agent özel user agent
isteğe bağlı alan
bir web sitesini taramak için özel user agent
örnek:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36
varsayılan değer:Mozilla/5.0 (compatible; RSiteAuditor) - disableTür: boolean | null
_cookie _popup çerez açılır penceresini devre dışı bırak
isteğe bağlı alan
kullanıcıdan çerez onayı isteyen açılır pencereyi devre dışı bırakmak istiyorsanıztrueolarak ayarlayın;
varsayılan değer:false - disableTür: array string[] | null
_page _checks belirli sayfa kontrollerinin çalışmasını engelle
isteğe bağlı alan
belirlichecksdeğerlerini belirterek bunların çalışmasını veonpage_scoredeğerini etkilemesini engelleyin; örnek:"disable_page_checks": ["is_5xx_code", "is_4xx_code"] - disableTür: array string[] | null
_sitewide _checks belirli site geneli kontrollerin çalışmasını engelle
isteğe bağlı alan
aşağıdakichecksdeğerlerini belirterek bunlarıntargetsitesinde çalışmasını engelleyin:"test_page_not_found""test_canonicalization""test_https_redirect""test_directory_browsing"örnek:"disable_sitewide_checks": ["test_directory_browsing", "test_page_not_found"]daha fazla bilgi için yardım merkezimize bakın - disallowedTür: array string[] | null
_subdomains taranmayacak alt alan adları
isteğe bağlı alan
taramak istemediğiniz alt alan adlarını belirtin
örnek:["status.site.com", "docs.site.com"]
Not: bu parametreyi kullanmak içinallow_subdomainsparametresitrueolarak ayarlanmalıdır - enableTür: boolean | null
_browser _rendering Core Web Vitals ölçmek için tarayıcı oluşturmayı taklit et
isteğe bağlı alan
bu parametreyi kullanarak bir web sayfası yüklenirken tarayıcıyı taklit edebilirsiniz;enable_browser_renderingsayfadaki stilleri, görselleri, yazı tiplerini, animasyonları, videoları ve diğer kaynakları yükler;
varsayılan değer:false
yanıtta Core Web Vitals (FID, CLS, LCP) metriklerini almak içintrueolarak ayarlayın;
bu alanı kullanırsanızenable_javascriptveload_resourcesparametreleritrueolarak ayarlanmalıdır
Not: bu parametreyi kullanırsanız ek ücret uygulanır; bu parametreyle çalıştırılan görevlerin maliyeti hakkında daha fazla bilgi için yardım makalemize bakın; maliyet Fiyatlandırma sayfasında hesaplanabilir - enableTür: boolean | null
_content _parsing - enableTür: boolean | null
_javascript sayfada javascript yükle
isteğe bağlı alan
sayfada bulunan betikleri yüklemek istiyorsanıztrueolarak ayarlayın
varsayılan değer:false
Not: bu parametreyi kullanırsanız ek ücret uygulanır; bu parametreyle çalıştırılan görevlerin maliyeti hakkında daha fazla bilgi için yardım makalemize bakın; maliyet Fiyatlandırma sayfasında hesaplanabilir - enableTür: boolean | null
_www _redirect _check alan adının www yönlendirmesini uygulayıp uygulamadığını kontrol et
isteğe bağlı alan
istenen alan adının www'den www olmayana veya www olmayandan www'ye yönlendirmeyi uygulayıp uygulamadığını kontrol etmek istiyorsanıztrueolarak ayarlayın;
varsayılan değer:false - enableTür: boolean | null
_xhr sayfada XMLHttpRequest'i etkinleştir
isteğe bağlı alan
crawler'ımızın XMLHttpRequest nesnesini kullanarak bir web sunucusundan veri istemesini istiyorsanıztrueolarak ayarlayın
varsayılan değer:false; bu alanı kullanırsanızenable_javascripttrueolarak ayarlanmalıdır; - forceTür: boolean | null
_sitewide _checks tek sayfa taranırken site geneli kontrolleri etkinleştir
isteğe bağlı alan
tek bir sayfa taranırken site geneli kontrollerin verilerini almak içintrueolarak ayarlayın;
varsayılan değer:false - loadTür: boolean | null
_resources kaynakları yükle
isteğe bağlı alan
görselleri, stil sayfalarını, betikleri ve bozuk kaynakları yüklemek istiyorsanıztrueolarak ayarlayın
varsayılan değer:false
Not: bu parametreyi kullanırsanız ek ücret uygulanır; bu parametreyle çalıştırılan görevlerin maliyeti hakkında daha fazla bilgi için yardım makalemize bakın; maliyet Fiyatlandırma sayfasında hesaplanabilir - maxTür: integer | null
_crawl _depth tarama derinliği
isteğe bağlı alan
taranacak sayfaların bağlantı derinliği;
örneğin taramanın başlangıç sayfası 0. düzeydir, o sayfadan bağlantı verilen sayfalar 1. düzeydir vb. - maxTür: integer
_crawl _pages taranan sayfa limiti
zorunlu alan
belirtilen alan adında taranacak sayfa sayısı
Not:max_crawl_pagesdeğerini 1 olarak ayarlar vestart_urlbelirtmezseniz veya buna bir ana sayfa girerseniz aşağıdaki site geneli kontroller devre dışı bırakılır:test_canonicalization,enable_www_redirect_check,test_hidden_server_signature,test_page_not_found,test_directory_browsing,test_https_redirect
yine de etkinleştirmek içinforce_sitewide_checksdeğerinitrueolarak ayarlayın.max_crawl_pagesdeğerini 1 olarak ayarlar ve ana sayfa dışında birstart_urlbelirtirseniz tüm site geneli kontroller devre dışı bırakılır;
yine de etkinleştirmek içinforce_sitewide_checksdeğerinitrueolarak ayarlayın - pingbackTür: string | null
_url tamamlanan görevin bildirim URL'si
isteğe bağlı alan
görev tamamlandığında belirttiğiniz URL'ye gönderilen GET isteğiyle sizi bilgilendireceğiz
‘$id’ dizesini$iddeğişkeni, ‘$tag’ dizesini ise URL kodlu$tagdeğişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız.
örnek:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Not:pingback_urliçindeki özel karakterler URL kodlanır;
yani,#karakteri%23olarak kodlanır - priorityTür: array string[] | null
_urls kuyruğu atlayarak taranacak URL'ler
isteğe bağlı alan
bu dizide belirtilen URL'ler tarama kuyruğu atlanarak ilk sırada taranır;
Not: mutlak URL belirtmelisiniz;
en fazla 20 URL belirtebilirsiniz;
dizideki tüm URL'lertargetalan adına ait olmalıdır;allow_subdomainsparametresitrueolarak ayarlanmadıkça alt alan adları yok sayılır; örnek:"priority_urls": [<br>"https://dataforseo.com/apis/serp-api",<br>"https://dataforseo.com/contact"<br>] - respectTür: boolean | null
_sitemap tarama sırasında sitemap'e uy
isteğe bağlı alan
tarama sırasında birincil sitemap'te belirtilen sayfa sırasını izlemek istiyorsanıztrueolarak ayarlayın;
varsayılan değer:false
Not:trueolarak ayarlanırsa API yanıtındakiclick_depthdeğeri0olur;
isteğinmax_crawl_depthalanı yok sayılır; taranacak sayfa sayısınımax_crawl_pagesparametresiyle belirtebilirsiniz - returnTür: boolean | null
_despite _timeout zaman aşımı hatasına rağmen sayfaların verilerini döndür
isteğe bağlı alantrueise 120 saniye içinde yüklenemeyen ve zaman aşımı hatası döndüren sayfalar için veriler sağlanır;
varsayılan değer:false - robotsTür: string | null
_txt _merge _mode robots.txt ayarlarıyla birleştir veya ayarların üzerine yaz
isteğe bağlı alan
olası değerler:merge,override;
site tarama kısıtlamalarını ve diğer robots.txt ayarlarını yok saymak istiyorsanızoverrideolarak ayarlayın
varsayılan değer:merge;
Not:overrideolarak ayarlanırsacustom_robots_txtparametresini belirtin - startTür: string | null
_url - storeTür: boolean | null
_raw _html - supportTür: boolean | null
_cookies taranan sayfalarda çerezleri destekle
isteğe bağlı alan
sayfaları tararken çerezleri desteklemek içintrueolarak ayarlayın
varsayılan değer:false - switchTür: boolean | null
_pool proxy havuzunu değiştir
isteğe bağlı alantrueise istenen verileri almak için ek proxy havuzları kullanılır;
parametre, aynı anda çok sayıda görev ayarlandığında ve buna bağlı olarak ara sırarate-limitve/veyasite_unreachablehataları oluştuğunda kullanılabilir - 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 - targetTür: string
hedef alan adı
zorunlu alan
alan adıhttps://vewww.olmadan belirtilmelidir
sayfa URL'sini belirtirseniz sonuçlar URL'de yer alan alan adı için döndürülür - validateTür: boolean | null
_micromarkup
- Tür: object | null · Response36Afe1097B20_OnPageTaskPostResponseInfo200
- 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_OnPageTaskPostTaskInfo
- 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: object | null
sonuç dizisi
bu durumda değernullolur - 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/on_page/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "dataforseo.com",
"max_crawl_pages": 10,
"load_resources": true,
"enable_javascript": true,
"custom_js": "meta = {}; meta.url = document.URL; meta;",
"tag": "some_string_123",
"pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
}
]'
{
"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": null
}
]
}