Browserless · JSON Structure

Browserless Session Structure

The Browserless Session object — a managed remote browser (Chromium / Chrome / Edge / Firefox / WebKit / Stealth) created via /session and driven via WebSocket (Puppeteer, Playwright), BrowserQL, or REST.

Type: object Properties: 11

Browser AutomationBrowser InfrastructureAI AgentsWeb ScrapingBrowserQLPuppeteerPlaywrightSeleniumStealthCAPTCHA SolvingResidential ProxyPDF GenerationScreenshotsSmart ScrapeCrawlSearchMCPSession RecordingHybrid AutomationChrome DevTools Protocol

Session is a JSON Structure definition published by Browserless, describing 11 properties.

Properties

id browserWSEndpoint reconnectUrl liveURL region browser stealth startedAt expiresAt trackingId recordingUrl

Meta-schema:

JSON Structure

{
  "name": "Session",
  "description": "The Browserless Session object — a managed remote browser (Chromium / Chrome / Edge / Firefox / WebKit / Stealth) created via /session and driven via WebSocket (Puppeteer, Playwright), BrowserQL, or REST.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique session identifier.",
      "example": "98e83bbfd396241a6963425b1feeba2f"
    },
    "browserWSEndpoint": {
      "type": "string",
      "description": "WebSocket endpoint used by puppeteer.connect / playwright.connectOverCDP.",
      "example": "wss://production-sfo.browserless.io?token=YOUR_API_TOKEN&trackingId=demo-1"
    },
    "reconnectUrl": {
      "type": "string",
      "description": "Reconnect URL returned by the BQL reconnect mutation.",
      "example": "https://production-sfo.browserless.io/reconnect/98e83bbfd396241a6963425b1feeba2f"
    },
    "liveURL": {
      "type": "string",
      "description": "Embedded live URL for hybrid automation handoff.",
      "example": "https://production-sfo.browserless.io/live/?i=98e83bbfd396241a6963425b1feeba2f"
    },
    "region": {
      "type": "string",
      "description": "Regional production host.",
      "enum": ["production-sfo", "production-lon", "production-ams"],
      "example": "production-sfo"
    },
    "browser": {
      "type": "string",
      "description": "Browser engine backing the session.",
      "enum": ["chromium", "chrome", "edge", "firefox", "webkit", "stealth"],
      "example": "chromium"
    },
    "stealth": {
      "type": "boolean",
      "description": "Whether the stealth profile was applied.",
      "example": false
    },
    "startedAt": {
      "type": "string",
      "format": "date-time",
      "example": "2026-05-25T12:00:00Z"
    },
    "expiresAt": {
      "type": "string",
      "format": "date-time",
      "example": "2026-05-25T12:30:00Z"
    },
    "trackingId": {
      "type": "string",
      "description": "Customer-supplied identifier for billing / reporting allocation.",
      "example": "agent-run-42"
    },
    "recordingUrl": {
      "type": "string",
      "description": "WebM screen recording URL, present when record=true was requested.",
      "example": "https://production-sfo.browserless.io/recording/98e83bbfd396241a6963425b1feeba2f.webm"
    }
  },
  "examples": [
    {
      "id": "98e83bbfd396241a6963425b1feeba2f",
      "browserWSEndpoint": "wss://production-sfo.browserless.io?token=YOUR_API_TOKEN&trackingId=demo-1",
      "reconnectUrl": "https://production-sfo.browserless.io/reconnect/98e83bbfd396241a6963425b1feeba2f",
      "liveURL": "https://production-sfo.browserless.io/live/?i=98e83bbfd396241a6963425b1feeba2f",
      "region": "production-sfo",
      "browser": "chromium",
      "stealth": false,
      "startedAt": "2026-05-25T12:00:00Z",
      "expiresAt": "2026-05-25T12:30:00Z",
      "trackingId": "agent-run-42"
    }
  ]
}

Work with this as data

Every JSON Structure 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 json structure

4 MCP tools reach this

find_json_structuresBrowse and filter every JSON Structure in the catalog.
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 JSON Structure

curl "https://apis.io/api/v1/json-structures/browserless-session-structure"

All json structure

curl "https://apis.io/api/v1/json-structures?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.