Skip to main content
AdsCrawl REST API 支持以编程方式渲染网页、截取屏幕截图、提取 SPA 数据、管理远程 CDP 会话以及启动持久化云浏览器。本页介绍基础请求地址、认证方式、积分计费规则、常见 HTTP 状态码,以及所有接口分组的入口。

基础地址

所有接口均通过 HTTPS 访问:

认证方式

几乎所有端点都需要在请求头中携带 API 密钥 x-api-key。请在 AdsCrawl 控制台 生成和管理密钥。请将密钥保存在环境变量或密钥管理器中,切勿在客户端代码或公开仓库中暴露。 云浏览器生命周期端点(/cloud-browsers/*)也接受通过 Authorization: Bearer <SESSION_JWT> 传递的会话 JWT,或 Dashboard 会话 Cookie。 所有带有 JSON 请求体的请求都必须包含:

积分消耗

各项操作按以下规则扣除积分。 积分在请求校验通过后、任务执行前扣除。浏览器任务执行失败后不会退还积分。云浏览器计费在首次确认停止后结束。

常见状态码

接口使用标准 HTTP 响应状态码。

接口分组

浏览器任务

通过住宅代理和随机指纹渲染 HTML、截取屏幕截图并提取 SPA 数据。

远程 CDP

创建并管理远程 Chrome DevTools Protocol 会话,实现底层浏览器控制。

云浏览器

保存、启动、开启和停止带有实时交互式查看器的持久化云浏览器配置文件。

模型定义

查看整个 API 使用的共享请求和响应对象定义。