Skip to main content

BrowserQL

BrowserQL (BQL) is a GraphQL API for browser automation with built-in stealth capabilities. Execute declarative mutations against managed browsers to navigate, interact with pages, extract data, and bypass bot detection—all through a simple query language.

When to Use BrowserQL

Use BrowserQL when you need to:

  • Bypass sophisticated bot detection systems
  • Solve CAPTCHAs automatically
  • Mimic human-like browser behavior
  • Build stealth-first automation at scale

How It Works

BrowserQL executes GraphQL mutations against managed browsers and returns structured results. You can run queries through the web IDE or programmatically via HTTP. The API handles browser lifecycle, stealth configuration, and can hand off sessions to Puppeteer or Playwright via the reconnect mutation.

Key Capabilities

  • Navigation: Navigate to URLs with configurable wait conditions
  • Interaction: Click, type, scroll, and perform human-like actions
  • Data Extraction: Extract text, attributes, and structured data
  • Media Capture: Take screenshots and generate PDFs
  • CAPTCHA Solving: Automatically solve and verify CAPTCHAs
  • Fingerprinting: Stealthy methods and humanlike features to evade detection
  • Session Handoff: Connect Puppeteer or Playwright via reconnect mutation

Authentication

BrowserQL requests require an API token passed as a query parameter. Get started with the Quick Start guide to set up your first query.

Hybrid Automation

You can combine BrowserQL with Puppeteer or Playwright. Use BQL for stealth operations, then connect your existing scripts via the reconnect mutation. Learn more in Session Management.

Next Steps