Browser APIwss://…/v1/browser

Your Playwright code, our browsers.

The Browser API gives Playwright, Puppeteer or any CDP client a fresh, sandboxed Chrome in the cloud. Its traffic goes through residential proxies, and you keep your own browser code.

What it does

A fresh cloud Chrome for your Playwright or Puppeteer code, over CDP.

  • Plain CDP over WebSocket

    Point connectOverCDP or puppeteer.connect at one URL. No plugin or SDK to install.

  • A new Chrome every time

    Every connection starts a sandboxed Chrome with an empty profile. Closing it deletes the profile, so nothing is shared between sessions.

  • Residential proxies built in

    Choose the exit country, or keep the same IP with session, also across the Scraper API.

  • Billed by the second, almost

    Sessions are billed per started 10 seconds from connect to close. A session that does not start costs nothing.

  • Up to 15 minutes per session

    Set timeout between 60 and 900 seconds. Idle sessions close after 60 seconds without CDP messages.

  • Locked down

    No downloads, no file access, no extensions and no way back into Siftzo's network from the page.

Example

One HTTP call

CDP needs a WebSocket client, so these examples use Playwright and Puppeteer, the open-source libraries you may already have. Send your key as X-API-Key where the client can set headers, or as ?token= where it cannot.

Official SDKs are coming soon. Until then, any HTTP client works.

Browser API docs
import { chromium } from "playwright";

const browser = await chromium.connectOverCDP("wss://api.siftzo.com/v1/browser?country=de", {
  headers: { "X-API-Key": process.env.SIFTZO_API_KEY },
});
const context = browser.contexts()[0] ?? (await browser.newContext());
const page = await context.newPage();
await page.goto("https://quotes.toscrape.com/js/");
console.log(await page.locator(".quote .text").allTextContents());
await browser.close();

Reference

Key parameters

countryISO 3166-1 alpha-2
Exit country for all traffic.
sessionstring
Keeps the exit IP. The same name gives the same IP as in /v1/scrape.
timeoutinteger, 60–900default 300
The longest the session may run, in seconds.
tokenstring
Your API key, for clients that cannot set headers. Prefer X-API-Key.

Every parameter and response field is in the Browser API docs.

Credits

What it costs

Browser API credits
RequestCredits
Browser API session1 per 10 seconds

Counted from the moment the connection opens until it closes. Each open session uses one slot of your plan's concurrency. See Browser API.

See plans

Questions

Which clients work?

Any client that speaks the Chrome DevTools Protocol over WebSocket: Playwright with connectOverCDP, Puppeteer with connect, and others.

Is anything kept between sessions?

No. Each session gets a new profile that is deleted when it closes. To keep the same IP across sessions, use session.

What happens when my credits run out mid-session?

The session ends at the end of the time already paid for, with WebSocket close code 4002. Other close codes are listed in the docs.

When should I use the Scraper API instead?

When you need a page, not a browser. The Scraper API decides on rendering, retries and proxies for you and is cheaper per page. Use the Browser API for logins you are allowed to use, multi-step flows or code you already have.

Try the Browser API for free

Create an account, copy your key and send a request. No card needed for the Free plan.