Skip to main content
POST
SERP API 页面截图
使用 Live Page Screenshot 端点,可以捕获任意 SERP 页面的截图。该截图通过渲染搜索引擎页面的 HTML 生成。每次请求都会从你的账户扣费。

示例

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
task_id
string
必填

关联任务的唯一标识符,采用 UUID 格式;可在 7 天内使用

browser_preset
string

浏览器分辨率预设:desktop、tablet 或 mobile

browser_screen_width
integer

浏览器分辨率宽度;范围为 240-9999

browser_screen_height
integer

浏览器分辨率高度;范围为 240-9999

browser_screen_scale_factor
number

浏览器缩放系数;范围为 0.5-3

page
integer

要截图的 SERP 页码;默认为 1

响应

成功响应

version
string

API 的当前版本

status_code
integer

通用状态码

status_message
string

一般信息消息

time
string

执行时间(秒)

cost
number

任务总成本(美元)

tasks
string[]

任务数组

tasks[].id
string

UUID 格式的任务标识符

tasks[].status_code
integer

任务状态码

tasks[].status_message
string

任务状态消息

tasks[].result_count
integer

结果数组中的元素数量

tasks[].path
string[]

URL 路径

tasks[].data
object

包含 POST 请求中指定的相同参数

tasks[].result
string[]

结果数组

tasks[].result[].items_count
integer

结果数组中的项目数量

tasks[].result[].items
string[]

项目数组

tasks[].result[].items[].image
string

DataForSEO 存储中页面截图的 URL