oxylabs-headless-browser

Oxylabs Headless Browser

Remote headless browser service with built-in anti-detection and proxy integration. Supports Playwright, Puppeteer, and any CDP-compatible library.

Connection URL

wss://USERNAME:[email protected]

Browser Types

Type	Best For
Chrome	High performance, dedicated servers, residential proxies
Firefox	Advanced anti-detection, stealth mode

Quick Start

Playwright (Python):

from playwright.sync_api import sync_playwright
import os

username = os.environ["OXY_UNBLOCKER_USERNAME"]
password = os.environ["OXY_UNBLOCKER_PASSWORD"]

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(
        f"wss://{username}:{password}@ubc.oxylabs.io"
    )
    page = browser.new_page()
    page.goto("https://example.com")
    print(page.content())
    browser.close()

Playwright (JavaScript):

const { chromium } = require("playwright");

const username = process.env.OXY_UNBLOCKER_USERNAME;
const password = process.env.OXY_UNBLOCKER_PASSWORD;

(async () => {
  const browser = await chromium.connectOverCDP(
    `wss://${username}:${password}@ubc.oxylabs.io`
  );
  const page = await browser.newPage();
  await page.goto("https://example.com");
  console.log(await page.content());
  await browser.close();
})();

Puppeteer:

const puppeteer = require("puppeteer");

const username = process.env.OXY_UNBLOCKER_USERNAME;
const password = process.env.OXY_UNBLOCKER_PASSWORD;

(async () => {
  const browser = await puppeteer.connect({
    browserWSEndpoint: `wss://${username}:${password}@ubc.oxylabs.io`
  });
  const page = await browser.newPage();
  await page.goto("https://example.com");
  console.log(await page.content());
  await browser.close();
})();

Rate Limits

• Default: 10 sessions per second per browser type
• Higher limits: Available upon request to support

Features

• Anti-detection: Built-in fingerprint management
• Residential proxies: Automatic proxy rotation
• Geo-targeting: Country-level location control
• US optimization: Enhanced performance for US targets
• No local browsers: All execution happens remotely

When to Use

Scenario	Use Headless Browser
Complex JavaScript sites	Yes
Anti-bot protected sites	Yes
Browser automation with stealth	Yes
Screenshot/PDF generation	Yes
Simple HTML scraping	Consider Web Scraper API instead

Supported Libraries

Any library supporting Chrome DevTools Protocol (CDP):

• Playwright (recommended)
• Puppeteer
• Selenium with CDP
• Custom CDP implementations

For more examples, see examples.md.