---
title: "List saved profiles and account-wide quotas"
method: GET
path: "/cloud-browsers"
tags: ["Cloud browsers"]
---

# List saved profiles and account-wide quotas

`GET /cloud-browsers`

## Request

- Base URL: `https://api.adscrawl.net`
- URL: `https://api.adscrawl.net/cloud-browsers`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
  - API key in cookie `access_token`
- TypeScript: <https://skmtc.dev/adscrawl/apis/adscrawl-api/docs/cloud-browsers/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `page` integer
- `pageSize` integer

## Response `200`

Profiles owned by the authenticated user. limit is saved-profile capacity; runningCount includes starting/running/stopping sessions across all pages and API keys. Temporary CDP sessions are separate.

- object
  - `ok` boolean
  - `data` CloudBrowser[]
    - `id` string, uuid
    - `source` 'manual' | 'launch'
    - `deleteOnStop` boolean: Current profiles are retained on stop; false.
    - `deleted` boolean
    - `remark` string
    - `browserSettings` object: Saved browser settings with proxy credentials removed; may include owner-readable cookies and snapshots.
    - `proxyDisplayIp` string, nullable
    - `proxyDisplayRegion` string, nullable
    - `lastOpenedAt` string, date-time, nullable
    - `updatedAt` string, date-time
    - `runtime` CloudRuntime
      - `runtimeKind` 'neko' | 'worker_cdp'
      - `status` 'starting' | 'running' | 'stopping' | 'stopped', required
      - `sessionId` string
      - `expiresAt` string, date-time
      - `connectUrl` string, uri: Optional interactive viewer URL when running; requires the profile owner's login session.
      - `cdpBaseUrl` string, uri: Only worker_cdp may return this; neko omits it.
  - `pagination` object
    - `page` integer
    - `pageSize` integer
    - `total` integer
    - `totalPages` integer
  - `limit` integer
  - `runningLimit` integer
  - `runningCount` integer

## Other responses

- `default`: Error response. Typical statuses are 400 invalid input, 401 invalid authentication, 402 payment/credits required, 403 ownership mismatch, 404 missing resource, 409 state or quota conflict, 410 expired session, 429 rate/concurrency limit, 500 internal failure, 502 upstream failure, 503 capacity/runtime unavailable, or 504 timeout. Not every status applies to every operation. Use HTTP status and code when present.

---

[API](https://skmtc.dev/adscrawl/apis/adscrawl-api.md) - [All operations](https://skmtc.dev/adscrawl/apis/adscrawl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adscrawl/apis/adscrawl-api/revisions/aa45d0651921?raw)