List Browser Profiles

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.

Query parameters

pageintegerOptional>=1Defaults to 1

limitintegerOptional>=1Defaults to 10

Response

Successful Response

profileslist of objects

total_pagesinteger

pageinteger

limitinteger

total_countinteger

1	{
2	"profiles": [
3	{
4	"profile_id": "string",
5	"profile_name": "string",
6	"description": "string",
7	"persist": true,
8	"ad_blocker": true,
9	"proxy": true,
10	"proxy_country_code": "us",
11	"browser_viewport_width": 1,
12	"browser_viewport_height": 1,
13	"store_cache": true,
14	"is_mobile": true
15	}
16	],
17	"total_pages": 1,
18	"page": 1,
19	"limit": 1,
20	"total_count": 1
21	}

Headers

Query parameters

Response

Errors

1	curl https://api.browser-use.com/api/v1/browser-profiles \
2	-H "Authorization: Bearer <token>"