Felo API PlatformFelo API Platform
Tüm DataForSEO endpoint'leri
v0.2.0-beta
OpenAPI 3.1.0

OnPage API Sayfa Ekran Görüntüsü

Felo API Support
MIT
Sunucu:https://openapi.felo.ai
İstemci Kitaplıkları
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO İşlemler

OnPage API Sayfa Ekran Görüntüsü

​

Herhangi bir url oluşturur ve ekran görüntüsü döndürür; full_page_screenshot tüm kaydırma yüksekliğini kapsar, browser_screen_width ve browser_screen_height ise görünüm alanını ayarlar. Bağımsızdır — tarama gerekmez. 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. ⚠️ Bir görsel, ajan onunla bir şey yapmadan önce bile büyük bir araç sonucudur; ekran görüntüsünü yalnızca görsel önemliyse isteyin, metin önemliyse post_dataforseo_on_page_content_parsing_live kullanın.

Fiyatlandırma referansı

  • Ölçümlendirme: bildirilen yanıt maliyeti.
  • Referans istek tahmini: USD 0.0051.
  • 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.

Gövde
application/json
  • Tür: array (object | null)[]
    • accept_language
      Tür: string | null

      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 yanıt dizisinde "error_message":"Screenshot is empty" alırsınız

    • browser_preset
      Tür: string | null

      tarayıcı ekran parametreleri için ön ayar
      isteğe bağlı alan
      bu alanı kullanırsanız browser_screen_width, browser_screen_height, browser_screen_scale_factor değerlerini belirtmeniz gerekmez

      olası değerler:
      desktop, mobile, tablet

      desktop ön ayarı şu değerleri uygular:

      browser_screen_width: 1920
      browser_screen_height: 1080
      browser_screen_scale_factor: 1

      mobile ön ayarı şu değerleri uygular:

      browser_screen_width: 390
      browser_screen_height: 844
      browser_screen_scale_factor: 3

      tablet ön ayarı şu değerleri uygular:

      browser_screen_width: 1024
      browser_screen_height: 1366
      browser_screen_scale_factor: 2

      Not: bu uç noktada enable_browser_rendering, enable_javascript, load_resources ve enable_xhr parametreleri her zaman etkindir.

    • browser_screen_height
      Tür: integer | null

      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ğından browser_preset belirtmeniz gerekmez;

      piksel cinsinden minimum değer: 240
      piksel cinsinden maksimum değer: 9999

    • browser_screen_scale_factor
      Tür: number | null

      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ğından browser_preset belirtmeniz gerekmez;

      minimum değer: 0.5
      maksimum değer: 3

    • browser_screen_width
      Tür: integer | null Biçim: int64

      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ğından browser_preset belirtmeniz gerekmez;

      piksel cinsinden minimum değer: 240
      piksel cinsinden maksimum değer: 9999

    • custom_user_agent
      Tür: string | null

      ö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)

    • disable_cookie_popup
      Tür: boolean | null

      ç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ız true olarak ayarlayın;
      varsayılan değer:
      false

    • full_page_screenshot
      Tür: boolean | null

      sayfanın tamamının ekran görüntüsünü al
      isteğe bağlı alan
      yalnızca kaydırmadan önce görüntülenen sayfa bölümünü yakalamak istiyorsanız false olarak ayarlayın
      varsayılan değer: true

    • ip_pool_for_scan
      Tür: string | null

      proxy havuzu
      isteğe bağlı alan
      istenen verileri almak için kullanılacak proxy havuzunun konumunu seçebilirsiniz;
      parametre, sayfa içeriğine konumlardan birinde erişilemediğinde ve buna bağlı olarak ara sıra site_unreachable hataları oluştuğunda kullanılabilir
      olası değerler: us, de

    • switch_pool
      Tür: boolean | null

      proxy havuzunu değiştir
      isteğe bağlı alan
      true ise 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ıra rate-limit ve/veya site_unreachable hataları oluştuğunda kullanılabilir

    • url
      Tür: string

      sayfa url'si
      zorunlu alan
      ekran görüntüsü alınacak sayfanın mutlak URL'si
      not: burada belirttiğiniz URL 404 durum kodu döndürürse veya belirtilen değer geçerli bir URL değilse yanıt dizisinde "error_message":"Screenshot is empty" alırsınız

Yanıtlar
  • 200
    Tür: object | null · Response36Afe1097B20_OnPagePageScreenshotResponseInfo
    • cost
      Tür: number | null Biçim: double

      toplam görev maliyeti, USD

    • status_code
      Tür: integer | null

      genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz

    • status_message
      Tür: string | null

      genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

    • tasks
      Tür: array (object | null)[] | null

      görev dizisi

      • Tür: object | null · Response36Afe1097B20_OnPagePageScreenshotTaskInfo
        • cost
          Tür: number | null Biçim: double

          toplam görev maliyeti, USD

        • data
          Tür: object | null

          POST isteğinde belirttiğiniz parametrelerin aynısını içerir

          • propertyName
            Tür: object | null
        • id
          Tür: string | null

          görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı

        • path
          Tür: array (string | null)[] | null

          URL yolu

        • result
          Tür: array (object | null)[] | null

          sonuç dizisi

          • crawl_progress
            Tür: string | null

            tarama oturumunun durumu
            olası değerler: in_progress, finished

          • error_message
            Tür: string | null

            hata mesajı
            belirttiğiniz url 404 durum kodu döndürürse veya geçerli bir URL değilse "error_message":"Screenshot is empty" alırsınız
            hata oluşmazsa değer null olur

          • items
            Tür: array (object | null)[] | null

            öğe dizisi

            • image
              Tür: string | null

              istenen sayfanın ekran görüntüsü
              sayfa ekran görüntüsünün DataForSEO depolamasındaki URL'si
              not: DataForSEO depolamasına kaydedilen sayfa ekran görüntüsü, istek yapıldıktan sonra yalnızca bir gün boyunca erişilebilir kalır

          • items_count
            Tür: integer | null Biçim: int64

            sonuç dizisindeki öğe sayısı

        • result_count
          Tür: integer | null Biçim: int64

          result dizisindeki öğe sayısı

        • status_code
          Tür: integer | null

          görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz

        • status_message
          Tür: string | null

          görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

        • time
          Tür: string | null

          yürütme süresi, saniye

    • tasks_count
      Tür: integer | null Biçim: int64

      tasks dizisindeki görev sayısı

    • tasks_error
      Tür: integer | null Biçim: int64

      tasks dizisinde hata ile dönen görev sayısı

    • time
      Tür: string | null

      toplam yürütme süresi, saniye

    • version
      Tür: string | null

      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
Request Example for post/v1/beta/dataforseo/on_page/page_screenshot
curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/page_screenshot \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "url": "https://dataforseo.com/apis"
  }
]'

{
  "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,
          "error_message": null,
          "items_count": null,
          "items": [
            {
              "image": null
            }
          ]
        }
      ]
    }
  ]
}

Başarılı işlem

OnPage API Page Screenshot