Felo API PlatformFelo API Platform
Semua endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Tangkapan Layar Halaman OnPage API

Felo API Support
MIT
Server:https://openapi.felo.ai
Pustaka Klien
Shell Curl

DataForSEO

​

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

DataForSEO Operasi

Tangkapan Layar Halaman OnPage API

​

Merender url apa pun dan mengembalikan tangkapan layar, dengan full_page_screenshot untuk seluruh tinggi gulir serta browser_screen_width dan browser_screen_height menyetel viewport. Mandiri - tidak perlu crawl. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. ⚠️ Gambar adalah hasil alat yang besar bahkan sebelum agent dapat melakukan apa pun dengannya; minta tangkapan layar hanya ketika visual adalah intinya, dan gunakan post_dataforseo_on_page_content_parsing_live ketika teksnya yang menjadi inti.

Referensi harga

  • Metering: Biaya respons yang dilaporkan.
  • Estimasi referensi per permintaan: USD 0.0051.
  • Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Isi
application/json
  • Tipe: array (object | null)[]
    • accept_language
      Tipe: string | null

      header bahasa untuk mengakses situs web
      field opsional
      semua format locale didukung (xx, xx-XX, xxx-XX, dll.)
      catatan: jika Anda tidak menentukan parameter ini, beberapa situs web mungkin menolak akses; dalam hal ini, Anda akan memperoleh "error_message":"Screenshot is empty" di array respons

    • browser_preset
      Tipe: string | null

      preset untuk parameter layar browser
      field opsional
      jika Anda menggunakan field ini, Anda tidak perlu menentukan browser_screen_width, browser_screen_height, browser_screen_scale_factor

      nilai yang mungkin:
      desktop, mobile, tablet

      preset desktop akan menerapkan nilai berikut:

      browser_screen_width: 1920
      browser_screen_height: 1080
      browser_screen_scale_factor: 1

      preset mobile akan menerapkan nilai berikut:

      browser_screen_width: 390
      browser_screen_height: 844
      browser_screen_scale_factor: 3

      preset tablet akan menerapkan nilai berikut:

      browser_screen_width: 1024
      browser_screen_height: 1366
      browser_screen_scale_factor: 2

      Catatan: di endpoint ini, parameter enable_browser_rendering, enable_javascript, load_resources, dan enable_xhr selalu diaktifkan.

    • browser_screen_height
      Tipe: integer | null

      tinggi layar browser
      field opsional
      Anda dapat menetapkan tinggi layar browser khusus untuk melakukan audit bagi perangkat tertentu;
      jika Anda menggunakan field ini, Anda tidak perlu menentukan browser_preset karena akan diabaikan;

      nilai minimum, dalam piksel: 240
      nilai maksimum, dalam piksel: 9999

    • browser_screen_scale_factor
      Tipe: number | null

      faktor skala layar browser
      field opsional
      Anda dapat menetapkan rasio resolusi layar browser khusus untuk melakukan audit bagi perangkat tertentu;
      jika Anda menggunakan field ini, Anda tidak perlu menentukan browser_preset karena akan diabaikan;

      nilai minimum: 0.5
      nilai maksimum: 3

    • browser_screen_width
      Tipe: integer | null Format: int64

      lebar layar browser
      field opsional
      Anda dapat menetapkan lebar layar browser khusus untuk melakukan audit bagi perangkat tertentu;
      jika Anda menggunakan field ini, Anda tidak perlu menentukan browser_preset karena akan diabaikan;

      nilai minimum, dalam piksel: 240
      nilai maksimum, dalam piksel: 9999

    • custom_user_agent
      Tipe: string | null

      user agent khusus
      field opsional
      user agent khusus untuk merayapi situs web
      contoh: 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

      nilai default: Mozilla/5.0 (compatible; RSiteAuditor)

    • disable_cookie_popup
      Tipe: boolean | null

      nonaktifkan popup cookie
      field opsional
      setel ke true jika Anda ingin menonaktifkan popup yang meminta persetujuan cookie dari pengguna;
      nilai default:
      false

    • full_page_screenshot
      Tipe: boolean | null

      ambil tangkapan layar seluruh halaman
      field opsional
      setel ke false jika Anda hanya ingin menangkap bagian halaman yang ditampilkan sebelum menggulir
      nilai default: true

    • ip_pool_for_scan
      Tipe: string | null

      kumpulan proxy
      field opsional
      Anda dapat memilih lokasi kumpulan proxy yang akan digunakan untuk memperoleh data yang diminta;
      parameter ini dapat digunakan jika konten halaman tidak dapat diakses di salah satu lokasi, sehingga kadang terjadi error site_unreachable
      nilai yang mungkin: us, de

    • switch_pool
      Tipe: boolean | null

      ganti kumpulan proxy
      field opsional
      jika true, kumpulan proxy tambahan akan digunakan untuk memperoleh data yang diminta;
      parameter ini dapat digunakan jika banyak tugas ditetapkan secara bersamaan, sehingga kadang terjadi error rate-limit dan/atau site_unreachable

    • url
      Tipe: string

      url halaman
      field wajib
      URL absolut halaman yang akan ditangkap
      catatan: jika URL yang Anda tentukan di sini mengembalikan kode status 404 atau nilai yang ditentukan bukan URL yang valid, Anda akan memperoleh "error_message":"Screenshot is empty" di array respons

Respons
  • 200
    Tipe: object | null · Response36Afe1097B20_OnPagePageScreenshotResponseInfo
    • cost
      Tipe: number | null Format: double

      total biaya tugas, USD

    • status_code
      Tipe: integer | null

      kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

    • status_message
      Tipe: string | null

      pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

    • tasks
      Tipe: array (object | null)[] | null

      array tugas

      • Tipe: object | null · Response36Afe1097B20_OnPagePageScreenshotTaskInfo
        • cost
          Tipe: number | null Format: double

          total biaya tugas, USD

        • data
          Tipe: object | null

          berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

          • propertyName
            Tipe: object | null
        • id
          Tipe: string | null

          pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

        • path
          Tipe: array (string | null)[] | null

          Jalur URL

        • result
          Tipe: array (object | null)[] | null

          array hasil

          • crawl_progress
            Tipe: string | null

            status sesi crawl
            nilai yang mungkin: in_progress, finished

          • error_message
            Tipe: string | null

            pesan kesalahan
            jika url yang Anda tentukan mengembalikan kode status 404 atau bukan URL yang valid, Anda akan memperoleh "error_message":"Screenshot is empty"
            jika tidak ada kesalahan, nilainya adalah null

          • items
            Tipe: array (object | null)[] | null

            array items

            • image
              Tipe: string | null

              tangkapan layar halaman yang diminta
              URL tangkapan layar halaman di penyimpanan DataForSEO
              Catatan: tangkapan layar halaman yang disimpan di penyimpanan DataForSEO hanya dapat diakses selama satu hari setelah permintaan dibuat

          • items_count
            Tipe: integer | null Format: int64

            jumlah item dalam array hasil

        • result_count
          Tipe: integer | null Format: int64

          jumlah elemen dalam array hasil

        • status_code
          Tipe: integer | null

          kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

        • status_message
          Tipe: string | null

          pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

        • time
          Tipe: string | null

          waktu eksekusi, detik

    • tasks_count
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks

    • tasks_error
      Tipe: integer | null Format: int64

      jumlah tugas dalam array tasks yang dikembalikan dengan error

    • time
      Tipe: string | null

      total waktu eksekusi, detik

    • version
      Tipe: string | null

      versi API saat ini

    application/json
  • 400

    Permintaan tidak dapat diproses. Periksa parameter permintaan.

  • 401

    Kunci API Felo yang valid diperlukan.

  • 402

    Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

  • 403

    Akun tidak diizinkan melakukan operasi ini.

  • 429

    Batas permintaan atau batas pengeluaran telah tercapai.

  • 502

    Layanan tidak dapat menyelesaikan permintaan.

  • 503

    API atau layanan penagihan untuk sementara tidak tersedia.

  • 504

    Layanan kehabisan waktu saat memproses permintaan.

  • default

    Respons error; respons passthrough upstream dapat menggunakan format penyedia

    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
            }
          ]
        }
      ]
    }
  ]
}

Operasi berhasil

OnPage API Page Screenshot