CloudBrowser Docs
  1. Fundamentals
CloudBrowser Docs
  • Documentation
    • Introduction
      • What is CloudBrowser?
      • What is Headless browsers?
      • Getting started
      • Playwright
    • Fundamentals
      • Create a Browser Session
      • Use a Browser Profile
      • Manage a Browser Profile
    • Features
      • Stealth Mode
      • Proxies
      • Live View
      • Session Inspector
      • Downloads
      • Uploads
    • User Cases
      • Form Submissions
      • Web Scraping
      • Automated Tests
    • Guides
      • Improving Performance
      • Optimizing Cost
      • Browser Regions
      • Using Profile ID
      • Plans and Pricing
      • Concurrency & Rate Limits
      • Handling Authentication
      • Enerprise Security
    • Inegrations
      • Get Started with Intergrations
      • CloudBrowser MCP Server
      • CloudBrowser MCP Service
  • APIs and SDKs
    • Node.js SDK
    • Profile
      • Get session list
      • Update Instance Fingerprint
    • sessions
      • Create Browser Session
      • Start Session
      • Close Session
    • files
      • Upload File
      • Download File
    • plugin
      • Upload Plugin
      • Get Plugin List
      • Update Environment Fingerprint
  • Changelog
  1. Fundamentals

Create a Browser Session

Configuration Options for CloudBrowser Sessions#

Customize your session behavior using the following settings. For full API details, refer to the Create Session API Docs.

Core Settings#

SettingDescription
RegionSpecify a geographic location to reduce latency (e.g., us-west, eu-central)
ViewportDefine screen dimensions (e.g., 1920x1080) or use default dynamic sizing
Keep AliveExtend session lifetime beyond disconnection for long-running tasks
RecordingEnable/disable session recording (enabled by default)
LoggingToggle debug logs for troubleshooting (enabled by default)

Advanced Features#

Anti-Bot Protection#

Basic Fingerprint Randomization: Randomizes OS, locale, and device type fingerprints.
Enhanced Stealth Mode: Available only on Enterprise plans for advanced anti-bot mitigations.

Proxy Configuration#

Use residential proxies or custom IP pools to rotate IP addresses.

CAPTCHA Handling#

Auto-solve CAPTCHAs (enabled by default).

Extensions#

Load custom browser extensions to enhance functionality.

Context Management#

Create isolated browsing contexts for multi-account workflows (e.g., managing multiple user profiles).

Metadata Tags#

Add custom labels for session categorization and filtering (e.g., project:scraping, environment:test).

Next Steps#

After creating a session:
1.
Connect
Use the connection URL with your automation framework (e.g., Playwright's connectOverCDP).
2.
Monitor
Track session performance via the Session Inspector.
3.
Terminate
End sessions manually or let them expire based on timeout settings.
Previous
Playwright
Next
Use a Browser Profile
Built with