Skip to content
Hoody Documentation
Download Page (.md)

Chrome-as-a-service. Hoody Browser gives you HTTP control over Chromium instances—start browsers, navigate pages, evaluate JavaScript, manage tabs, and capture DevTools URLs. Perfect for web scraping, automated testing, screenshot services, and AI-driven web interaction.

What You Can Do

Section titled “What You Can Do”
  • Instance Management - Start, stop, restart isolated browser instances
  • Page Navigation - Browse URLs and get page content
  • JavaScript Execution - Evaluate JS in browser context via HTTP
  • Tab Management - List and manage browser tabs
  • DevTools Access - Get WebSocket URL for Chrome DevTools Protocol
  • Fingerprinting - Configure user agent, viewport, geolocation, locale
  • Health Monitoring - Track server metrics and instance health
  • Multiple Instances - Run concurrent browsers on different ports

API Endpoints Summary

Section titled “API Endpoints Summary”

All endpoints accessed relative to your Browser service URL:

https://PROJECT_ID-CONTAINER_ID-browser-1.SERVER.containers.hoody.icu

Instance Management:

Browser Interaction:

Page Content & Export:

Cookies:

Introspection & Control:

Logs & History:

Health & Metrics:

Quick Start

Section titled “Quick Start”
Terminal window
# Start a browser instance
hoody browser start -c <container-id> --browser-id "main"


# Navigate to a URL
hoody browser navigate-post -c <container-id> --browser-id "main" --url "https://example.com"


# Execute JavaScript
hoody browser eval-post -c <container-id> --browser-id "main" --script "document.title"


# Take a screenshot
hoody browser screenshot -c <container-id> --browser-id "main"


# List open tabs
hoody browser tabs list -c <container-id> --browser-id "main"

1. Start a browser instance:

GET Start a new browser instance
/start
Click "Run" to execute the request

Returns instance metadata including the webSocketDebuggerUrl for Chrome DevTools Protocol access.

2. Navigate to a page:

GET Browse to a URL and get page content
/browse?url=https://example.com
Click "Run" to execute the request

3. Execute JavaScript on the page:

GET Evaluate JavaScript in the browser context
/eval?script=document.title
Click "Run" to execute the request

4. List open tabs:

GET List all browser tabs
/tabs
Click "Run" to execute the request

Browser Configuration

Section titled “Browser Configuration”

Fingerprint Profiles

Section titled “Fingerprint Profiles”

Configure browser identity for web scraping or testing:

GET Start browser with fingerprint profile and DevTools access
/start?fingerprintId=default&useRemoteDebuggingPort=true
Click "Run" to execute the request

Available configuration:

  • User Agent - Custom browser identification string
  • Viewport - Screen size and device pixel ratio
  • Geolocation - Latitude/longitude spoofing
  • Locale & Timezone - Language and time settings
  • Chromium Version - Select specific Chrome version (stable, beta, dev, canary, or exact version)

Multiple Instances

Section titled “Multiple Instances”

Run concurrent browser instances using different browser_id values:

Terminal window
# Start first instance
curl "https://PROJECT_ID-CONTAINER_ID-browser-1.SERVER.containers.hoody.icu/start?browser_id=scraper"


# Start second instance
curl "https://PROJECT_ID-CONTAINER_ID-browser-1.SERVER.containers.hoody.icu/start?browser_id=testing"


# Each instance is addressed by its browser_id
curl "https://PROJECT_ID-CONTAINER_ID-browser-1.SERVER.containers.hoody.icu/browse?browser_id=scraper&url=https://example.com"
curl "https://PROJECT_ID-CONTAINER_ID-browser-1.SERVER.containers.hoody.icu/browse?browser_id=testing&url=https://example.org"

Each instance is isolated with its own tabs, cookies, and state.

Chrome DevTools Protocol

Section titled “Chrome DevTools Protocol”

Get the WebSocket URL for direct CDP access:

GET Get Chrome DevTools Protocol WebSocket URL
/devtools-url
Click "Run" to execute the request

Use the returned URL with Puppeteer, Playwright, or any CDP client:

const puppeteer = require('puppeteer-core');


// Connect to Hoody Browser instance
const browser = await puppeteer.connect({
  browserWSEndpoint: 'ws://...'  // URL from /devtools-url
});


const page = await browser.newPage();
await page.goto('https://example.com');
await page.screenshot({ path: 'screenshot.png' });

Use Cases

Section titled “Use Cases”
  • Web Scraping - Extract data from websites via HTTP API
  • Automated Testing - Run E2E tests against web applications
  • Screenshot Services - Capture webpage screenshots on demand
  • AI Web Interaction - Let AI agents browse and interact with web pages
  • PDF Generation - Render HTML to PDF via Chrome’s print functionality
  • Performance Monitoring - Audit web performance metrics

What’s Next

Section titled “What’s Next”