Browser Management

The Browser product allows your subusers to access browser automation capabilities. You can manage browser credits, concurrency limits, and session lengths for each subuser through these endpoints.

GET/v2/reseller/sub_users/browser/view_info?username={username}

View browser info

This endpoint allows you to retrieve browser information for a specific subuser, including their API key, available credits, concurrency limit, and maximum session length.

Required query parameters

Name
username
Type
string
Description
The username of the subuser whose browser info you want to retrieve.

Returned Properties

Name
data
Type
object
Description
The browser account data of the subuser.
Name
data.api_key
Type
string
Description
The API key for the browser service.
Name
data.browser_credits
Type
number
Description
The number of browser credits available.
Name
data.concurrency
Type
number
Description
The maximum number of concurrent browser sessions allowed.
Name
data.max_session_length
Type
number
Description
The maximum session length in milliseconds.
Name
data.username
Type
string
Description
The username of the subuser.
Name
message
Type
string
Description
The message of the response.
Name
status
Type
number
Description
The status code of the response.
Name
timestamp
Type
number
Description
The timestamp in milliseconds of the response.

Request

GET

/v2/reseller/sub_users/browser/view_info?username=usertest24

  curl -G 'https://reseller.evomi.com/v2/reseller/sub_users/browser/view_info?username=usertest24' \
  --header 'X-API-KEY: [API KEY]'

Response

{
"status": 200,
"message": "",
"timestamp": 1759320975054,
"data": {
    "api_key": "nDuLpRZBF2sg",
    "browser_credits": 10,
    "concurrency": 20,
    "max_session_length": 60000,
    "username": "usertest24"
}
}

POST/v2/reseller/sub_users/browser/add_credits

Add browser credits

This endpoint allows you to add browser credits to a subuser's account. You can also configure concurrency limits and maximum session length when adding credits.

Required Body "Raw" Items

Name
username
Type
string
Description
The username of the subuser.
Name
credits
Type
number
Description
The number of browser credits to add.
Name
concurrency
Type
number
Description
The maximum number of concurrent browser sessions allowed.
Name
max_session_length
Type
number
Description
The maximum session length in milliseconds.

Returned Properties

Name
data
Type
object
Description
The updated browser account data of the subuser.
Name
data.username
Type
string
Description
The username of the subuser.
Name
data.api_key
Type
string
Description
The API key for the browser service.
Name
data.browser_credits
Type
number
Description
The updated number of browser credits available.
Name
data.concurrency
Type
number
Description
The maximum number of concurrent browser sessions allowed.
Name
data.max_session_length
Type
number
Description
The maximum session length in milliseconds.
Name
message
Type
string
Description
The message of the response.
Name
status
Type
number
Description
The status code of the response.
Name
timestamp
Type
number
Description
The timestamp in milliseconds of the response.

Request

POST

/v2/reseller/sub_users/browser/add_credits

  curl --location 'https://reseller.evomi.com/v2/reseller/sub_users/browser/add_credits' \
    --header 'X-API-KEY: [API KEY]' \
    --header 'Content-Type: application/json' \
    --data '{
        "username": "usertest24",
        "credits": 10,
        "concurrency": 20,
        "max_session_length": 60000
    }'

Response

{
"status": 200,
"message": "",
"timestamp": 1759320505957,
"data": {
    "username": "usertest24",
    "api_key": "nDuLpRZBF2sg",
    "browser_credits": 10,
    "concurrency": 20,
    "max_session_length": 60000
}
}

POST/v2/reseller/sub_users/browser/remove_credits

Remove browser credits

This endpoint allows you to remove browser credits from a subuser's account.

Required Body "Raw" Items

Name
username
Type
string
Description
The username of the subuser.
Name
credits
Type
number
Description
The number of browser credits to remove.

Returned Properties

Name
data
Type
object
Description
The updated browser account data of the subuser.
Name
data.username
Type
string
Description
The username of the subuser.
Name
data.api_key
Type
string
Description
The API key for the browser service.
Name
data.browser_credits
Type
number
Description
The updated number of browser credits available.
Name
data.concurrency
Type
number
Description
The maximum number of concurrent browser sessions allowed.
Name
data.max_session_length
Type
number
Description
The maximum session length in milliseconds.
Name
message
Type
string
Description
The message of the response.
Name
status
Type
number
Description
The status code of the response.
Name
timestamp
Type
number
Description
The timestamp in milliseconds of the response.

Request

POST

/v2/reseller/sub_users/browser/remove_credits

  curl --location 'https://reseller.evomi.com/v2/reseller/sub_users/browser/remove_credits' \
    --header 'X-API-KEY: [API KEY]' \
    --header 'Content-Type: application/json' \
    --data '{
        "username": "usertest24",
        "credits": 1
    }'

Response

{
"data": {
    "username": "usertest24",
    "api_key": "nDuLpRZBF2sg",
    "browser_credits": 9,
    "concurrency": 20,
    "max_session_length": 60000
},
"status": 200,
"message": "",
"timestamp": 1759321017156
}