SessionBox proxy setup

SessionBox proxy fields

1. On My Profiles, click Create profile and fill in URL, Storage type and Name. Under Proxy, click Manage proxies.
2. Click Add proxy, fill in the fields below and click Create.
3. Open the new proxy's ⋮ menu and click Test proxy. Go Back, pick the proxy under Proxy and create the profile.
4. Open the profile from its ⋮ menu with Open in browser, then pick Chrome, Edge or another browser that has the SessionBox extension.

Swap PROXY_USER / PROXY_PASS for the credentials on your dashboard. New here? Create an account to generate a key.

# pip install requests  (SessionBox One running; API key from Issue API key in its settings)
import requests

API = "http://localhost:54789/local-api/v1"
s = requests.Session()
s.headers["Authorization"] = "SESSIONBOX_API_KEY"

team = next(t["teamId"] for t in s.get(f"{API}/teams").json()["teams"] if t["isPrivate"])
proxy = s.post(f"{API}/proxies", json={
    "name": "proxmint-us-01", "type": "http", "ip": "gw.proxmint.com", "port": "823",
    "username": "PROXY_USER__cr.us;sessid.sbx01;sessttl.120", "password": "PROXY_PASS",
    "teamId": team,
}).json()["proxy"]
profile = s.post(f"{API}/profiles", json={
    "name": "us-01", "url": "https://example.com", "storageType": "local",
    "teamId": team, "sbProxyId": proxy["id"],
}).json()["profile"]
token = s.post(f"{API}/action-token", json={
    "action": "open", "profileId": profile["id"], "url": "https://example.com",
}).json()["token"]
print("https://open.sessionbox.dev/?sbo_token=" + token)  # open where the extension is installed

Tips & gotchas

• Keep Type on HTTP, port 823. SessionBox doesn't send a username and password to SOCKS5 proxies (its Local API docs say so), so a SOCKS5 entry only works through IP whitelisting: add the machine's IP under Access on the product's dashboard page, use port 824 and leave Username and Password empty. The product's saved Targeting then applies to every profile on that entry.
• Proxies are entries you pick per profile, so add one entry per profile, each username with its own sessid (sessid.sbx01, sessid.sbx02). Profiles that share an entry share its IP.
• Fingerprint protection, WebRTC protection and Match proxy location and timezone start at Professional. On Hobby, a site that checks WebRTC can still see your own IP behind the proxy, and the time zone stays your computer's.
• A new session can land in a different city of the same country, so add ;city.newyork if a profile must keep one time zone. City targeting meters at 2× on every pool except premium residential.
• The Local API (Professional and up) listens on localhost:54789 and takes the key from Issue API key as the Authorization header. A proxy must belong to the same team as the profile that uses it, which is why the example passes the private team's ID to both.

Steer the exit IP from the username

State, ZIP, ASN and every other key: Targeting & sessions.

What is SessionBox?

SessionBox One turns your everyday browser into many isolated profiles, each with its own cookies, storage and proxy, managed from a desktop app and opened in Chrome, Edge or Firefox through the SessionBox extension. Profiles stay on your machine or sync through the cloud, can be shared one to one or through team spaces, and a Local API drives them from Selenium and other automation. Hobby is $12.99 a month for 1 seat; Professional, $59.99 for 2 seats, adds fingerprint protection, the API and proxy location matching; Teams is $99.99 for 5 seats and unlimited cloud profiles. Billed yearly they are $6.99, $29.99 and $49.99 a month, and a first install includes a one-week free trial.

SessionBox key features

• Profiles in your own browser. Each profile opens in Chrome, Edge or Firefox with its own cookies and storage, so there is no separate browser to learn.
• Per-profile proxies. Proxies are added once under My proxies, tested from the list and picked per profile; Professional adds bulk import and automatic assignment.
• Fingerprint protection. From Professional up, with WebRTC protection and each profile's location and time zone matched to its proxy.
• Local API. Creates proxies and profiles and opens profiles in a browser for Selenium and other automation, from Professional up.
• Sharing and spaces. Share a profile with one person, or keep a team's profiles in shared spaces.
• Cloud and local profiles. Profiles stay on your machine or sync through the cloud: up to 10 cloud profiles on Hobby and Professional, unlimited on Teams.

SessionBox, answered