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

Tangkapan Skrin Halaman OnPage API

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

DataForSEO

​

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

DataForSEO Operasi

Tangkapan Skrin Halaman OnPage API

​

Menghasilkan paparan mana-mana url dan memulangkan tangkapan skrin, dengan full_page_screenshot untuk keseluruhan tinggi tatal serta browser_screen_width dan browser_screen_height menetapkan viewport. Berdiri sendiri - tiada crawl diperlukan. Dibungkus dalam sampul DataForSEO: data dalam tasks[0].result, hasil dalam tasks[0].status_code - permintaan yang ditolak tetap memulangkan HTTP 200. ⚠️ Imej ialah hasil alat yang besar walaupun sebelum agent boleh berbuat apa-apa dengannya; minta tangkapan skrin hanya apabila visual itu tujuannya, dan gunakan post_dataforseo_on_page_content_parsing_live apabila teks itu tujuannya.

Rujukan harga

  • Pemeteran: Kos respons yang dilaporkan.
  • Anggaran rujukan setiap permintaan: USD 0.0051.
  • Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.

Badan
application/json
  • Jenis: array (object | null)[]
    • accept_language
      Jenis: string | null

      header bahasa untuk mengakses laman web
      medan pilihan
      semua format locale disokong (xx, xx-XX, xxx-XX, dsb.)
      nota: jika anda tidak menentukan parameter ini, sesetengah laman web mungkin menolak akses; dalam kes ini, anda akan memperoleh "error_message":"Screenshot is empty" dalam array respons

    • browser_preset
      Jenis: string | null

      preset untuk parameter skrin pelayar
      medan pilihan
      jika anda menggunakan medan ini, anda tidak perlu menentukan browser_screen_width, browser_screen_height, browser_screen_scale_factor

      nilai yang tersedia:
      desktop, mobile, tablet

      preset desktop akan menggunakan nilai berikut:

      browser_screen_width: 1920
      browser_screen_height: 1080
      browser_screen_scale_factor: 1

      preset mobile akan menggunakan nilai berikut:

      browser_screen_width: 390
      browser_screen_height: 844
      browser_screen_scale_factor: 3

      preset tablet akan menggunakan nilai berikut:

      browser_screen_width: 1024
      browser_screen_height: 1366
      browser_screen_scale_factor: 2

      Nota: dalam endpoint ini, parameter enable_browser_rendering, enable_javascript, load_resources dan enable_xhr sentiasa didayakan.

    • browser_screen_height
      Jenis: integer | null

      tinggi skrin pelayar
      medan pilihan
      anda boleh menetapkan tinggi skrin pelayar tersuai untuk melakukan audit bagi peranti tertentu;
      jika anda menggunakan medan ini, anda tidak perlu menentukan browser_preset kerana ia akan diabaikan;

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

    • browser_screen_scale_factor
      Jenis: number | null

      faktor skala skrin pelayar
      medan pilihan
      anda boleh menetapkan nisbah resolusi skrin pelayar tersuai untuk melakukan audit bagi peranti tertentu;
      jika anda menggunakan medan ini, anda tidak perlu menentukan browser_preset kerana ia akan diabaikan;

      nilai minimum: 0.5
      nilai maksimum: 3

    • browser_screen_width
      Jenis: integer | null Format: int64

      lebar skrin pelayar
      medan pilihan
      anda boleh menetapkan lebar skrin pelayar tersuai untuk melakukan audit bagi peranti tertentu;
      jika anda menggunakan medan ini, anda tidak perlu menentukan browser_preset kerana ia akan diabaikan;

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

    • custom_user_agent
      Jenis: string | null

      user agent tersuai
      medan pilihan
      user agent tersuai untuk merangkak laman 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 lalai: Mozilla/5.0 (compatible; RSiteAuditor)

    • disable_cookie_popup
      Jenis: boolean | null

      nyahdayakan popup cookie
      medan pilihan
      tetapkan kepada true jika anda ingin menyahdayakan popup yang meminta persetujuan cookie daripada pengguna;
      nilai lalai:
      false

    • full_page_screenshot
      Jenis: boolean | null

      ambil tangkapan skrin seluruh halaman
      medan pilihan
      tetapkan kepada false jika anda hanya ingin merakam bahagian halaman yang dipaparkan sebelum menatal
      nilai lalai: true

    • ip_pool_for_scan
      Jenis: string | null

      kumpulan proxy
      medan pilihan
      anda boleh memilih lokasi kumpulan proxy yang akan digunakan untuk mendapatkan data yang diminta;
      parameter ini boleh digunakan jika kandungan halaman tidak dapat diakses di salah satu lokasi, menyebabkan ralat site_unreachable sekali-sekala
      nilai yang tersedia: us, de

    • switch_pool
      Jenis: boolean | null

      tukar kumpulan proxy
      medan pilihan
      jika true, kumpulan proxy tambahan akan digunakan untuk mendapatkan data yang diminta;
      parameter ini boleh digunakan jika banyak tugas ditetapkan serentak, menyebabkan ralat rate-limit dan/atau site_unreachable sekali-sekala

    • url
      Jenis: string

      url halaman
      medan wajib
      URL mutlak halaman untuk ditangkap
      nota: jika URL yang anda tentukan di sini memulangkan kod status 404 atau nilai yang ditentukan bukan URL yang sah, anda akan memperoleh "error_message":"Screenshot is empty" dalam array respons

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

      jumlah kos tugas, USD

    • status_code
      Jenis: integer | null

      kod status umum; anda boleh menemui senarai penuh kod respons di sini

    • status_message
      Jenis: string | null

      mesej maklumat umum; anda boleh menemui senarai penuh mesej maklumat umum di sini

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

      tatasusunan tugas

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

          jumlah kos tugas, USD

        • data
          Jenis: object | null

          mengandungi parameter yang sama seperti yang anda tentukan dalam permintaan POST

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

          pengecam tugas; pengecam tugas unik dalam sistem kami dalam format UUID

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

          Laluan URL

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

          tatasusunan hasil

          • crawl_progress
            Jenis: string | null

            status sesi crawl
            nilai yang mungkin: in_progress, finished

          • error_message
            Jenis: string | null

            mesej ralat
            jika url yang anda tentukan memulangkan kod status 404 atau bukan URL yang sah, anda akan memperoleh "error_message":"Screenshot is empty"
            jika tiada ralat, nilainya ialah null

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

            tatasusunan items

            • image
              Jenis: string | null

              tangkapan skrin halaman yang diminta
              URL tangkapan skrin halaman pada storan DataForSEO
              Nota: tangkapan skrin halaman yang disimpan pada storan DataForSEO hanya boleh diakses selama satu hari selepas permintaan dibuat

          • items_count
            Jenis: integer | null Format: int64

            bilangan item dalam tatasusunan hasil

        • result_count
          Jenis: integer | null Format: int64

          bilangan elemen dalam array hasil

        • status_code
          Jenis: integer | null

          kod status tugas yang dijana oleh DataForSEO; boleh berada dalam julat berikut: 10000-60000; anda boleh menemui senarai penuh kod respons di sini

        • status_message
          Jenis: string | null

          mesej maklumat tugas; anda boleh menemui senarai penuh mesej maklumat umum di sini

        • time
          Jenis: string | null

          masa pelaksanaan, saat

    • tasks_count
      Jenis: integer | null Format: int64

      bilangan tugas dalam array tasks

    • tasks_error
      Jenis: integer | null Format: int64

      bilangan tugas dalam array tasks yang dipulangkan dengan ralat

    • time
      Jenis: string | null

      jumlah masa pelaksanaan, saat

    • version
      Jenis: string | null

      versi semasa API

    application/json
  • 400

    Permintaan tidak dapat diproses. Semak parameter permintaan.

  • 401

    Kunci API Felo yang sah diperlukan.

  • 402

    Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.

  • 403

    Akaun tidak dibenarkan melakukan operasi ini.

  • 429

    Had permintaan atau had perbelanjaan telah dicapai.

  • 502

    Perkhidmatan tidak dapat menyelesaikan permintaan.

  • 503

    API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.

  • 504

    Perkhidmatan tamat masa semasa memproses permintaan.

  • default

    Respons ralat; respons passthrough huluan mungkin 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 berjaya

OnPage API Page Screenshot