curl --fail-with-body --silent --show-error --max-time 65 \
-X GET 'https://api.adscrawl.net/cloud-browsers?page=1&pageSize=10' \
-H 'x-api-key: <api-key>'
{
"ok": true,
"data": [
{
"id": "<browser-id>",
"source": "manual",
"deleteOnStop": false,
"remark": "work profile",
"browserSettings": {
"viewport": {
"width": 1440,
"height": 900
}
},
"proxyDisplayIp": null,
"proxyDisplayRegion": null,
"lastOpenedAt": null,
"updatedAt": "2026-09-07T08:00:00.000Z",
"runtime": {
"runtimeKind": "neko",
"status": "stopped"
}
}
],
"pagination": {
"page": 1,
"pageSize": 10,
"total": 1,
"totalPages": 1
},
"limit": 10,
"runningLimit": 1,
"runningCount": 0
}
云浏览器
列出云浏览器配置
检索你账户下所有已保存的云浏览器配置文件，返回包含分页元数据的配置列表以及账户配额信息，包括你可保存的配置数上限、可同时运行的并发上限以及当前已占用的运行槽位数，方便你在启动新浏览器前检查剩余容量，也可以在一个请求中轮询所有配置文件的实时运行状态和交互式查看器连接地址。
GET
/
cloud-browsers
curl --fail-with-body --silent --show-error --max-time 65 \
-X GET 'https://api.adscrawl.net/cloud-browsers?page=1&pageSize=10' \
-H 'x-api-key: <api-key>'
{
"ok": true,
"data": [
{
"id": "<browser-id>",
"source": "manual",
"deleteOnStop": false,
"remark": "work profile",
"browserSettings": {
"viewport": {
"width": 1440,
"height": 900
}
},
"proxyDisplayIp": null,
"proxyDisplayRegion": null,
"lastOpenedAt": null,
"updatedAt": "2026-09-07T08:00:00.000Z",
"runtime": {
"runtimeKind": "neko",
"status": "stopped"
}
}
],
"pagination": {
"page": 1,
"pageSize": 10,
"total": 1,
"totalPages": 1
},
"limit": 10,
"runningLimit": 1,
"runningCount": 0
}
检索你账户下所有已保存的云浏览器配置文件，并附带一些全账户配额字段，告诉你最多可保存多少配置文件（
limit）、同时可运行多少个（runningLimit），以及当前已占用多少个运行槽位（runningCount）。此端点接受 x-api-key、Authorization: Bearer 会话 JWT 或 Dashboard 会话 Cookie 进行认证。
integer
默认值:"1"
要获取的页码。默认为
1；无效或非正值会回退到 1。上限为 10000。integer
默认值:"10"
每页返回的配置文件数量。默认为
10；无效或非正值会回退到 10。最大值为 10。响应
boolean
成功时始终为
true。array
所请求页面的已保存云浏览器配置文件对象列表。
显示 Profile 对象字段
显示 Profile 对象字段
string (UUID)
持久性配置文件标识符。在启动、停止、详情和删除的路径参数中使用该值。
string
配置文件来源：通过
POST /cloud-browsers 创建的是 manual，通过 POST /cloud-browsers/launch 创建的是 launch。boolean
当前 API 响应中始终为
false。配置文件在停止后会保留，除非显式删除。string | null
创建时通过 PATCH 保存的可选标签。
object
已保存的配置（viewport、locale、timezoneId、代理显示信息、cookies、指纹）。代理凭据已从响应中移除。
string | null
最后观察到的代理出口 IP 地址，如果未设置则为
null。string | null
最后观察到的代理区域，如果未设置则为
null。string (RFC3339) | null
最近一次成功启动的时间戳，如果配置文件从未运行过则为
null。string (RFC3339)
最近一次配置文件更新的时间戳。
object
integer
你套餐的保存配置文件上限：你同时最多可保存的配置文件数量。达到此上限后再创建新配置文件会返回
409。integer
你账户的并发运行上限。值为
0 时将阻止所有新启动。未设置或为负值时默认为 1。降低此值不会停止当前正在运行的会话。integer
当前在你的所有配置文件、所有页面和所有 API 密钥中处于
starting、running 或 stopping 状态的会话总数。此计数不包括通过 /cdp/sessions 创建的临时远程 CDP 会话。| Code | Meaning |
|---|---|
200 | 成功 |
401 | 未认证 |
403 | 会话数已达上限 |
500 | 内部错误 |
503 | 运行时不可用 |
runningCount 包含 所有三种活跃状态（starting、running 和 stopping），因为这三种状态都会占用一个运行槽位。会话直到达到 stopped 状态才会释放其槽位。curl --fail-with-body --silent --show-error --max-time 65 \
-X GET 'https://api.adscrawl.net/cloud-browsers?page=1&pageSize=10' \
-H 'x-api-key: <api-key>'
{
"ok": true,
"data": [
{
"id": "<browser-id>",
"source": "manual",
"deleteOnStop": false,
"remark": "work profile",
"browserSettings": {
"viewport": {
"width": 1440,
"height": 900
}
},
"proxyDisplayIp": null,
"proxyDisplayRegion": null,
"lastOpenedAt": null,
"updatedAt": "2026-09-07T08:00:00.000Z",
"runtime": {
"runtimeKind": "neko",
"status": "stopped"
}
}
],
"pagination": {
"page": 1,
"pageSize": 10,
"total": 1,
"totalPages": 1
},
"limit": 10,
"runningLimit": 1,
"runningCount": 0
}