Browser Infrastructure quickstart

Launch a cloud browser and connect to it from your code.

Every browser includes stealth, proxies, live preview, and recording. Its CDP URL is a WebSocket endpoint for remotely controlling Chrome.

+-------------------+
| Your code         |
+-------------------+
          |
          | CDP URL
          v
+-------------------+
| Cloud browser     |
|                   |
| - Stealth         |
| - Proxy           |
| - Live preview    |
| - Recording       |
+-------------------+
          |
          v
+-------------------+
| Web               |
+-------------------+

Get an API key and export it:

export BROWSER_USE_API_KEY=your_key

Install the SDK

Skip this step if you use curl.

Python

pip install --upgrade browser-use-sdk

Launch a browser

The browser-management resource currently uses the explicit V3 SDK namespace. The equivalent REST endpoint is API V4.

Python

from browser_use_sdk.v3 import BrowserUse

client = BrowserUse()
browser = client.browsers.create(proxy_country_code="us")
print(browser.cdp_url)

# When finished:
client.browsers.stop(browser.id)

browser.close(), disconnecting CDP, or client.close() does not stop the managed browser. Use client.browsers.stop(browser.id) or call PATCH /api/v4/browsers/{id} with {"action":"stop"}.

Connect over CDP

Use the CDP URL with Playwright or Puppeteer.

Browser settings

Configure proxies, screen size, recording, and timeout.