Headless Browser API

What is a Headless Browser?

A real browser, without the interface

A headless browser is a real Chromium or Firefox browser that loads web pages, executes JavaScript, and interacts with websites just like a regular browser. The difference is that it runs without a visible window, allowing your code or AI agent to control it directly. This makes it possible to navigate, interact with, and collect data from live websites instead of relying on static screenshots.

Without it

AI agents face limitations

Basic scripts struggle with JavaScript-heavy websites, can trigger bot detection after repeated requests, and often get blocked by CAPTCHAs without the tools needed to continue.

How it works

A browser, routed through Graviix

Graviix runs your browser session remotely and routes its traffic through a residential or datacenter IP from our 100M+ network, helping each session access websites through a different proxy connection.

The result

Your agent keeps running

Thousands of sessions can run in parallel, while proxy connections and browser sessions are managed for you — so there's no browser fleet or proxy list to maintain.

Request Path

Your AI Agent

Sends the request

Headless Browser

Loads the page

Graviix Network

Routes through a proxy IP

Target Website

Receives the request

JavaScript Rendering

Handle dynamic, JavaScript-heavy websites with full page rendering for reliable data extraction.

Simple Integration

Connect with Puppeteer, Playwright, CDP tools, and supported AI development workflows.

Proxy Management

Access 100M+ residential IPs from Graviix with country, city, and ISP-level targeting where available.

Flexible Scaling

Scale browser sessions in the cloud without managing browser infrastructure or proxy lists yourself.

Visual Debugging

View your browser automation sessions in real time to monitor activity and troubleshoot workflows.

Developer-First

Works With Your Stack

Headless Browser provides a flexible environment for web scraping and automation — designed for both human workflows and AI agents.

Libraries: Playwright, Puppeteer & CDP-compatible tools
Browsers: Chromium and Firefox
AI control: MCP support for Claude Desktop, Cursor, and compatible MCP clients

from playwright.sync_api import sync_playwright
 
username = "your-username"
password = "your-password"
endpoint = "headless.graviix.com"
browser_url = f"wss://{username}:{password}@{endpoint}"
 
with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(browser_url)
    page = browser.new_page()
    page.goto("https://example.com")
    data = page.evaluate("() => document.title")
    print(data)
    browser.close()
from playwright.sync_api import sync_playwright
 
username = "your-username"
password = "your-password"
endpoint = "headless.graviix.com"
browser_url = f"wss://{username}:{password}@{endpoint}?browser=firefox"
 
with sync_playwright() as p:
    browser = p.firefox.connect(browser_url)
    page = browser.new_page()
    page.goto("https://example.com")
    data = page.evaluate("() => document.title")
    print(data)
    browser.close()
const puppeteer = require('puppeteer-core');
 
const username = 'your-username';
const password = 'your-password';
const endpoint = 'headless.graviix.com';
const browserURL = `wss://${username}:${password}@${endpoint}`;
 
async function run() {
  const browser = await puppeteer.connect({ browserWSEndpoint: browserURL });
  const page = await browser.newPage();
  await page.goto('https://example.com');
  const title = await page.evaluate(() => document.title);
  console.log(title);
  await browser.close();
}
run();
const puppeteer = require('puppeteer-core');
 
const username = 'your-username';
const password = 'your-password';
const endpoint = 'headless.graviix.com';
const browserURL = `wss://${username}:${password}@${endpoint}?browser=firefox`;
 
async function run() {
  const browser = await puppeteer.connect({ browserWSEndpoint: browserURL, product: 'firefox' });
  const page = await browser.newPage();
  await page.goto('https://example.com');
  const title = await page.evaluate(() => document.title);
  console.log(title);
  await browser.close();
}
run();
const chromium = require('@sparticuz/chromium');
 
const username = 'your-username';
const password = 'your-password';
const endpoint = 'headless.graviix.com';
const cdpUrl = `https://${username}:${password}@${endpoint}/cdp`;
 
async function connectCDP() {
  const browser = await chromium.connectOverCDP(cdpUrl);
  const contexts = browser.browserContexts();
  const page = await contexts[0].newPage();
  await page.goto('https://example.com');
  // Access all CDP domains directly
  const client = await page.createCDPSession();
  await browser.close();
}
connectCDP();
const username = 'your-username';
const password = 'your-password';
const endpoint = 'headless.graviix.com';
const bidiUrl = `wss://${username}:${password}@${endpoint}/bidi?browser=firefox`;
 
// Firefox speaks WebDriver BiDi instead of CDP —
// same session endpoint, BiDi-compatible clients connect directly
async function connectBiDi() {
  const browser = await firefox.connect(bidiUrl);
  const page = await browser.newPage();
  await page.goto('https://example.com');
  await browser.close();
}
connectBiDi();

FAQ

Frequently Asked Questions

Everything you need to know about our Headless Browser.

A headless browser is a fully functional web browser that runs without a visible interface. It can load pages, execute JavaScript, and interact with websites through code, making it useful for scraping, testing, automation, and AI-driven workflows.

CAPTCHA handling depends on the browser configuration and supported workflow. Where supported, available tools can help manage CAPTCHA challenges during automated browser sessions.

Yes. Graviix Headless Browser supports common browser automation tools such as Playwright and Puppeteer, allowing you to connect your existing workflows and automate browser sessions through supported configurations.

Graviix Headless Browser can support AI-driven browser workflows through compatible integrations and automation tools. Availability depends on the integration and configuration used with your setup.

Free trials are not currently available. Graviix may occasionally offer limited-time trials or promotional offers, so check your account dashboard for any current offers before choosing a plan.

Reviews

Headless Browser for AI Agents
Built to Scrape Extract Automate Navigate Scale