跳转到主要内容
POST
同步抓取

入门

基础 URL

请求示例

成功请求将返回渲染后的页面 HTML 及元数据:

渲染选项

render 对象控制浏览器在捕获 HTML 前如何加载页面。所有字段均为可选,省略时使用服务器默认值。
JavaScript 较多、加载后仍持续拉取数据的页面示例:

资源选项

resources 对象控制浏览器在抓取过程中加载哪些资源类型。当您只需要 HTML 文本和结构时,阻止重型资源可加快请求速度。
所有字段均为可选。省略 resources 时,除非部署配置了服务器端默认值,否则不会阻止任何资源类型。 示例 — 跳过图片和字体以加快抓取:

请求参数

String
必填
要抓取的目标 URL。必须是公开的 HTTP 或 HTTPS URL。对 localhost 和私有 IP 的请求会被 SSRF 防护阻止。
String
必填
您的唯一 API 密钥。
String
可选会话 ID,用于在多次抓取请求间复用浏览器状态(Cookie、本地存储)。
String
浏览器指纹预设。支持值:desktop_en_us、desktop_ru_ru、mobile_en_us。
Object
浏览器会话的渲染选项。
String
判定导航完成的时机。值:domcontentloaded、networkidle。默认:domcontentloaded。
Integer
等待页面加载的最长时间(毫秒)。默认:60000。
Integer
页面加载事件后、捕获内容前的额外等待时间(毫秒)。
Boolean
为 true 时忽略目标页面的 TLS 证书错误。
Object
资源加载控制。
Array
要阻止的资源类型。支持值:images、fonts、media。
Array
捕获内容前执行的浏览器操作有序列表。每个操作是包含 type 字段的对象。
String
必填
操作类型。支持值:wait、wait_for、click、type、scroll。
String
用于 wait_for、click 或 type 操作的 CSS 选择器。
String
type 操作要输入的文本。
String
scroll 操作的滚动目标(如 bottom)。
Integer
wait 操作的等待时长(毫秒)。
Integer
wait_for 操作的超时时间(毫秒)。
Array
导航前注入的 Cookie。每个 Cookie 对象需要 name 和 value;可选字段:domain、path。

响应参数

API 响应以通用轻量的 JSON 格式 返回。
Boolean
抓取是否成功完成。
String
渲染后的页面 HTML。
Object
抓取元数据,包括最终 URL、HTTP 状态码和处理时长。
Object
当 ok 为 false 时的错误详情。