Node.js and Python SDKs

npm install browsefleet

import { BrowseFleet } from 'browsefleet';

const bf = new BrowseFleet({
  apiKey: 'bf_your_api_key',            // Required
  baseUrl: 'https://api.browsefleet.com', // Optional (default)
  timeout: 60000,                        // Optional, ms (default: 60000)
});

import { BrowseFleet, AuthError, NotFoundError, RateLimitError, BrowseFleetError } from 'browsefleet';

try {
  const session = await bf.sessions.get('invalid-id');
} catch (err) {
  if (err instanceof AuthError) {
    console.error('Invalid API key');
  } else if (err instanceof NotFoundError) {
    console.error('Session not found');
  } else if (err instanceof RateLimitError) {
    console.error('Rate limited — retry later');
  } else if (err instanceof BrowseFleetError) {
    console.error(`API error ${err.status}: ${err.message}`);
  }
}

pip install browsefleet

from browsefleet import BrowseFleet

bf = BrowseFleet(
    api_key="bf_your_api_key",
    base_url="https://api.browsefleet.com",  # Required
    timeout=60.0,                             # Optional, seconds (default: 60)
)

# Supports context manager
with BrowseFleet(api_key="bf_...", base_url="https://api.browsefleet.com") as bf:
    session = bf.sessions.create(stealth="full")
    # bf.close() called automatically

from browsefleet.errors import (
    BrowseFleetError,
    AuthError,
    NotFoundError,
    RateLimitError,
    ValidationError,
    ServerError,
)

try:
    session = bf.sessions.get("invalid-id")
except AuthError:
    print("Invalid API key")
except NotFoundError:
    print("Session not found")
except RateLimitError:
    print("Rate limited")
except BrowseFleetError as e:
    print(f"API error {e.status}: {e.message}")