Profiles

Create and configure browser profiles — OS target, browser version, proxy and storage.

A profile is a saved browser identity. Each profile has its own fingerprint, proxy, cookies and storage, fully isolated from every other profile.

Anatomy of a profile

Create requests use the ProfileSpec shape (name required on create):

Prop

Type

Creating a profile

Pick an OS target

Choose win, mac, or linux. The OS target drives the user-agent, platform, fonts and device metrics. Keep it stable for the lifetime of the identity.

Set a browser version

browserVersion is a required integer major (for example 131). It selects which browser build the worker launches for this profile.

Assign a proxy (optional)

Attach an HTTP, HTTPS, SOCKS5 or SOCKS5H proxy on create or update.

Isolation guarantees

Cookies, localStorage, IndexedDB and cache are per-profile.
No shared browser state leaks between profiles.
Deleting a profile removes its storage.

Next steps

Launching — open or start a profile.
Proxies — network routing.