Proxies

Fetch sends requests directly by default. Enable Browserbase’s proxy network to route requests through a different IP address when a site blocks direct requests, or choose a location to retrieve region-specific content and pricing.

Using proxies

If a site blocks your request or returns a 403 status code, set proxies: true.

Node.js
Python
cURL

Node.js

const response = await bb.fetchAPI.create({
  url: "https://httpbin.org/",
  proxies: true,
});

Python

response = bb.fetch_api.create(url="https://httpbin.org/", proxies=True)

cURL

curl -X POST https://api.browserbase.com/v1/fetch \
  -H "Content-Type: application/json" \
  -H "X-BB-API-Key: $BROWSERBASE_API_KEY" \
  -d '{"url": "https://httpbin.org/", "proxies": true}'

Enabling proxies may increase response time. If speed is critical and the target site doesn’t require a proxy, leave this disabled.

Targeting a geolocation

To route the request from a specific location, pass proxies as an object with a geolocation. This is useful for fetching region-specific content or pricing. Omit geolocation (or set proxies: true) to use the default exit location.

Node.js
Python
cURL

Node.js

const response = await bb.fetchAPI.create({
  url: "https://httpbin.org/",
  proxies: {
    geolocation: {
      country: "US",
      state: "NY",
      city: "New York",
    },
  },
});

Python

response = bb.fetch_api.create(
    url="https://httpbin.org/",
    proxies={
        "geolocation": {
            "country": "US",
            "state": "NY",
            "city": "New York",
        },
    },
)

cURL

curl -X POST https://api.browserbase.com/v1/fetch \
  -H "Content-Type: application/json" \
  -H "X-BB-API-Key: $BROWSERBASE_API_KEY" \
  -d '{
    "url": "https://httpbin.org/",
    "proxies": {
      "geolocation": {
        "country": "US",
        "state": "NY",
        "city": "New York"
      }
    }
  }'

The geolocation object accepts:

Field	Type	Required	Description
`country`	`string`	required	Country code in ISO 3166-1 alpha-2 format (2 letters, e.g. `US`).
`state`	`string`	optional	US state code (2 letters, e.g. `NY`). Only valid when `country` is `US`.
`city`	`string`	optional	City name. Use spaces for multi-word names (e.g. `New York`).

Unlike browser sessions, Fetch supports a single Browserbase-managed proxy configuration only. Custom (bring-your-own) proxies and per-domain proxy rules aren’t available on Fetch.

Authenticated Fetch

Fetch pages that require a login with saved browser session state.

Fetch

Return page content without an interactive browser session.

Welcome

Platform

Use cases

Optimization

Account

Using proxies

Targeting a geolocation

Authenticated Fetch

Fetch

​Using proxies

​Targeting a geolocation

Authenticated Fetch

Fetch

Using proxies

Targeting a geolocation