Skip to main content
A browser session is a cloud Chromium instance you control over CDP (Playwright, Puppeteer) or Anchor’s APIs. Create one, automate, then end it when done.

​
What you get back

Every successful create returns:
FieldUse it for
idSession identity — reconnect, run tasks, fetch recordings
cdp_urlConnect Playwright or Puppeteer over Chrome DevTools Protocol
live_view_urlEmbed or share a live view of the browser — see Embedded Browser Live UI
By default sessions start headful with recording enabled. See Start Browser Session for defaults and full schema.

​
How to create

GuideWhen to use
Create a SessionStandard create — blocks until the browser is ready. Best for scripts and single sessions.
Async SessionReturns immediately; poll until ready. Best for parallel provisioning or long proxy/stealth setups.
Batch Browser SessionsMany sessions in one call (up to 5,000). Best for large-scale scraping or load tests.

​
Configure at create

Pass optional session and browser blocks in the create request body. The shape is the same for sync, async, and batch creates. Full schema: Start Browser Session. 
{
  "session": {
    "initial_url": "https://app.example.com"
  },
  "browser": {
    "headless": { "active": true }
  },
  "identities": [{ "id": "your-identity-id" }]
}
Attach identities to start signed in, or set browser.profile to load a saved browser state — see the auth rows below. Setup for each option lives on its own page — this section only links there:
Configurable at createLearn more
Proxy, VPN, sticky IPProxy, Anchor VPN, Dedicated sticky IP
Stealth, captcha, web bot authStealth, CAPTCHA solving, Web Bot Auth
Extensions, adblock, popups, sensitive data masking, timeouts, tags, CA certsCustomize in the sidebar
Profiles (browser.profile)Managed Authentication — Browser profiles
Identities (identities[])Managed Authentication
Email OTP, Custom MFA, 1PasswordEmail MFA, Custom MFA, 1Password
Live view / embed (live_view_url)Embedded Browser Live UI

​
Next steps

Create a session

SDK quick start — create, connect with Playwright or Puppeteer, automate.

Async sessions

Non-blocking create and poll until ready.

Batch sessions

Create many sessions in one API call.

Session recordings

Record and replay sessions after they end.