Browser.ai Documentation home pagelight logodark logo
Welcome
  • Introduction
  • Getting Started
  • Need help?
  • Errors Troubleshooting
API
  • Task API Token
  • Geolocation
  • Crawler Automation
  • Script Automation
Headless Browser
  • Captcha Handler
  • Geolocation
  • Configuration
  • CDP Functions
  • Code Snippets
  • Support
  • Dashboard
Browser.ai Documentation home pagelight logodark logo
  • Support
  • Dashboard
  • Dashboard
Documentation
API Reference
Documentation
API Reference
Welcome

BrowserAI FAQ

Whether you’re just getting started with BrowserAI or diving into advanced features, this FAQ covers everything from session handling and country targeting to performance tips, error codes, pricing, and more. Explore solutions, best practices, and helpful insights to make the most of your BrowserAI experience.

Nope! BrowserAI is designed for single-page navigation per session.

What this means:

  • You can navigate within a page (clicks, scrolling, interactions).
  • But you can’t load a second domain within the same session.

Solution? If you need to load multiple pages, spawn a new session for each URL.

  • Idle sessions (no interaction) auto-close after 5 minutes.
  • Max session duration: 30 minutes. After that, your session will time out.

The Change Location feature lets you adjust your BrowserAI’s geographic location for accurate geo-targeted scraping and content testing. You can change the location by:

  1. Updating the {"country":"XX"} field in the API Token tab.
  2. Replacing country-us in the Headless Browser tab with your desired country code.

Want all of Europe?
Use -country-eu to dynamically select an EU-based IP.

Heads-up: For bot-heavy websites, manually selecting a country may actually decrease success rates. Let BrowserAI handle it automatically when possible!

BrowserAI is battle-tested for web automation and supports:

  • Puppeteer (Node.js).
  • Playwright (Node.js, Python, C#).
  • Selenium (Java, Python, C#, Node.js, Go, Ruby).

Supported environments:

LanguagePuppeteerPlaywrightSelenium
Node.js✅ Native✅ Native✅ WebDriverJS
Python❌✅ Native✅ WebDriver
Java✅ Puppeteer-Java✅ Playwright-Java✅ Native
C#✅ PuppeteerSharp✅ Playwright-.NET✅ WebDriver
Go❌✅ Playwright-Go✅ WebDriver-Go
Ruby✅ Puppeteer-Ruby✅ Playwright-Ruby✅ WebDriver-Ruby

Need visual proof of what’s happening in your session? Capture a screenshot at any time:

Puppeteer
Copy
Ask AI
await page.screenshot({ path: 'screenshot.png', fullPage: true });
Puppeteer
Copy
Ask AI
await page.screenshot({ path: 'screenshot.png', fullPage: true });
Playwright
Copy
Ask AI
await page.screenshot(path='screenshot.png', full_page=True)

Some websites have complex anti-bot measures, which require extra processing to bypass protections.

To ensure smooth navigation, increase the timeout threshold:

Copy
Ask AI
// Navigate to site with 2 min timeout  
page.goto('<https://example.com>', { timeout: 2*60*1000 });  

Always set a higher timeout**(2+ minutes)** for bot-protected websites.

If you’re getting connection issues, run the following cURL test:

Copy
Ask AI
curl -v -u USER:PASS https://brd.superproxy.io:9222/json/protocol

If you get JSON in response: ✅ You’re successfully connected.
If no JSON appears: ❌ Check your credentials & network settings.

Error CodeMeaningHow to Fix
403Authentication issueCheck credentials & correct API zone.
407Proxy connection failureVerify proxy settings & remote browser port.
503Service unavailableTry again in 1-2 minutes.

Simple: You pay per GB of data transferred.

  • No per-instance fees
  • No hourly costs
  • No extra charges for specific countries

However, certain Premium Domains may have additional costs due to extra unblocking measures.

Previous
Errors TroubleshootingExplore the catalog of Browser.AI HTTP errors, including error codes and descriptions.
Next
Powered by Mintlify
Assistant
Responses are generated using AI and may contain mistakes.