Skip to content
capzy
Login

Capzy Browser API. Connect and automate.

Run browser automation on Capzy infrastructure through Chrome DevTools Protocol. Keep your Playwright or Puppeteer workflow, with remote sessions, optional proxies and persistent profiles.

See the codeOpen dashboard
Your script → Capzy browserCDP / WebSocket
Your applicationchromium.connect_over_cdp(CDP_URL)
Remote browser sessionpage.goto("https://example.com")
Read pages, interact, collect resultspage.title() → "Example Domain"

From a connection URL to your first page

Install a client, copy your CDP URL, and connect. Authentication uses the Browser API username and password in the URL.

  1. Activate a Browser API plan

    Choose a plan with the concurrent sessions, persistent profiles and included bandwidth your workload needs.

    Open Browser API

  2. Copy the connection URL

    In Overview, copy the CDP URL containing your Browser API username and password. Store it as CAPZY_CDP_URL. It is different from a solver API key.

  3. Connect, work, then close

    Use connect_over_cdp or puppeteer.connect. Create a page in the provided context and close the browser in a finally block to release the session.

remote_browser.py
# Install: pip install playwright
import os
from playwright.sync_api import sync_playwright

# Copy your full authenticated URL from Dashboard > Browser API.
# Shape: wss://USERNAME:[email protected]/cdp
with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(os.environ["CAPZY_CDP_URL"])
    try:
        page = browser.contexts[0].new_page()
        page.goto("https://example.com", wait_until="domcontentloaded")
        print(page.title())
    finally:
        browser.close()

Give each workflow the connection it needs

Add query parameters to your authenticated CDP URL. Keep a stable profile name when the same identity should return on the next connection.

username:passwordRequired · URL credentials
Use the complete URL copied from your dashboard. When constructing one yourself, percent-encode reserved characters in the username and password.
profile=my-identityOptional · persistence
Reuse a profile name to retain supported browser state between sessions. Profiles count against your plan's profile allowance.
proxy=capzy-USOptional · US proxy
Choose a supported country with the built-in proxy option. Use proxy=capzy for an automatic location, or proxy=none when you do not need a proxy.
Authenticated CDP connection
wss://USERNAME:[email protected]/cdp?profile=my-identity&proxy=capzy-US
Get the complete connection URL in Dashboard → Browser API → Overview. Keep it private.
Read the full guide

Pricing

Plans separate simultaneous browser sessions, saved profiles and included bandwidth. The custom builder uses current public pricing.

Loading current prices…

Loading current prices…

A few things to know

Browser API or Capium Browser?

Browser API hosts the browser on Capzy infrastructure and exposes CDP. Capium Browser is an SDK that launches a browser on your own machine. Choose Browser API when you want remote capacity.

Why does my CDP connection fail?

Confirm that your plan is active, the username and password match the dashboard, and your application can reach secure WebSockets. An exhausted concurrent-session allowance can also prevent a new connection.

Do I need Selenium?

The examples here use Playwright and Puppeteer. Selenium requires the appropriate CDP connection setup; follow the Browser API connection guide rather than passing a WebSocket URL to webdriver.Remote.

Your next browser can run here.

Choose your capacity, copy the connection URL, and start with the example above.

Open dashboard