Browser Use SDKs

BrowserReal’s API is Browser Use Cloud’s v4 API for browsers: the same paths, bodies and answers (camelCase, ISO times, money as decimal strings, FastAPI’s { "detail": … } errors, 201 on create). Browser Use’s SDKs therefore work unchanged. Tested with browser-use-sdk 3.12.1 for Python.

Switching

from browser_use_sdk.v4 import BrowserUse

client = BrowserUse(
    api_key="sk_...",                            # a Datum secret key
    base_url="https://api.datum.org/api/v4",
)
browser = client.browsers.create(profile_id="…", timeout=30)

Everything else stays as it is: browsers.create, browsers.get, browsers.list, browsers.stop, and the profiles, network policies and extensions resources. Datum takes Browser Use’s header, X-Browser-Use-API-Key, and also Authorization: Bearer sk_….

What is the same

• Browsers: create with every Browser Use option, list with filterBy and metadata, get one, stop it, read its downloads, change its proxy while it runs.
• Profiles, network policies and extensions, with Browser Use’s validation rules and limits.
• Recordings: enableRecording, then recordingUrl on the browser once it stops.

What is different

	Browser Use Cloud	BrowserReal
Proxy when proxyCountryCode is omitted	A residential address in the US	None: the machine’s own address, unless the profile has a proxy. Ask for a country to get one.
Price	$0.02 a browser hour, $5 a proxy GB	$0.012 a browser hour, $3 a proxy GB (40% less)
Stop while another client is connected	Stops	Answers stopRefused and keeps it running, so one agent cannot pull the browser from under another. "force": true stops it regardless.
Agents, tasks, workspaces	Yes	Not part of BrowserReal: bring your own agent, Browser Use’s open-source one included. agentSessionId lists nothing.

BrowserReal’s own additions

Browser Use’s SDKs ignore fields they do not know, so these are safe to use alongside them:

• proxySticky: false on a create, or sticky on a proxy change: a new residential address for every connection.
• force: true on a stop.
• Profile settings: a screen size, locale, time zone and proxy that every session of the profile uses.
• POST /profiles/{id}/import: bring a Chrome profile folder or a Playwright storage state.
• On a browser: profileId, proxySticky, finishReason and error.

Not available yet

• A custom proxy’s caBundle, caBundleUrl and ignoreCertErrors (answered 422).
• reCAPTCHA and hCaptcha solving (Turnstile is solved).
• Uploading a file into a running browser.