Documentation

Documentation

Guides, API references, and resources to help you get started with Browser.lol

Quickstart

Launch an isolated browser session in three steps.

  1. 1

    Get an API key

    API access is granted on request. Contact us with a short note about your use case and we will set you up.

  2. 2

    Create a workspace

    Send a POST /v7/vm/create request with the browser you want and, optionally, a URL to load on launch.

  3. 3

    Open the workspace

    Redirect the user to the returned shareUrl, or embed it in an iframe. The session is live within seconds.

Example request:

curl -X POST https://api.browser.lol/v7/vm/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"browser": "chrome", "url": "https://example.com"}'
See the full V7 reference

API V7

Latest

The latest version of the Browser.lol API for creating and managing workspaces.

View Documentation

API V6

Deprecated

The previous version of the Browser.lol API. Kept available for backwards compatibility.

View Documentation

What you can build

Common patterns customers run on Browser.lol today.

Geo-restricted content

Open the same page from any of our supported regions to verify localized pricing, layout, or licensing without a VPN on the user device.

Phishing and link sandboxing

Detonate suspicious URLs from email or chat in an isolated container so customer endpoints never touch the payload.

QA and compatibility testing

Drive Chrome, Firefox, Edge, Brave, Opera, or Tor on demand to reproduce a bug, capture a screenshot, or run a smoke test.

AI agent automation

Hand a fresh, fingerprint-clean browser to your agent for browsing tasks, with per-session credentials and recording.

Customer support sessions

Share a workspace URL with an end user to walk them through a flow, or drop them into a preconfigured environment.

Zero-trust web gateway

Wrap untrusted internal tools or third-party admin panels so the page code never executes on the corporate device.

Frequently asked questions

If your question is not covered here, the contact form below reaches a human.

How does billing work?
Plans bundle a monthly allotment of credits and minute credits. One credit covers a workspace launch; minute credits decrement while the session is running. Concurrency caps how many sessions you can run in parallel. Live counters are returned on every /v7/vm/create response and via /v7/user/quota.
Which browsers can I launch?
Chrome, Edge, Firefox, Brave, Opera, and Tor. Pass the image name in the browser field of /v7/vm/create. Chrome is used if none is specified.
How long does a session stay alive?
Sessions auto-terminate after a period of inactivity and after a hard maximum runtime, both of which depend on your plan. A session ends immediately if the user closes the workspace tab and does not reopen it.
Can I share a workspace with someone else?
Yes. The shareUrl returned by /v7/vm/create is a signed link to one specific workspace. You can hand it to an end user, embed it in an iframe, or redirect to it. Each link maps to one workspace, not a class of workspaces.
Does Browser.lol record what happens inside the browser?
We log workspace metadata for billing and abuse prevention (image, region, timestamps, status). We do not record keystrokes, page contents, or navigation history inside the workspace itself, beyond automated abuse signals. See the privacy policy for the full list.
Can I pin a region or keyboard layout?
Yes. /v7/vm/create accepts country, language, and layout parameters. Country selects the egress region, language sets the browser UI locale, and layout sets the keyboard map for the remote OS.
Do sessions persist state between launches?
No. Each workspace is a fresh, isolated container. Cookies, cache, and downloads are destroyed when the session ends. If you need persistent profiles, contact us about workspace plans.
How do I get notified when a session ends?
Pass a callbackUrl when creating the workspace. We POST to it when the session terminates so you can update your own UI without polling.

Need Help?

If you have questions or need assistance, contact our support team.