POST
/
api
/
v1
/
browser-profiles
import requests

API_KEY = 'your_api_key_here'
BASE_URL = 'https://api.browser-use.com/api/v1'
HEADERS = {'Authorization': f'Bearer {API_KEY}'}

profile_data = {
"profile_name": "Default Profile",
"description": "Main automation profile",
"persist": true,
"ad_blocker": true,
"proxy": true,
"proxy_country_code": "US",
"browser_viewport_width": 1280,
"browser_viewport_height": 960
}

response = requests.post(f'{BASE_URL}/browser-profiles', headers=HEADERS, json=profile_data)
profile = response.json()
print(profile)


{
  "profile_id": "profile_1234567890abcdef",
  "profile_name": "Default Profile",
  "description": "Main automation profile",
  "persist": true,
  "ad_blocker": true,
  "proxy": true,
  "proxy_country_code": "US",
  "browser_viewport_width": 1280,
  "browser_viewport_height": 960
}
Create a new browser profile with custom settings for ad blocking, proxy usage, and viewport dimensions.
Pay-as-you-go users can only have one profile. Subscription users can create multiple profiles.

​
Request Body

​
profile_name
string
required
Name of the browser profile
​
description
string
default:""
Description of the profile
​
persist
boolean
default:"true"
Save cookies, local storage, and session data between tasks
​
ad_blocker
boolean
default:"true"
Block ads and popups during automated tasks
​
proxy
boolean
default:"true"
Route traffic through mobile proxies for better stealth
​
proxy_country_code
string
default:"US"
Country code for the proxy
​
browser_viewport_width
integer
default:"1280"
Browser viewport width in pixels
​
browser_viewport_height
integer
default:"960"
Browser viewport height in pixels

​
Response

​
profile_id
string
Unique identifier for the created browser profile
​
profile_name
string
Name of the browser profile
​
description
string
Description of the profile
​
persist
boolean
Save cookies, local storage, and session data between tasks
​
ad_blocker
boolean
Block ads and popups during automated tasks
​
proxy
boolean
Route traffic through mobile proxies for better stealth
​
proxy_country_code
string
Country code for the proxy
​
browser_viewport_width
integer
Browser viewport width in pixels
​
browser_viewport_height
integer
Browser viewport height in pixels
import requests

API_KEY = 'your_api_key_here'
BASE_URL = 'https://api.browser-use.com/api/v1'
HEADERS = {'Authorization': f'Bearer {API_KEY}'}

profile_data = {
"profile_name": "Default Profile",
"description": "Main automation profile",
"persist": true,
"ad_blocker": true,
"proxy": true,
"proxy_country_code": "US",
"browser_viewport_width": 1280,
"browser_viewport_height": 960
}

response = requests.post(f'{BASE_URL}/browser-profiles', headers=HEADERS, json=profile_data)
profile = response.json()
print(profile)


{
  "profile_id": "profile_1234567890abcdef",
  "profile_name": "Default Profile",
  "description": "Main automation profile",
  "persist": true,
  "ad_blocker": true,
  "proxy": true,
  "proxy_country_code": "US",
  "browser_viewport_width": 1280,
  "browser_viewport_height": 960
}