WebShot
收藏RapidAPI2026-04-04 更新2026-03-30 收录
下载链接：
https://rapidapi.com/wtsng85/api/webshot3
下载链接
链接失效反馈官方服务：
资源简介：
Powerful web screenshot and PDF conversion API — capture full-page screenshots, render JavaScript-heavy pages, convert URLs to PDF, and extract metadata. Supports batch operations for up to 10 URLs.
创建时间：
2026-04-04
原始信息汇总
WebShot API 数据集概述
基本信息
- 数据集名称: WebShot
- 类别: Business Software
- 提供者: Dave Sng
- 订阅者数量: 1
- 当前版本: v1.2
定价计划
- BASIC: $0.00 / 月
- PRO: $9.99 / 月
- ULTRA: $49.99 / 月
- MEGA: $199.99 / 月
API 概述
WebShot 是一个基于 Playwright 和 Chromium 构建的高性能网页捕获 API。它通过简单的 REST 端点，提供以下功能：获取任何网页的像素级完美截图、渲染 JavaScript 密集的单页应用程序、将 URL 转换为 PDF 文档以及提取页面元数据。其特性包括支持自动滚动的整页捕获、自定义视口尺寸、多种输出格式（PNG/JPEG/WebP）以及最多可同时处理 10 个 URL 的批量操作。内置 SSRF 保护确保安全性。标准捕获的平均响应时间低于 5 秒。
端点详情
1. 截图
- 端点:
POST /v1/screenshot - 功能: 捕获任何公共网页的视口截图。
- 参数:
url(字符串，必需): 目标 URL (http/https)format(字符串，非必需，默认png): 输出格式：png、jpeg、webpwidth(整数，非必需，默认1280): 视口宽度 (100–3840 px)height(整数，非必需，默认720): 视口高度 (100–2160 px)wait_ms(整数，非必需，默认0): 页面加载后等待时间 (0–10000 ms)full_page(布尔值，非必需，默认false): 捕获完整可滚动页面
- 响应: 二进制图像 (
image/png、image/jpeg或image/webp)
2. 整页截图
- 端点:
POST /v1/screenshot/full-page - 功能: 将整个可滚动页面捕获为单个图像。
- 参数:
url(字符串，必需): 目标 URLformat(字符串，非必需，默认png): 输出：png、jpeg、webpwidth(整数，非必需，默认1280): 视口宽度 (100–3840 px)wait_ms(整数，非必需，默认0): 加载后等待时间 (0–10000 ms)
- 响应: 二进制图像
3. 渲染 (JavaScript SPA)
- 端点:
POST /v1/render - 功能: 渲染 JavaScript 密集型页面并返回完全渲染的 HTML。
- 参数:
url(字符串，必需): 目标 URLwait_ms(整数，非必需，默认2000): 等待 JS 执行的时间 (0–10000 ms)
- 响应 (JSON): json { "success": true, "data": { "html": "<html>...rendered content...</html>" } }
4. 从 URL 生成 PDF
- 端点:
POST /v1/pdf/from-url - 功能: 将任何网页转换为 PDF 文档。
- 参数:
url(字符串，必需): 目标 URLformat(字符串，非必需，默认A4): 页面尺寸：A4、A3、Letter、Legal、Tabloidlandscape(布尔值，非必需，默认false): 横向方向
- 响应: 二进制 PDF (
application/pdf)
5. 页面元数据
- 端点:
POST /v1/metadata - 功能: 从网页提取 SEO 元数据和 Open Graph 标签。
- 参数:
url(字符串，必需): 目标 URL
- 响应 (JSON): json { "success": true, "data": { "title": "Page Title", "description": "Meta description", "og_title": "Open Graph Title", "og_description": "OG Description", "og_image": "https://example.com/image.png", "canonical": "https://example.com/" } }
6. 批量截图
- 端点:
POST /v1/batch/screenshots - 功能: 在一个请求中捕获多个 URL 的截图（最多 10 个）。
- 参数:
urls(数组，必需): URL 列表 (1–10)format(字符串，非必需，默认png): 输出：png、jpeg、webpwidth(整数，非必需，默认1280): 视口宽度 (100–3840 px)
- 响应: 包含所有截图的 ZIP 存档。检查
X-Batch-Success和X-Batch-Failed头部以获取结果。
7. 批量 PDF
- 端点:
POST /v1/batch/pdf - 功能: 将多个 URL 转换为 PDF 并合并为单个文档（最多 10 个）。
- 参数:
urls(数组，必需): URL 列表 (1–10)format(字符串，非必需，默认A4): 页面尺寸：A4、A3、Letter、Legal、Tabloidlandscape(布尔值，非必需，默认false): 横向方向
- 响应: 合并的 PDF 文档。检查
X-Batch-Success和X-Batch-Failed头部。
错误处理
所有错误返回 JSON: json { "success": false, "error": "error_code", "detail": "Human-readable message" }
错误状态码
| 状态码 | 错误代码 | 描述 |
|---|---|---|
| 400 | invalid_url | URL 必须以 http:// 或 https:// 开头 |
| 400 | blocked_url | 私有/内部 URL 被阻止（SSRF 保护） |
| 429 | rate_limited | 请求过多 — 请放慢速度 |
| 500 | screenshot_failed | 捕获失败（页面超时、崩溃等） |
响应头部
每个响应都包含：
| 头部 | 描述 |
|---|---|
| X-Request-ID | 唯一的 8 字符请求标识符 |
| X-API-Version | 当前 API 版本 |
| X-Response-Time | 处理时间（毫秒） |
使用案例
- SEO 监控 — 捕获竞争对手页面的视觉快照
- QA 测试 — 自动化视觉回归测试
- 归档 — 将网页转换为 PDF 以进行长期存储
- 社交预览 — 生成 OG 图像预览
- 报告 — 批量将仪表板转换为 PDF
- SPA 渲染 — 从 JavaScript 密集型站点获取完全渲染的 HTML
