Skip to main content
The Browser API gives you a raw Chrome DevTools Protocol (CDP) connection to Browser Use’s stealth infrastructure. No agent — you write the automation code, we provide the undetectable browser with proxies and CAPTCHA handling.

Create a browser session

from browser_use_sdk import AsyncBrowserUse

client = AsyncBrowserUse()
browser = await client.browsers.create(proxy_country_code="us")
print(browser.cdp_url)   # ws://...
print(browser.live_url)  # debug view

Connect with Playwright

from playwright.async_api import async_playwright
from browser_use_sdk import AsyncBrowserUse

client = AsyncBrowserUse()
browser = await client.browsers.create()

async with async_playwright() as p:
    b = await p.chromium.connect_over_cdp(browser.cdp_url)
    page = b.contexts[0].pages[0]
    await page.goto("https://example.com")
    print(await page.title())
    await b.close()

await client.browsers.stop(browser.id)
You can also connect with Puppeteer (browserWSEndpoint) or Selenium (debugger_address). The CDP URL works with any compatible library.

Parameters

ParameterTypeDescription
profile_idstrLoad a saved browser profile.
proxy_country_codestrProxy country code.
timeoutintSession timeout. Max: 4 hours.
browser_screen_widthintWidth in pixels.
browser_screen_heightintHeight in pixels.
custom_proxyCustomProxyCustom proxy config.

Pricing

0.06/hour(Business/Scaleup:0.06/hour (Business/Scaleup: 0.03/hour). Min charge: 1 minute. Max timeout: 4 hours.