Skip to main content
Browser profiles allow you to persist cookies and authentication across sessions. Log in once, then reuse that authentication for future tasks.

​
How It Works

  1. Create a Profile - Call client.create_profile(profile_id="my-profile") to create a new profile.
  2. Authenticate - Open a session with the profile and navigate to live_url() to log in manually. Your cookies are saved to the profile.
  3. Reuse - In future sessions, pass the same profile_id. The agent uses the stored cookies automatically.

​
Example

Python
from smooth import SmoothClient

client = SmoothClient()

# First run: create profile and authenticate
client.create_profile(profile_id="my-account")

with client.session(profile_id="my-account", url="https://example.com") as session:
    print(f"Log in here: {session.live_url()}")
    input("Press Enter after logging in...")

# Future runs: authentication is already saved
with client.session(profile_id="my-account", url="https://example.com") as session:
    session.run_task("Do something that requires login")

​
Learn More

Profile API Reference

Create, list, and delete profiles

Scrape Behind Login Walls

Step-by-step guide for authenticated scraping