ภาพหน้าจอหน้าเว็บใน SERP API

Felo API Support

MIT

เซิร์ฟเวอร์

https://openapi.felo.ai

ไลบรารีไคลเอนต์

Shell Curl

DataForSEO

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

DataForSEO การดำเนินการ

post/v1/beta/dataforseo/serp/screenshot

ภาพหน้าจอหน้าเว็บใน SERP API

คืนภาพหน้าจอที่เรนเดอร์แล้วของหน้าผลการค้นหาบน Google คืนค่า keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count และ items ห่อด้วย envelope ของ DataForSEO: ข้อมูลอยู่ใน tasks[0].result ผลลัพธ์อยู่ใน tasks[0].status_code — คำขอที่ถูกปฏิเสธยังคงคืน HTTP 200

ข้อมูลอ้างอิงราคา

การวัดปริมาณการใช้งาน: ต้นทุนการตอบกลับที่รายงาน
ค่าประมาณคำขออ้างอิง: USD 0.02
ตัวคูณอ้างอิงสำหรับลูกค้า: 1.0 ห้ามนำไปใช้ซ้ำกับยอดที่เรียกเก็บจากลูกค้าแล้ว

เป็นข้อมูลเมตาอ้างอิงเท่านั้น ไม่ใช่ใบเสนอราคาสำหรับบัญชี ไม่ใช่ราคาที่รับประกัน และไม่ใช่เพดานการใช้จ่าย เครดิตของทรัพยากรไม่ใช่เครดิต Felo ยอดเรียกเก็บขั้นสุดท้ายเป็นไปตามบันทึกการเรียกเก็บเงินของ Felo

บอดี้

application/json

ประเภท: array (object | null)[]
- browser_preset
  ประเภท: string | null
  
  พรีเซ็ตความละเอียดของเบราว์เซอร์
  ฟิลด์ที่ไม่บังคับ
  พรีเซ็ตเบราว์เซอร์ที่สัมพันธ์กับประเภทอุปกรณ์บางประเภท
  รับค่าต่อไปนี้ได้: desktop, tablet, mobile
  หมายเหตุ: โดยค่าเริ่มต้น พรีเซ็ตเบราว์เซอร์จะสอดคล้องกับประเภทอุปกรณ์ที่ระบุในคำขอ POST
- browser_screen_height
  ประเภท: integer | null
  
  ความสูงของความละเอียดเบราว์เซอร์
  ฟิลด์ที่ไม่บังคับ
  ระบุได้ในช่วงต่อไปนี้: 240-9999
  ค่าเริ่มต้นสำหรับ desktop: 1080
  ค่าเริ่มต้นสำหรับ mobile: 844
  ค่าเริ่มต้นสำหรับ table: 1366
- browser_screen_scale_factor
  ประเภท: number | null
  
  ตัวคูณมาตราส่วนของเบราว์เซอร์
  ฟิลด์ที่ไม่บังคับ
  ระบุได้ในช่วงต่อไปนี้: 0.5-3
  ค่าเริ่มต้นสำหรับ desktop: 1
  ค่าเริ่มต้นสำหรับ mobile: 3
  ค่าเริ่มต้นสำหรับ table: 2
- browser_screen_width
  ประเภท: integer | null รูปแบบ: int64
  
  ความกว้างของความละเอียดเบราว์เซอร์
  ฟิลด์ที่ไม่บังคับ
  ระบุได้ในช่วงต่อไปนี้: 240-9999
  ค่าเริ่มต้นสำหรับ desktop: 1920
  ค่าเริ่มต้นสำหรับ mobile: 390
  ค่าเริ่มต้นสำหรับ table: 1024
- page
  ประเภท: integer | null
  
  จำนวนหน้า SERP
  ฟิลด์ที่ไม่บังคับ
  หาก depth ในคำขอ Task POST ที่เกี่ยวข้องเกิน 10 ผลลัพธ์ (หรือ 1 หน้า SERP) ให้ระบุจำนวนหน้า SERP ที่ต้องการแคปเจอร์;
  ค่าเริ่มต้น: 1
- task_id
  ประเภท: string
  
  ตัวระบุงาน
  ฟิลด์ที่จำเป็น
  ตัวระบุที่ไม่ซ้ำกันของงานที่เกี่ยวข้องในรูปแบบ UUID
  คุณจะสามารถใช้ตัวระบุนี้ภายใน 7 วัน เพื่อขอผลลัพธ์ของงานได้ทุกเมื่อ

การตอบกลับ

200
ประเภท: object | null · Response36Afe1097B20_SerpScreenshotResponseInfo
cost
ประเภท: number | null รูปแบบ: double

ค่าใช้จ่ายรวมของงาน, USD

status_code
ประเภท: integer | null

รหัสสถานะทั่วไป คุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่

status_message
ประเภท: string | null

ข้อความข้อมูลทั่วไป คุณสามารถดูรายการข้อความข้อมูลทั่วไปทั้งหมดได้ที่นี่

tasks
ประเภท: array (object | null)[] | null

อาร์เรย์ของงาน

ประเภท: object | null · Response36Afe1097B20_SerpScreenshotTaskInfo
cost
ประเภท: number | null รูปแบบ: double

ค่าใช้จ่ายรวมของงาน, USD

data
ประเภท: object | null

มีพารามิเตอร์เดียวกับที่คุณระบุในคำขอ POST

propertyName
ประเภท: object | null
id
ประเภท: string | null

ตัวระบุงาน ตัวระบุงานที่ไม่ซ้ำกันในระบบของเราในรูปแบบ UUID

path
ประเภท: array (string | null)[] | null

พาธ URL

result
ประเภท: array (object | null)[] | null

อาร์เรย์ของผลลัพธ์

items
ประเภท: array (object | null)[] | null

อาร์เรย์ items

image
ประเภท: string | null

ภาพแคปเจอร์หน้าจอของหน้าที่ร้องขอ
URL ของภาพแคปเจอร์หน้าจอของหน้าเว็บในที่เก็บข้อมูล DataForSEO
หมายเหตุ: ภาพแคปเจอร์หน้าจอที่บันทึกไว้ในที่เก็บข้อมูล DataForSEO จะเข้าถึงได้เพียงหนึ่งวันหลังส่งคำขอ

items_count
ประเภท: integer | null รูปแบบ: int64

จำนวนรายการในอาร์เรย์ผลลัพธ์

result_count
ประเภท: integer | null รูปแบบ: int64

จำนวนองค์ประกอบในอาร์เรย์ result

status_code
ประเภท: integer | null

รหัสสถานะของงาน สร้างโดย DataForSEO โดยอยู่ในช่วงต่อไปนี้ได้: 10000-60000 คุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่

status_message
ประเภท: string | null

ข้อความข้อมูลของงาน คุณสามารถดูรายการข้อความข้อมูลทั่วไปทั้งหมดได้ที่นี่

time
ประเภท: string | null

เวลาดำเนินการ, วินาที

tasks_count
ประเภท: integer | null รูปแบบ: int64

จำนวนงานในอาร์เรย์ tasks

tasks_error
ประเภท: integer | null รูปแบบ: int64

จำนวนงานในอาร์เรย์ tasks ที่ส่งคืนพร้อมข้อผิดพลาด

time
ประเภท: string | null

เวลาดำเนินการทั้งหมด (วินาที)

version
ประเภท: string | null

เวอร์ชันปัจจุบันของ API
application/json
400

ไม่สามารถประมวลผลคำขอได้ ตรวจสอบพารามิเตอร์ของคำขอ
401

จำเป็นต้องใช้คีย์ API ของ Felo ที่ถูกต้อง
402

ไม่สามารถดำเนินการตามคำขอได้ เนื่องจากไม่เป็นไปตามข้อกำหนดด้านการเรียกเก็บเงิน
403

บัญชีไม่ได้รับอนุญาตให้ดำเนินการนี้
429

ถึงขีดจำกัดคำขอหรือการใช้จ่ายแล้ว
502

บริการไม่สามารถดำเนินการตามคำขอให้เสร็จสิ้นได้
503

API หรือบริการเรียกเก็บเงินไม่พร้อมใช้งานชั่วคราว
504

บริการหมดเวลาระหว่างประมวลผลคำขอ
default

การตอบกลับข้อผิดพลาด; การตอบกลับที่ส่งผ่านจากต้นทางอาจใช้รูปแบบของผู้ให้บริการ

application/json

post/v1/beta/dataforseo/serp/screenshot

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/screenshot \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "task_id": "06211235-0696-0139-1000-36727fbd3c90",
    "browser_screen_scale_factor": 0.5
  }
]'

แสดงสคีมา

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

ดำเนินการสำเร็จ

ภาพหน้าจอหน้าเว็บใน SERP API

การยืนยันตัวตนRequired

DataForSEO

ภาพหน้าจอหน้าเว็บใน SERP API

ข้อมูลอ้างอิงราคา