DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
OnPage API Kaynakları
Bir taramanın bulduğu sayfa dışı varlıklar — görseller, betikler, stil sayfaları — durum kodları ve boyutlarıyla. search_after_token ile sayfalanır. Tamamlanmış bir taramayı okur; bu yüzden post_dataforseo_on_page_submit tarafından döndürülen id değerine ihtiyaç duyar ve crawl_progress ile birlikte max_crawl_pages, pages_in_queue ve pages_crawled değerlerini içeren bir crawl_status döndürür — küçük bir sonuca güvenmeden önce bunları kontrol edin, çünkü hâlâ süren bir taramanın raporlayacak daha az şeyi vardır. Tarayıcının hiç ulaşamadığı varlıklar için post_dataforseo_on_page_uncrawlable_resources kullanın. 💰 Upstream tarafında ücretsizdir: tamamlanmış bir taramayı sorgulamak hiçbir şeye mal olmaz, yalnızca taramanın kendisi ücretlidir.
Fiyatlandırma referansı
- Ölçümlendirme: bildirilen yanıt maliyeti.
- Referans istek tahmini: USD 0.012.
- 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çları 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,like,not_like
sıfır veya daha fazla karakterden oluşan herhangi bir dizeyle eşleşmek için%operatörünülikevenot_likeile kullanabilirsiniz
örnek:["resource_type","=","stylesheet"][["resource_type","=","image"],
"and",["checks.is_https","=",false]][["fetch_timing.duration_time",">",1],"and",[["total_transfer_size",">",100],"or",["checks.high_loading_time","=",true]]]Olası filtrelerin tam listesine bu bağlantıdan ulaşabilirsiniz.
Boş nesne - idTür: string
- limitTür: integer | null
döndürülen maksimum kaynak sayısı
isteğe bağlı alan
varsayılan değer:100
maksimum değer:1000 - offsetTür: integer | null
döndürülen kaynakların sonuç dizisindeki ofset
isteğe bağlı alan
varsayılan değer:0
maksimum değer:200000010değerini belirtirseniz sonuç dizisindeki ilk on kaynak atlanır ve veriler sonraki kaynaklar için sağlanır - 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:["size,desc"]
tek bir istekte en fazla üç sıralama kuralı ayarlayabileceğinizi unutmayın
birden fazla sıralama kuralını ayırmak için virgül kullanmalısınız
örnek:["size,desc","fetch_timing.fetch_end,desc"] - relevantTür: array string[] | null
_pages _filters kaynakları ilgili sayfalara göre filtrele
isteğe bağlı alan
bu alanı, tanımlanan parametrelerle eşleşen sayfalardan kaynak almak için kullanabilirsiniz
burada pages uç noktası için kullanılabilen filtrelerin aynısını uygulayabilirsiniz
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,like,not_like
sıfır veya daha fazla karakterden oluşan herhangi bir dizeyle eşleşmek için%operatörünülikevenot_likeile kullanabilirsiniz
örnek:["checks.no_image_title","=",true] - searchTür: string | null
_after _token sonraki istekler için token
isteğe bağlı alan
her isteğe verilen yanıtın aynı alanında sağlanır;
tek bir istekte20,000üzerinde sonuç almaya çalışırken zaman aşımından kaçınmak için bu parametreyi kullanın;
yanıt dizisindeki benzersizsearch_after_tokendeğerini belirterek başlangıç görevinin sonraki sonuçlarını alırsınız;search_after_tokendeğerleri her sonraki görev için benzersizdir;
Not: istektesearch_after_tokenbelirtilirse diğer tüm parametreler önceki istekle aynı olmalıdır - 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 - urlTür: string | null
sayfa URL'si
isteğe bağlı alan
belirli bir sayfanın kaynaklarını almak istiyorsanız bu alanı belirtin
belirli bir URL'den kaynağınmetaverilerini almak için URL'yi bu alanda belirtmeniz gerektiğini unutmayın;
görev ayarlanırken birurlbelirtmezseniz sonuçlardaki kaynağınmetaverileri, tarama botumuzun kaynağı ilk gördüğü sayfadan gelen verilere göre döndürülür
- Tür: object | null · Response36Afe1097B20_OnPageResourcesResponseInfo200
- 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_OnPageResourcesTaskInfo
- 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
- crawlTür: string | null
_progress tarama oturumunun durumu
olası değerler:in_progress,finished - crawlTür: object | null · Response36Afe1097B20_CrawlStatusInfo
_status tarama oturumunun ayrıntıları
- maxTür: integer | null Biçim: int64
_crawl _pages taranacak maksimum sayfa sayısı bir görev ayarlarken belirttiğiniz max_crawl_pages sınırını gösterir
- pagesTür: integer | null Biçim: int64
_crawled taranan sayfa sayısı
- pagesTür: integer | null Biçim: int64
_in _queue şu anda tarama kuyruğunda bulunan sayfa sayısı
- currentTür: integer | null
_offset Integer numbers.
- itemsTür: array (object | null)[] | null
öğe dizisi
- cacheTür: object | null · Response36Afe1097B20_CacheControl
_control önbelleğe alma talimatları
- cachableTür: boolean | null
sayfanın önbelleğe alınabilir olup olmadığını belirtir
- ttlTür: integer | null
yaşam süresi — tarayıcının bir kaynağı önbelleğe aldığı süre
- checksTür: object | null
site kontrolleri — sayfayla ilgili on-page kontrolleri
- propertyTür: boolean | null
Name
- contentTür: string | null
_encoding kodlama türü
- encodedTür: integer | null
_size kodlama sonrası sayfa boyutu — kodlanmış sayfanın boyutunu bayt cinsinden belirtir
- fetchTür: string | null
_time kaynağın getirildiği tarih ve saat; UTC biçiminde: “yyyy-mm-dd hh-mm-ss +00:00”; örnek: 2019-11-15 12:57:46 +00:00
- lastTür: object | null · Response36Afe1097B20_LastModified
_modified kaynakla ilgili değişikliklere ait verileri içerir; veri yoksa değer null olur
- headerTür: string | null
başlığın son değiştirildiği tarih ve saat. UTC biçiminde: "yyyy-mm-dd hh-mm-ss +00:00". Örnek: 2019-11-15 12:57:46 +00:00. Veri yoksa değer null olur.
- metaTür: string | null
_tag meta etiketinin son değiştirildiği tarih ve saat. UTC biçiminde: "yyyy-mm-dd hh-mm-ss +00:00". Örnek: 2019-11-15 12:57:46 +00:00. Veri yoksa değer null olur.
- sitemapTür: string | null
site haritasının son değiştirildiği tarih ve saat. UTC biçiminde: "yyyy-mm-dd hh-mm-ss +00:00". Örnek: 2019-11-15 12:57:46 +00:00. Veri yoksa değer null olur.
- locationTür: string | null
konum başlığı — sayfanın yönlendirileceği URL'yi belirtir
- mediaTür: string | null
_type sayfayı görüntülemek için kullanılan medya türleri
- resourceTür: object | null · Response36Afe1097B20_OnPageResourceIssueInfo
_errors kaynak hataları ve uyarıları
- errorsTür: array (object | null)[] | null
kaynak hataları
- columnTür: integer | null
hatanın bulunduğu sütun
- lineTür: integer | null
hatanın bulunduğu satır
- messageTür: string | null
hatayı açıklayan metin mesajı; olası HTML hatalarının tam listesini burada bulabilirsiniz
- statusTür: integer | null
_code genel durum kodu. Yanıt kodlarının tam listesini burada bulabilirsiniz. Not: ilgili istisnai veya hata koşullarını işlemek için gerekli bir sistem tasarlamanızı kesinlikle öneririz
- warningsTür: array (object | null)[] | null
kaynak uyarıları
- columnTür: integer | null
hatanın bulunduğu sütun
- lineTür: integer | null
hatanın bulunduğu satır
- messageTür: string | null
hatayı açıklayan metin mesajı; olası HTML hatalarının tam listesini burada bulabilirsiniz
- statusTür: integer | null
_code genel durum kodu. Yanıt kodlarının tam listesini burada bulabilirsiniz. Not: ilgili istisnai veya hata koşullarını işlemek için gerekli bir sistem tasarlamanızı kesinlikle öneririz
- resourceTür: string | null
_type öğe türü
- serverTür: string | null
sunucu sürümü
- sizeTür: integer | null
kaynak boyutu — belirli bir sayfanın boyutunu bayt cinsinden belirtir
- statusTür: integer | null
_code genel durum kodu. Yanıt kodlarının tam listesini burada bulabilirsiniz. Not: ilgili istisnai veya hata koşullarını işlemek için gerekli bir sistem tasarlamanızı kesinlikle öneririz
- totalTür: integer | null Biçim: int64
_transfer _size sıkıştırılmış sayfa boyutu — belirli bir sayfanın sıkıştırılmış boyutunu belirtir
- urlTür: string | null
sayfa URL'si
- itemsTür: integer | null Biçim: int64
_count sonuç dizisindeki öğe sayısı
- searchTür: string | null
_after _token - totalTür: integer | null Biçim: int64
_items _count taranan ilgili öğelerin toplam 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/on_page/resources \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "07281559-0695-0216-0000-c269be8b7592",
"filters": [
[
"resource_type",
"=",
"image"
],
"and",
[
"size",
">",
100000
]
],
"order_by": [
"size,desc"
],
"limit": 10
}
]'
{
"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": [
{
"crawl_progress": null,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"search_after_token": null,
"current_offset": null,
"total_items_count": null,
"items_count": null,
"items": [
{
"resource_type": null,
"status_code": null,
"location": null,
"url": null,
"resource_errors": "[Max Depth Exceeded]",
"size": null,
"encoded_size": null,
"total_transfer_size": null,
"fetch_time": null,
"cache_control": "[Max Depth Exceeded]",
"checks": null,
"content_encoding": null,
"media_type": null,
"server": null,
"last_modified": "[Max Depth Exceeded]"
}
]
}
]
}
]
}