 |
网页截图-browshot
专用API
【更新时间: 2024.06.12】
browshot提供的网页截图API 轻松制作任何屏幕尺寸的网页屏幕截图，就像任何设备一样：iPhone、iPad、Android、 个人电脑等以多种分辨率在不同设备上截取任何页面的屏幕截图。
|
- API详情
- 定价
- 使用指南
- 关于我们
- 相关推荐
什么是browshot的网页截图?
“browshot-网页截图API” 是一个强大、快速且可靠的服务，允许用户在任何实时网站上截取网页截图。它支持多种设备和分辨率，用户可以通过API调用来获取网页在不同设备上的截图，比如iPhone、iPad、Android和PC等。这个API特别适用于需要自动化和批量生成网页截图的应用场景。
什么是browshot的网页截图？
browshot的网页截图有哪些核心功能？
- 截图/多个：在一次 API 调用中请求多个屏幕截图。
- 截图/搜索：搜索特定 URL 的屏幕截图。
- 屏幕截图/主机：您可以在自己的 S3 账户或 Browshot 上托管屏幕截图和缩略图。
- 截图/缩略图：与其他 API 调用不同，此 API 会以 PNG 文件（而非 JSON）的形式发回缩略图。
- 截图/共享：你可以公开截图，添加注释，并与朋友和同事分享。只有完成的截图才能共享。
- 截图/删除：您可以删除截图的详细信息，以删除任何机密信息。
- 屏幕截图/html：读取渲染页面的 HTML 代码。
- 批量/创建：获取通过 API 或仪表板请求的批次的状态。
- 抓取/创建：抓取域以截取所有页面。您可以使用此 API 调用或仪表板。
- 抓取/信息：获取通过 API 或仪表板请求的抓取状态。
- 截图/信息
- 截图/创建
- 截图/列表
browshot的网页截图的核心优势是什么？
 |
 |
 |
自动 S3 上传只需调用一次 API，即可将截图直接上传到 S3！ |
30 多种浏览器iOS、Android、iPhone、Nexus、iPad、PC 等。 |
现收现付的低廉价格无需支付高昂的月租费，只需按需付费。 |
在哪些场景会用到browshot的网页截图？
|
1.网站监控与分析：假设你运营一个网站监控服务，客户希望定期检查其网站的视觉呈现是否正常，有无布局错乱或内容被篡改。你可以使用Browshot的网页截图API定时抓取网站首页或关键页面的截图，并与之前保存的截图对比，一旦发现差异即可立即通知客户，确保网站始终以预期的状态运行。 |
|
|
2.SEO优化与竞争分析：SEO专家和数字营销团队可能会利用网页截图API来收集竞争对手网站的视觉数据，快速了解对方的页面布局、广告展示、内容更新等信息。例如，批量抓取搜索结果页上的前100个竞争对手网站，分析他们的元标记使用、标题结构等，从而优化自己的网站策略，提升搜索引擎排名。 |
|
|
|
截图 API
您可以申请特定实例的截图，查询其状态并下载截图和/或缩略图。
/api/v1/screenshot/create
私人和共享实例的截图请求需要正余额。
要求
所需参数：
-
url：要截图的页面的 URL
-
instance_id：要使用的实例 ID
常用参数：
-
size：截图尺寸："屏幕"（默认）或 "页面
-
cache：如果截图是在<cache_value> 秒内完成的，则使用之前的截图（同一 URL、同一实例）。默认值为 24 小时。如果需要新截图，请指定cache=0。
-
delay=0 -120（默认值：5）：页面加载后等待的秒数。用于让 JavaScript 运行更长时间后再截屏。使用delay=0可以更快地截图。
-
screen_width(1-5000)：浏览器窗口的宽度。仅适用于桌面浏览器。
-
screen_height（1-10000）：浏览器窗口的高度。仅适用于桌面浏览器。(注意：整页截图的高度可达 15000px）。
可选参数：
-
hide_popups：隐藏页面上的弹出窗口（广告、cookie 警告等）。
-
黑暗：在黑暗模式下运行浏览器 - 仅适用于 Chrome 浏览器和手机
-
strict_ssl（默认值：0）：启用过期证书检测功能，阻止混合内容 - 仅适用于 Chrome 浏览器和移动设备
-
推荐人（仅限付费截图）：使用自定义推荐人（请参阅 "自定义 POST 数据"、"推荐人和 Cookie"）。
-
post_data（仅限付费截图）：发送带有 post_data 的 POST 请求，用于填写表格（请参阅自定义 POST 数据、推荐人和 Cookie）。
-
cookie（仅限付费截图）：为请求的 URL 设置 Cookie（请参阅自定义 POST 数据、推荐人和 Cookie）Cookie 应使用 ；
-
脚本：页面加载事件后要执行的javascript 文件的 URL。
-
script_inline：页面加载事件后要执行的 Javascript 内容。
-
details=0-3（默认值：0）：截图/信息提供的信息级别。
-
html=0,1（默认值：0）：保存渲染页面的 HTML（可通过 API 调用screenshot/html 获取），并对页面内容进行分类。每张截图需花费 1 个信用点。
-
max_wait=1 -60（默认值：0 = 禁用）：触发 PageLoad 事件前的最大等待秒数。注意，仍将使用延迟。
-
headers：任何自定义 HTTP 标头。(不支持 Internet Explorer）
-
target: CSS 选择器。截图页面上由 CSS 选择器标识的元素
-
priority=1-3（仅适用于私人实例）：为截图指定优先级
钩子：
当截图完成或失败时，您可以通过自己的 URL 接收通知。添加此参数：
-
hook：您接收通知的 URL
当截图准备就绪（状态：完成或出错）时，将向您的 URL 发送 POST 请求。请求体包含 API 调用screenshot/info 返回的 JSON 数据。如果您的 URL 响应时间过长或未返回 20X 状态代码，请求最多可重试 2 次。
自动化步骤
您可以创建与浏览器的达成交互，并截取多张屏幕截图。有关详细信息和示例，请参阅我们的博文。
-
步骤：JSON 格式的步骤列表。更多信息，请参阅我们的博文。
跟踪器
您可以从网页中提取信息，如搜索排名、价格、交货日期、页面标题等。有关更多信息和示例，请参阅我们的博文。
-
trackers （新增 1.28）：JSON 格式的跟踪器列表。更多信息，请参阅我们的博文。
托管：
您可以使用这些附加参数将截图和缩略图自动托管到 S3/Browshot/CDN：
-
托管：托管选项：S3 或 Browshot
-
hosting_height（可选）：要托管的缩略图的最大高度
-
hosting_width（可选）：要托管的缩略图的最大宽度
-
hosting_scale（可选）：要托管的缩略图的比例
-
hosting_bucket（S3 需要）：用于上传截图或缩略图的 S3 存储桶
-
hosting_file（可选，仅适用于 S3）：要使用的文件名
-
hosting_headers（可选，仅适用于 S3）：要添加到 S3 对象的标头列表
-
hosting_private（可选，仅适用于 S3）：将 ACL 设置为 "bucket-owner-full-control"，而不是 "public-read"。
如果截图成功，缩略图或截图将自动托管，无需调用screenshot/host。
公共和共享实例的优先级是自动分配的：1 代表最高，3 代表最低。处于处理状态的截图较少的账户优先。已处理截图的比例约为 4 个优先级 1、2 个优先级 2 和 1 个优先级 3（将来可能会改变）。
重要：请记住，每月只能截取 100 张免费截图。要使用高级实例，请使用instance_id=65。
实例
Response:
截图 API
您可以申请特定实例的截图，查询其状态并下载截图和/或缩略图。
/api/v1/screenshot/create
私人和共享实例的截图请求需要正余额。
要求
所需参数：
-
url：要截图的页面的 URL
-
instance_id：要使用的实例 ID
常用参数：
-
size：截图尺寸："屏幕"（默认）或 "页面
-
cache：如果截图是在<cache_value> 秒内完成的，则使用之前的截图（同一 URL、同一实例）。默认值为 24 小时。如果需要新截图，请指定cache=0。
-
delay=0 -120（默认值：5）：页面加载后等待的秒数。用于让 JavaScript 运行更长时间后再截屏。使用delay=0可以更快地截图。
-
screen_width(1-5000)：浏览器窗口的宽度。仅适用于桌面浏览器。
-
screen_height（1-10000）：浏览器窗口的高度。仅适用于桌面浏览器。(注意：整页截图的高度可达 15000px）。
可选参数：
-
hide_popups：隐藏页面上的弹出窗口（广告、cookie 警告等）。
-
黑暗：在黑暗模式下运行浏览器 - 仅适用于 Chrome 浏览器和手机
-
strict_ssl（默认值：0）：启用过期证书检测功能，阻止混合内容 - 仅适用于 Chrome 浏览器和移动设备
-
推荐人（仅限付费截图）：使用自定义推荐人（请参阅 "自定义 POST 数据"、"推荐人和 Cookie"）。
-
post_data（仅限付费截图）：发送带有 post_data 的 POST 请求，用于填写表格（请参阅自定义 POST 数据、推荐人和 Cookie）。
-
cookie（仅限付费截图）：为请求的 URL 设置 Cookie（请参阅自定义 POST 数据、推荐人和 Cookie）Cookie 应使用 ；
-
脚本：页面加载事件后要执行的javascript 文件的 URL。
-
script_inline：页面加载事件后要执行的 Javascript 内容。
-
details=0-3（默认值：0）：截图/信息提供的信息级别。
-
html=0,1（默认值：0）：保存渲染页面的 HTML（可通过 API 调用screenshot/html 获取），并对页面内容进行分类。每张截图需花费 1 个信用点。
-
max_wait=1 -60（默认值：0 = 禁用）：触发 PageLoad 事件前的最大等待秒数。注意，仍将使用延迟。
-
headers：任何自定义 HTTP 标头。(不支持 Internet Explorer）
-
target: CSS 选择器。截图页面上由 CSS 选择器标识的元素
-
priority=1-3（仅适用于私人实例）：为截图指定优先级
钩子：
当截图完成或失败时，您可以通过自己的 URL 接收通知。添加此参数：
-
hook：您接收通知的 URL
当截图准备就绪（状态：完成或出错）时，将向您的 URL 发送 POST 请求。请求体包含 API 调用screenshot/info 返回的 JSON 数据。如果您的 URL 响应时间过长或未返回 20X 状态代码，请求最多可重试 2 次。
自动化步骤
您可以创建与浏览器的达成交互，并截取多张屏幕截图。有关详细信息和示例，请参阅我们的博文。
-
步骤：JSON 格式的步骤列表。更多信息，请参阅我们的博文。
跟踪器
您可以从网页中提取信息，如搜索排名、价格、交货日期、页面标题等。有关更多信息和示例，请参阅我们的博文。
-
trackers （新增 1.28）：JSON 格式的跟踪器列表。更多信息，请参阅我们的博文。
托管：
您可以使用这些附加参数将截图和缩略图自动托管到 S3/Browshot/CDN：
-
托管：托管选项：S3 或 Browshot
-
hosting_height（可选）：要托管的缩略图的最大高度
-
hosting_width（可选）：要托管的缩略图的最大宽度
-
hosting_scale（可选）：要托管的缩略图的比例
-
hosting_bucket（S3 需要）：用于上传截图或缩略图的 S3 存储桶
-
hosting_file（可选，仅适用于 S3）：要使用的文件名
-
hosting_headers（可选，仅适用于 S3）：要添加到 S3 对象的标头列表
-
hosting_private（可选，仅适用于 S3）：将 ACL 设置为 "bucket-owner-full-control"，而不是 "public-read"。
如果截图成功，缩略图或截图将自动托管，无需调用screenshot/host。
公共和共享实例的优先级是自动分配的：1 代表最高，3 代表最低。处于处理状态的截图较少的账户优先。已处理截图的比例约为 4 个优先级 1、2 个优先级 2 和 1 个优先级 3（将来可能会改变）。
重要：请记住，每月只能截取 100 张免费截图。要使用高级实例，请使用instance_id=65。
实例
Response:
