Octo Browser SOP

Appearance

Test ​

Classification: NEEDS-DESKTOP (paid) ​

Status: NEEDS-DESKTOP Octo Browser is a paid antidetect browser with no free tier. A paid subscription is required to use the service. The desktop app must be downloaded from octobrowser.net and installed. The local API is only reachable while the app is open and signed in.

Install method: Download the installer from octobrowser.net and run it. Sign in with a paid account. The local API listens on port 58888 by default.

Cost/access: Paid subscription required. No free tier. API access requires Base plan or higher.

Octo Browser requires a running desktop app, so end-to-end automation tests cannot be run without the app installed and a valid account. The two smoke tests below verify different layers of the stack.

Smoke test 1: Local API reachability ​

With Octo Browser running and signed in, confirm the local API is listening:

bash
curl -s http://localhost:58888/api/profiles/active

Expected success output (empty array if no profiles are running):

json
[]

Or, if profiles are active:

json
[
  {
    "uuid": "2bbfd1dbaf3349cf979787f15a9e413d",
    "state": "STARTED",
    "headless": false,
    "start_time": 1724173918,
    "ws_endpoint": "",
    "debug_port": "",
    "one_time": false,
    "browser_pid": 26616
  }
]

A Connection refused error means the desktop app is not running or the local API is disabled.

Smoke test 2: Cloud API authentication ​

Replace YOUR_API_TOKEN with a real token from the Octo dashboard (Settings > API). Requires Base plan or higher.

bash
curl -s -X GET "https://app.octobrowser.net/api/v2/automation/profiles?page=0&page_len=10" \
  -H "X-Octo-Api-Token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

Expected success output:

json
{
  "success": true,
  "msg": null,
  "data": [...],
  "total_count": 5,
  "page": 0
}

Auth failure output (wrong or missing token):

json
{
  "success": false,
  "msg": "Unauthorized"
}

Notes ​

  • tested=false for this SOP: the desktop app is not installed in the CI environment, so neither curl test was executed live.
  • Smoke test 1 can be run by anyone with Octo installed and the app open; no subscription tier is required.
  • Smoke test 2 requires Base plan (EUR 79/mo) or higher to have API access enabled.
  • Rate limit headers to watch: X-Ratelimit-Limit-Rpm, X-Ratelimit-Remaining-Rpm, Retry-After (on 429 responses).