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:
- Updating the
{"country":"XX"}field in the API Token tab. - Replacing
country-usin 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:
| Language | Puppeteer | Playwright | Selenium |
|---|---|---|---|
| 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:
await page.screenshot({ path: 'screenshot.png', fullPage: true });
await page.screenshot({ path: 'screenshot.png', fullPage: true });
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:
// 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:
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 Code | Meaning | How to Fix |
|---|---|---|
| 403 | Authentication issue | Check credentials & correct API zone. |
| 407 | Proxy connection failure | Verify proxy settings & remote browser port. |
| 503 | Service unavailable | Try 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.