Profiles

Reuse cookies and browser state in API V4 runs.

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:

Python

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: "grok-4.5",
  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. Follow-ups in the same session reuse the live browser; later sessions can load the same profile again.

For the fastest setup, sync an existing local login.