预览完整页面
为审核工具和内部网站预览生成整页图片。保留目标 URL，方便审核者确认来源。
01 / 产品介绍
什么是网页截图 API？
AdsCrawl 网页截图 API 通过 POST /screenshot 在浏览器中打开 URL 并返回 PNG。使用 fullPage 截取整页，或使用 selector 截取第一个匹配元素。成功响应是图片二进制数据，应保存为文件，而不是按 JSON 解析。
02 / 适用场景
适合哪些任务？
聚焦一个组件
使用精确的 CSS 选择器截取图表、卡片或其他元素，接口会截取第一个匹配元素。
保留视觉上下文
把截图与监控结果或研究记录一起保存。截图记录请求时的渲染状态，不保证页面以后保持相同外观。
03 / 快速开始
从一个完整流程开始
- 设置服务端 API Key 并选择目标 URL。
- 整页使用 fullPage，单个元素使用 selector。
- 调用 POST /screenshot 并按文档设置合适的等待条件。
- 检查响应状态，将成功的二进制响应保存为 screenshot.png。
示例环境：Bash 与 cURL。 先在服务端设置 ADSCRAWL_API_KEY 环境变量。
完整参数与响应说明 →curl --fail-with-body -sS \
-X POST "https://api.adscrawl.net/screenshot" \
-H "x-api-key: $ADSCRAWL_API_KEY" \
-H "content-type: application/json" \
-d '{
"url": "https://www.adscrawl.net",
"fullPage": true,
"waitUntil": "load"
}' \
--output screenshot.png
# Add "selector": "main" to capture one element.- 失败响应可能是错误文本而非 PNG，保存前需检查 HTTP 状态。
- 懒加载图片或延迟组件可能需要额外的受支持等待选项，load 不代表所有内容都已就绪。
- 选择器需足够精确且元素确实存在，单次元素截图不会捕获所有匹配元素。
- 截图消耗额度和浏览器运行能力，高频调度前请确认价格与额度。
API Key 仅保存在服务端。遇到 HTTP 402 请检查额度，遇到 429 请降低并发并退避重试。
05 / FAQ
常见问题
可以只截图表吗？
可以。提供图表容器的 CSS 选择器，接口截取第一个匹配元素。
截图接口会提取文字吗？
它返回 PNG 图片，需要可读文字时使用 HTML 或 Markdown 流程；截图接口不是 OCR 服务。
为什么部分动态内容没有出现在截图中？
截图反映截取时的页面状态，请检查目标网站的加载行为，并选择与之匹配的受支持等待设置。
