Agent Browser
Browser connections, sessions, profiles, and page automation.
When should I choose Agent Browser instead of Crawl?
Use Agent Browser for workflows that need browser interaction and state. Use Crawl when URLs and collection options describe the job. Compare them in Choose the right product.
Can I use Playwright or Puppeteer?
Yes. Agent Browser supports connections from these frameworks. Start with the connection guide and use examples matching your framework and installed version.
Why can my browser not connect?
Check the API key, WebSocket endpoint, and outbound network rules. Confirm that your client is connecting to the documented wss:// endpoint. For a reproducible failure, share a redacted connection configuration and error through Contact Support.
Why does page navigation time out?
A slow page, blocked resource, or unsuitable wait condition can prevent navigation from finishing. Review the navigation timeout and page-loading behavior before increasing it. The page timeout and browser session lifetime are different settings; increasing one does not extend the other.
Why did my session close?
Inspect your cleanup code and configured sessionTTL. A session may have reached its lifetime or been closed by the client. If it closes unexpectedly, record the session identifier, elapsed time, and client error for investigation.
How do I reuse login state?
Use Profiles and the documented persistence settings. Decide whether a session should save changes, and avoid overlapping writes to the same profile when your workflow requires predictable state.
Why is the target website still blocking me?
Access handling does not guarantee that every target request succeeds. Check the target response and configured location, then reproduce with a small workflow. Send the target, session identifier, and redacted diagnostics to support if the failure persists.
Where do browser billing questions belong?
See Subscription & Billing. Include the session identifier and usage period if you need a charge investigated.
Choose another category from the FAQ navigation, or contact support.