Browser sessions last 5 minutes and consume 1 credit ($0.01).

​
Setting up

Get your free API key and start running tasks in minutes.

Get your free API key

Unlock your free welcome credits. No credit card required.

​
What are Sessions?

Sessions allow you to persist cookies and authentication across runs. Once a session is created, it can be utilized for running agent tasks that require user authentication.
  1. Create a Session Open a new session. The system will return a session_id (a unique identifier for your session) and a live_url (an interactive browser window).
  2. Authenticate via the Live URL Use the provided live_url to log in to the target platform (e.g., your project management tool, social media account) as you normally would. This action securely stores your authentication cookies within the session.
  3. Execute Tasks with the Session ID When running an agent task, simply include the session_id. The agent will use the stored authentication from that session, allowing it to immediately access the platform as a logged-in user.

​
Open a browser session using the Python SDK

Open a browser session in 4 lines of code. 
from smooth import SmoothClient

smooth_client = SmoothClient(api_key="cmzr-YOUR_API_KEY")
session = smooth_client.open_session(session_id="my-test-session")

print(f"Live URL: {session.live_url()}")
print(f"Session ID: {session.session_id}")
If Python is not your language of choice, check out our API Reference.

​
Parameters

All parameters available when opening a browser session.
​
session_id
string
The unique identifier for the browser session. If omitted, a random session ID will be generated and returned.This id will be used when running a task.Example: my-test-session

​
Response

Returns a BrowserSessionResponse with the following attributes.
​
session_id
string
The ID of the session.
​
live_url
string
The live url where you can interact with the browser.