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.
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.
01
Check your plan
Custom proxies need the Developer plan or higher at Browserbase.
02
Add an external proxy
Create the session with proxies: one entry of type external with our server, your username and your password.
03
Pick rotating or sticky
Port 9000 rotates per connection; port 10000 with a session in the username keeps one IP.
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.
