LogoLogo
SupportDashboard
  • Community
  • Welcome to Hyperbrowser
  • Get Started
    • Quickstart
      • AI Agents
        • Browser Use
        • Claude Computer Use
        • OpenAI CUA
      • Web Scraping
        • Scrape
        • Crawl
        • Extract
      • Browser Automation
        • Puppeteer
        • Playwright
        • Selenium
  • Agents
    • Browser Use
    • Claude Computer Use
    • OpenAI CUA
  • HyperAgent
    • About HyperAgent
      • HyperAgent SDK
      • HyperAgent Types
  • Quickstart
  • Multi-Page actions
  • Custom Actions
  • MCP Support
    • Tutorial
  • Examples
    • Custom Actions
    • LLM support
    • Cloud Support
      • Setting Up
      • Proxies
      • Profiles
    • MCP Examples
      • Google Sheets
      • Weather
        • Weather Server
    • Output to Schema
  • Web Scraping
    • Scrape
    • Crawl
    • Extract
  • Sessions
    • Overview
      • Session Parameters
    • Advanced Privacy & Anti-Detection
      • Stealth Mode
      • Proxies
      • Static IPs
      • CAPTCHA Solving
      • Ad Blocking
    • Profiles
    • Recordings
    • Live View
    • Extensions
    • Downloads
  • Guides
    • Model Context Protocol
    • Scraping
    • AI Function Calling
    • Extract Information with an LLM
    • Using Hyperbrowser Session
    • CAPTCHA Solving
  • Integrations
    • ⛓️LangChain
    • 🦙LlamaIndex
  • reference
    • Pricing
    • SDKs
      • Node
        • Sessions
        • Profiles
        • Scrape
        • Crawl
        • Extensions
      • Python
        • Sessions
        • Profiles
        • Scrape
        • Crawl
        • Extensions
    • API Reference
      • Sessions
      • Scrape
      • Crawl
      • Extract
      • Agents
        • Browser Use
        • Claude Computer Use
        • OpenAI CUA
      • Profiles
      • Extensions
Powered by GitBook
On this page
Export as PDF
  1. reference
  2. API Reference

Sessions

PreviousAPI ReferenceNextScrape

Last updated 1 month ago

Stop a session

put
Authorizations
Path parameters
idstringRequired
Responses
200
Session stopped successfully
application/json
404
Session not found
application/json
500
Server error
application/json
put
PUT /api/session/{id}/stop HTTP/1.1
Host: api.hyperbrowser.ai
x-api-key: YOUR_API_KEY
Accept: */*
{
  "success": true
}

Get list of sessions

get
Authorizations
Query parameters
pagenumberOptionalDefault: 1
statusstring · enumOptionalPossible values:
Responses
200
List of sessions
application/json
400
Invalid query parameters
application/json
500
Server error
application/json
get
GET /api/sessions HTTP/1.1
Host: api.hyperbrowser.ai
x-api-key: YOUR_API_KEY
Accept: */*
{
  "sessions": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "teamId": "123e4567-e89b-12d3-a456-426614174000",
      "status": "active",
      "startTime": "text",
      "endTime": "text",
      "createdAt": "text",
      "updatedAt": "text"
    }
  ],
  "totalCount": 100,
  "page": 1,
  "pageSize": 10
}
  • POSTCreate new session
  • GETGet session by ID
  • PUTStop a session
  • GETGet list of sessions

Get session by ID

get
Authorizations
Path parameters
idstringRequired
Responses
200
Session details
application/json
Responseall of
404
Session not found
application/json
get
GET /api/session/{id} HTTP/1.1
Host: api.hyperbrowser.ai
x-api-key: YOUR_API_KEY
Accept: */*
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "teamId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "active",
  "startTime": "text",
  "endTime": "text",
  "createdAt": "text",
  "updatedAt": "text",
  "sessionUrl": "text",
  "liveUrl": "text",
  "token": "text",
  "wsEndpoint": "text"
}

Create new session

post
Authorizations
Body
useStealthbooleanOptionalDefault: false
useProxybooleanOptionalDefault: false
proxyServerstringOptional
proxyServerPasswordstringOptional
proxyServerUsernamestringOptional
proxyCountrystring · enumOptionalPossible values:
proxyStatestring · enum | nullableOptional

Optional state code for proxies to US states. Is mutually exclusive with proxyCity. Takes in two letter state code.

Possible values:
proxyCitystring | nullableOptional

Desired Country. Is mutually exclusive with proxyState. Some cities might not be supported, so before using a new city, we recommend trying it out

Example: new york
solveCaptchasbooleanOptionalDefault: false
adblockbooleanOptionalDefault: false
trackersbooleanOptionalDefault: false
annoyancesbooleanOptionalDefault: false
enableWebRecordingbooleanOptional
enableVideoWebRecordingbooleanOptional

enableWebRecording must also be true for this to work

Default: false
acceptCookiesbooleanOptional
extensionIdsstring · uuid[]OptionalDefault: []
urlBlockliststring[]OptionalDefault: []
browserArgsstring[]OptionalDefault: []
timeoutMinutesnumber · min: 1 · max: 720Optional
Responses
200
Session created
application/json
Responseall of
post
POST /api/session HTTP/1.1
Host: api.hyperbrowser.ai
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 697

{
  "useStealth": false,
  "useProxy": false,
  "proxyServer": "text",
  "proxyServerPassword": "text",
  "proxyServerUsername": "text",
  "proxyCountry": "AD",
  "proxyState": "AL",
  "proxyCity": "new york",
  "operatingSystems": [
    "windows"
  ],
  "device": [
    "desktop"
  ],
  "platform": [
    "chrome"
  ],
  "locales": [
    "aa"
  ],
  "screen": {
    "width": 1280,
    "height": 720
  },
  "solveCaptchas": false,
  "adblock": false,
  "trackers": false,
  "annoyances": false,
  "enableWebRecording": true,
  "enableVideoWebRecording": false,
  "profile": {
    "id": "text",
    "persistChanges": true
  },
  "acceptCookies": true,
  "extensionIds": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "urlBlocklist": [
    "text"
  ],
  "browserArgs": [
    "text"
  ],
  "imageCaptchaParams": [
    {
      "imageSelector": "text",
      "inputSelector": "text"
    }
  ],
  "timeoutMinutes": 1
}
200

Session created

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "teamId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "active",
  "startTime": "text",
  "endTime": "text",
  "createdAt": "text",
  "updatedAt": "text",
  "sessionUrl": "text",
  "liveUrl": "text",
  "token": "text",
  "wsEndpoint": "text"
}