Browserless

Browserless BQL Execution API

Run BrowserQL (BQL) queries over REST, or connect over WebSocket for a persistent BQL session. `/chromium/bql` runs standard BQL; `/stealth/bql` adds fingerprint randomization for bot-detection-sensitive automation.

GitHub OpenAPI

Operations 4

POST /chromium/bql?(/*) /chromium/bql?(/*) #
GET /chromium/bql?(/*) /chromium/bql?(/*) #
POST /stealth/bql?(/*) /stealth/bql?(/*) #
GET /stealth/bql?(/*) /stealth/bql?(/*) #

Documentation

📖
Documentation
https://docs.browserless.io
📖
APIReference
https://docs.browserless.io/open-api
📖
GettingStarted
https://docs.browserless.io/overview/quick-start
📖
RateLimits
https://artifacts.apis.io/browserless/rate-limits/browserless-rate-limits.yml

Specifications

⚙
OpenAPI
https://artifacts.apis.io/browserless/openapi/browserless-bql-execution-api-openapi.yml

SDKs

📦
GitHubRepository
https://github.com/browserless/browserless
📦
GitHubRepository
https://github.com/browserless/browserless-mcp
📦
GitHubRepository
https://github.com/browserless/claude-plugin
📦
GitHubRepository
https://github.com/browserless/gemini-extension
📦
GitHubRepository
https://github.com/browserless/n8n-nodes-browserless-api
📦
GitHubRepository
https://github.com/browserless/dify-plugin
📦
GitHubRepository
https://github.com/browserless/cursor-mcp-plugin
📦
GitHubRepository
https://github.com/browserless/browserless-langchain
📦
GitHubRepository
https://github.com/browserless/browserless-llamaindex
📦
GitHubRepository
https://github.com/browserless/browserless-agno
📦
GitHubRepository
https://github.com/browserless/bolt-diy-browserless-mcp-starter

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/browserless/json-schema/browserless-session-schema.json
📊
JSONStructure
https://artifacts.apis.io/browserless/json-structure/browserless-session-structure.json

Other Resources

🔗
Signup
https://account.browserless.io/signup
🔗
SDKs
https://github.com/puppeteer/puppeteer
🔗
SDKs
https://github.com/microsoft/playwright
🔗
SDKs
https://github.com/SeleniumHQ/selenium
🔗
JSONLD
https://artifacts.apis.io/browserless/json-ld/browserless-context.jsonld
🔗
Examples
https://artifacts.apis.io/browserless/examples/browserless-screenshot-example.json
🔗
Plans
https://artifacts.apis.io/browserless/plans/browserless-plans-pricing.yml
🔗
FinOps
https://artifacts.apis.io/browserless/finops/browserless-finops.yml
🔗
Vocabulary
https://artifacts.apis.io/browserless/vocabulary/browserless-vocabulary.yml
🔗
Rules
https://artifacts.apis.io/browserless/rules/browserless-rules.yml
🔗
ChangeLog
https://www.browserless.io/changelog
🔗
StatusPage
https://status.browserless.io
🔗
Pricing
https://www.browserless.io/pricing
🔗
Enterprise
https://www.browserless.io/enterprise

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/browserless:browserless-bql-execution-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

browserless-bql-execution-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Browserless BQL Execution API
  version: 2.57.0
  description: 'This is the API reference for **Browserless Enterprise and Cloud** deployments. You''ll find endpoints for capturing screenshots and PDFs, scraping content, running custom browser functions, solving CAPTCHAs, bypassing bot detection with stealth browsing, managing authenticated browser profiles, and orchestrating crawls.


    The API includes REST endpoints (JSON in, JSON or binary out), WebSocket connections for direct CDP/Playwright/Puppeteer access, and CDP extensions that expose Browserless-specific commands like `liveURL`, `solveCaptcha`, and `reconnect`. For the open-source container API, see the GitHub repository.


    ## Just Getting Started?


    Check out the Quick Start guide to launch your first session, or explore the BrowserQL IDE for a GraphQL-based automation workflow.


    ## Base URL


    All API requests go to your deployment''s base URL. For Browserless Cloud:


    ```plaintext

    https://production-sfo.browserless.io

    ```


    Self-hosted Enterprise deployments use the host and port where the container is running (default `http://localhost:3000`).


    ## Authentication


    Include your API token as a query parameter on every request:


    ```plaintext

    https://production-sfo.browserless.io/chromium/content?token=YOUR_API_TOKEN

    ```


    Tokens are managed from the Account dashboard. Self-hosted deployments set the token via the `TOKEN` environment variable. See connection details for all authentication options.


    ## Changelog


    For release notes and version history, see the Enterprise Changelog.


    ## Software keys


    Self-hosted Enterprise deployments use time-limited software keys for offline licensing. No external connections or callbacks are required. Keys are cryptographically secure and can''t be reverse engineered. When a key expires, the container exits with a semantic error code.


    To use a software key, set the `KEY` environment variable when running the container:


    ```bash

    docker run -e KEY=your-generated-key browserless/enterprise

    ```'
servers:
- url: https://production-sfo.browserless.io
security:
- tokenAuth: []
tags:


# --- truncated at 32 KB (45 KB total) ---
# Full source: https://artifacts.apis.io/browserless/openapi/browserless-bql-execution-api-openapi.yml