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
}
Cloud Browsers
List Cloud Browser Profiles
List all saved cloud browser profiles for your account along with pagination metadata and your plan’s saved-profile and concurrent-running allowances.
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
}
Retrieve every cloud browser profile saved under your account together with account-wide quota fields that tell you how many profiles you can save (
limit), how many can run at the same time (runningLimit), and how many are currently occupying a running slot (runningCount). This endpoint accepts x-api-key, a session JWT in Authorization: Bearer <token>, or a dashboard session cookie.
integer
default:"1"
Page number to retrieve. Defaults to
1; invalid or non-positive values fall back to 1. Maximum is 10000.integer
default:"10"
Number of profiles per page. Defaults to
10; invalid or non-positive values fall back to 10. Maximum is 10.Response
boolean
Always
true on success.array
List of saved cloud browser profile objects for the requested page.
Show Profile object fields
Show Profile object fields
string (UUID)
Persistent profile identifier. Use this value in path parameters for start, stop, detail, and delete.
string
Origin of the profile:
manual for profiles created with POST /cloud-browsers, or launch for profiles created with POST /cloud-browsers/launch.boolean
Always
false in current API responses. Profiles are retained after stop unless explicitly deleted.string | null
Optional label saved at creation or via PATCH.
object
Saved configuration (viewport, locale, timezoneId, proxy display info, cookies, fingerprint). Proxy credentials are stripped from responses.
string | null
Last observed proxy exit IP address, or
null if not yet set.string | null
Last observed proxy region, or
null if not yet set.string (RFC3339) | null
Timestamp of the most recent successful start, or
null if the profile has never run.string (RFC3339)
Timestamp of the most recent profile update.
object
Current runtime status for this profile.
Show Runtime fields
Show Runtime fields
string
neko or worker_cdp.string
starting, running, stopping, or stopped. Both starting and stopping reserve a running slot.string
Present when an active session exists.
string (RFC3339)
Session expiry timestamp; present when an active session exists.
string
Direct URL to the interactive browser viewer. Only present when
status is running. Open it in a browser signed in as the profile owner. Never append API keys or proxy credentials to this URL.object
integer
Your plan’s saved-profile allowance: the maximum number of profiles you can save at once. Creating a new profile when you have reached this limit returns
409.integer
Your account’s concurrent running allowance. A value of
0 blocks all new starts. An unset or negative limit defaults to 1. Lowering this value does not stop currently running sessions.integer
Total number of sessions currently in
starting, running, or stopping state across all your profiles, pages, and API keys. This count excludes temporary Remote CDP sessions created via /cdp/sessions.| Code | Meaning |
|---|---|
200 | Success |
401 | Unauthenticated |
403 | Session limit reached (SESSIONS_PER_API_KEY_LIMIT_REACHED) |
500 | Internal error |
503 | Runtime unavailable |
runningCount includes sessions in all three active states (starting, running, and stopping) because all three reserve a running slot. A session does not release its slot until it reaches 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
}