Note: These docs cover v1 of Browserless, which is used on our shared cloud. For our v2 docs, pleaseclick here

/sessions API

The sessions API allows you to gather information about the currently running sessions and is only available for dedicated and self-hosted accounts

Check out this API schema defined in Swagger.

Gathering information from your running sessions

To see information regarding the running sessions, simply issue a GET request to /sessions:

curl -X GET \
  https://chrome.browserless.io/sessions?token=MY_API_TOKEN

Remember that running this in the browser will expose your API key!

Running this cURL request will result in an output like:

[
  {
    "description": "",
    "devtoolsFrontendUrl": "/devtools/inspector.html?ws=0.0.0.0:3000/devtools/page/7B491986CD0B6408DF15A339A7621226",
    "id": "7B491986CD0B6408DF15A339A7621226",
    "title": "Example Domain",
    "type": "page",
    "url": "https://www.example.com",
    "webSocketDebuggerUrl": "ws://0.0.0.0:3000/devtools/page/7B491986CD0B6408DF15A339A7621226",
    "port": "41685",
    "browserId": "b95cd82a-76b1-495e-8092-b040de780d0f",
    "trackingId": null,
    "browserWSEndpoint": "ws://0.0.0.0:3000/devtools/browser/b95cd82a-76b1-495e-8092-b040de780d0f"
  }
]

Ready to try benefits of Browserless?