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)

​
Connect with Puppeteer

import puppeteer from "puppeteer-core";
import { BrowserUse } from "browser-use-sdk";

const client = new BrowserUse();
const browser = await client.browsers.create();

const pw = await puppeteer.connect({ browserWSEndpoint: browser.cdpUrl });
const [page] = await pw.pages();
await page.goto("https://example.com");
console.log(await page.title());
await pw.close();

await client.browsers.stop(browser.id);

​
Connect with Selenium

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
from browser_use_sdk import AsyncBrowserUse

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

options = Options()
options.debugger_address = browser.cdp_url.replace("ws://", "").replace("/devtools/browser/", "")
driver = webdriver.Chrome(options=options)
driver.get("https://example.com")
print(driver.title)
driver.quit()

await client.browsers.stop(browser.id)

​
Manage sessions

from browser_use_sdk import AsyncBrowserUse

client = AsyncBrowserUse()

# List active sessions
sessions = await client.browsers.list()

# Get a specific session
session = await client.browsers.get(browser_id)

# Stop a session
await client.browsers.stop(browser_id)
Always stop browser sessions when done. Sessions left running will continue to incur charges until the timeout expires.

​
Parameters

ParameterTypeDescription
profile_idstrLoad a saved browser profile (cookies, localStorage).
proxy_country_codestrProxy country code (e.g. us, de, jp). 195+ countries.
timeoutintSession timeout in minutes. Max: 240 (4 hours).
browser_screen_widthintBrowser width in pixels.
browser_screen_heightintBrowser height in pixels.
custom_proxyCustomProxyBring your own proxy (HTTP or SOCKS5). See Proxies.
See Models & Pricing for browser session and proxy costs.