GET
/
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}'}

params = {'page': 1, 'limit': 10}
response = requests.get(f'{BASE_URL}/browser-profiles', headers=HEADERS, params=params)
profiles_data = response.json()
print(profiles_data)


{
  "profiles": [
    {
      "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
    }
  ],
  "total_pages": 1,
  "page": 1,
  "limit": 10,
  "total_count": 1
}
Returns a paginated list of all browser profiles belonging to the user, ordered by creation date. Each profile includes configuration like ad blocker settings, proxy settings, and viewport dimensions.
Pay-as-you-go users can only have one profile. Subscription users can create multiple profiles.

​
Query Parameters

​
page
integer
default:"1"
Page number (minimum: 1)
​
limit
integer
default:"10"
Number of items per page (minimum: 1)

​
Response

​
profiles
array
List of browser profiles
​
profile_id
string
Unique identifier for the 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
​
total_pages
integer
Total number of pages
​
page
integer
Current page number
​
limit
integer
Number of items per page
​
total_count
integer
Total number of 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}'}

params = {'page': 1, 'limit': 10}
response = requests.get(f'{BASE_URL}/browser-profiles', headers=HEADERS, params=params)
profiles_data = response.json()
print(profiles_data)


{
  "profiles": [
    {
      "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
    }
  ],
  "total_pages": 1,
  "page": 1,
  "limit": 10,
  "total_count": 1
}