Browser API

Residential proxies in Browserbase

Browserbase lets you bring your own proxy as an external entry in the session's proxies list. Point it at our gateway and every session browses from a home IP in the country you set, at $1 per GB.

Host
via.proxies.vision
Ports
9000 rotating · 10000 sticky
Same IP for
up to 24 hours
Price
$1/GB, never expire

The code

Browserbase takes server, username and password separately. Replace USER and PASS with your login from the dashboard. Python uses the same keys.

typescript
import Browserbase from "@browserbasehq/sdk";

const bb = new Browserbase({ apiKey: process.env.BROWSERBASE_API_KEY! });

const session = await bb.sessions.create({
  projectId: process.env.BROWSERBASE_PROJECT_ID!,
  proxies: [
    {
      type: "external",
      server: "http://via.proxies.vision:10000",
      username: "USER-country-us-session-bb1-lifetime-30",
      password: "PASS",
    },
  ],
});

Set it up in Browserbase

As in Browserbase's documentation today.

  1. 01

    Check your plan

    Custom proxies need the Developer plan or higher at Browserbase.

  2. 02

    Add an external proxy

    Create the session with proxies: one entry of type external with our server, your username and your password.

  3. 03

    Pick rotating or sticky

    Port 9000 rotates per connection; port 10000 with a session in the username keeps one IP.

  4. 04

    Watch the connection check

    Browserbase tests the proxy when it creates the session and stops with an error if it can't connect, so a typo shows up right away.

Questions

Rotating or sticky?
Port 9000 gives every new connection a new home IP, good for crawling many pages. For a logged-in flow that has to keep one IP, put a session in the username (USER-session-job1-lifetime-30) and use port 10000; the same session name keeps the same exit for its lifetime.
HTTP or SOCKS5?
Browserbase documents custom proxies as HTTP or HTTPS, so use our HTTP ports 9000 and 10000.
What does it cost?
$1 per GB of traffic, whatever the country, city or network. No subscription, and unused bandwidth never expires. An agent that loads full pages uses more than one fetching HTML, so block images and media where the task allows it.