Profiles

A profile persists cookies, local storage, and login state across browsers. Log in once, save the profile, then reuse it to start future browsers already logged in.

Create or select one under Dashboard → Profiles, then pass its ID in V4 browser settings:

from browser_use_sdk.v4 import BrowserUse

client = BrowserUse()
run = client.runs.create(
    "Open my account dashboard and summarize it",
    browser_settings={"profileId": "YOUR_PROFILE_ID"},
)
result = client.runs.wait_for_completion(run.id)
print(result.result)

import { BrowserUse } from "browser-use-sdk/v4";

const client = new BrowserUse();
const run = await client.runs.create({
  task: "Open my account dashboard and summarize it",
  model: "gpt-5.6-luna",
  modelParams: { reasoning: { effort: "xhigh" } },
  browserSettings: {
    profileId: "YOUR_PROFILE_ID",
    proxyCountryCode: "us",
  },
});
const result = await client.runs.waitForCompletion(run.id);
console.log(result.result);

curl https://api.browser-use.com/api/v4/runs \
  -H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task":"Summarize my account dashboard",
       "browserSettings":{"profileId":"YOUR_PROFILE_ID"}}'

Use one profile per end user. A follow-up in the same session reuses the live browser if it arrives within about 2 minutes of the previous run, or within the run’s keepAlive seconds. Otherwise, and in later sessions, a fresh browser loads the same profile. For the fastest setup, sync an existing local login.

⌘I

Get Started

Pillars

More