Proxies
Route your automation traffic with precision & control
Overview
Browserbase offers a flexible proxy system, enabling you to control how your automation traffic is routed across the internet. Whether you need anonymity, geolocation control, or improved reliability, Browserbase makes it easy to integrate proxies into your workflows.
Proxy Configuration Options
With Browserbase, you can:
- Use built-in proxies: Effortlessly route traffic through our managed residential proxies.
- Bring your own proxies: Use custom HTTP/HTTPS proxies for greater control over network routing.
- Combine multiple proxies: Set custom routing rules to direct traffic through different proxies based on domain or location.
Proxies are configured when creating a session through the API or SDK.
Use built-in proxies
Use Browserbase’s built-in proxies to route traffic through managed, residential proxies. This is the simplest option and requires very little setup.
Setting proxies: true
will make a best-effort attempt to use a US-based proxy. If nearby US proxies are unavailable, we may route through nearby countries (like Canada).
ERR_TUNNEL_CONNECTION_FAILED: indicates either a temporary proxy hiccup or a site unsupported by our built-in proxies (more details below). Please try again or email support@browserbase.com.
Set Proxy Geolocation
Set the geolocation of the proxy to a specific country, state (when within the United States), and city. This is useful if you need to proxy traffic to a specific location. If there is no proxy in the specified location, the closest proxy will be used.
Geolocation fields are case-insensitive.
To set geolocations outside of the United States, use the following format:
Proxy geolocations by country
Our built-in proxies support 201 countries.
Africa
Africa
- 🇩🇿 Algeria (DZ)
- 🇦🇴 Angola (AO)
- 🇧🇯 Benin (BJ)
- 🇧🇼 Botswana (BW)
- 🇧🇫 Burkina Faso (BF)
- 🇧🇮 Burundi (BI)
- 🇨🇲 Cameroon (CM)
- 🇨🇻 Cape Verde (CV)
- 🇨🇩 Democratic Republic of the Congo (CD)
- 🇪🇬 Egypt (EG)
- 🇬🇶 Equatorial Guinea (GQ)
- 🇸🇿 Eswatini (SZ)
- 🇪🇹 Ethiopia (ET)
- 🇬🇦 Gabon (GA)
- 🇬🇲 Gambia (GM)
- 🇬🇭 Ghana (GH)
- 🇬🇳 Guinea (GN)
- 🇬🇼 Guinea-Bissau (GW)
- 🇨🇮 Ivory Coast (CI)
- 🇰🇪 Kenya (KE)
- 🇱🇸 Lesotho (LS)
- 🇱🇷 Liberia (LR)
- 🇱🇾 Libya (LY)
- 🇲🇬 Madagascar (MG)
- 🇲🇼 Malawi (MW)
- 🇲🇱 Mali (ML)
- 🇲🇷 Mauritania (MR)
- 🇲🇺 Mauritius (MU)
- 🇾🇹 Mayotte (YT)
- 🇲🇦 Morocco (MA)
- 🇲🇿 Mozambique (MZ)
- 🇳🇦 Namibia (NA)
- 🇳🇪 Niger (NE)
- 🇳🇬 Nigeria (NG)
- 🇨🇬 Republic of the Congo (CG)
- 🇷🇪 Reunion (RE)
- 🇷🇼 Rwanda (RW)
- 🇸🇳 Senegal (SN)
- 🇸🇨 Seychelles (SC)
- 🇸🇱 Sierra Leone (SL)
- 🇸🇴 Somalia (SO)
- 🇿🇦 South Africa (ZA)
- 🇸🇸 South Sudan (SS)
- 🇸🇩 Sudan (SD)
- 🇹🇿 Tanzania (TZ)
- 🇹🇬 Togo (TG)
- 🇹🇳 Tunisia (TN)
- 🇺🇬 Uganda (UG)
- 🇿🇲 Zambia (ZM)
- 🇿🇼 Zimbabwe (ZW)
Asia
Asia
- 🇦🇫 Afghanistan (AF)
- 🇦🇲 Armenia (AM)
- 🇦🇿 Azerbaijan (AZ)
- 🇧🇭 Bahrain (BH)
- 🇧🇩 Bangladesh (BD)
- 🇧🇹 Bhutan (BT)
- 🇧🇳 Brunei (BN)
- 🇰🇭 Cambodia (KH)
- 🇨🇳 China (CN)
- 🇬🇪 Georgia (GE)
- 🇭🇰 Hong Kong (HK)
- 🇮🇳 India (IN)
- 🇮🇩 Indonesia (ID)
- 🇮🇷 Iran (IR)
- 🇮🇶 Iraq (IQ)
- 🇮🇱 Israel (IL)
- 🇯🇵 Japan (JP)
- 🇯🇴 Jordan (JO)
- 🇰🇿 Kazakhstan (KZ)
- 🇰🇼 Kuwait (KW)
- 🇰🇬 Kyrgyzstan (KG)
- 🇱🇦 Laos (LA)
- 🇱🇧 Lebanon (LB)
- 🇲🇴 Macao (MO)
- 🇲🇾 Malaysia (MY)
- 🇲🇻 Maldives (MV)
- 🇲🇳 Mongolia (MN)
- 🇲🇲 Myanmar (Burma) (MM)
- 🇳🇵 Nepal (NP)
- 🇴🇲 Oman (OM)
- 🇵🇰 Pakistan (PK)
- 🇵🇸 Palestine (PS)
- 🇵🇭 Philippines (PH)
- 🇶🇦 Qatar (QA)
- 🇷🇺 Russia (RU)
- 🇸🇦 Saudi Arabia (SA)
- 🇰🇷 South Korea (KR)
- 🇱🇰 Sri Lanka (LK)
- 🇹🇼 Taiwan (TW)
- 🇹🇯 Tajikistan (TJ)
- 🇹🇭 Thailand (TH)
- 🇹🇷 Turkey (TR)
- 🇦🇪 United Arab Emirates (AE)
- 🇺🇿 Uzbekistan (UZ)
- 🇻🇳 Vietnam (VN)
- 🇾🇪 Yemen (YE)
Europe
Europe
- 🇦🇽 Aland (AX)
- 🇦🇱 Albania (AL)
- 🇦🇩 Andorra (AD)
- 🇦🇹 Austria (AT)
- 🇧🇾 Belarus (BY)
- 🇧🇪 Belgium (BE)
- 🇧🇦 Bosnia and Herzegovina (BA)
- 🇧🇬 Bulgaria (BG)
- 🇭🇷 Croatia (HR)
- 🇨🇾 Cyprus (CY)
- 🇨🇿 Czech Republic (CZ)
- 🇩🇰 Denmark (DK)
- 🇪🇪 Estonia (EE)
- 🇫🇴 Faroe Islands (FO)
- 🇫🇮 Finland (FI)
- 🇫🇷 France (FR)
- 🇩🇪 Germany (DE)
- 🇬🇮 Gibraltar (GI)
- 🇬🇷 Greece (GR)
- 🇬🇬 Guernsey (GG)
- 🇭🇺 Hungary (HU)
- 🇮🇸 Iceland (IS)
- 🇮🇪 Ireland (IE)
- 🇮🇲 Isle of Man (IM)
- 🇮🇹 Italy (IT)
- 🇯🇪 Jersey (JE)
- 🇽🇰 Kosovo (XK)
- 🇱🇻 Latvia (LV)
- 🇱🇹 Lithuania (LT)
- 🇱🇺 Luxembourg (LU)
- 🇲🇹 Malta (MT)
- 🇲🇩 Moldova (MD)
- 🇲🇪 Montenegro (ME)
- 🇳🇱 Netherlands (NL)
- 🇲🇰 North Macedonia (MK)
- 🇳🇴 Norway (NO)
- 🇵🇱 Poland (PL)
- 🇵🇹 Portugal (PT)
- 🇷🇴 Romania (RO)
- 🇷🇸 Serbia (RS)
- 🇸🇰 Slovakia (SK)
- 🇸🇮 Slovenia (SI)
- 🇪🇸 Spain (ES)
- 🇸🇪 Sweden (SE)
- 🇨🇭 Switzerland (CH)
- 🇺🇦 Ukraine (UA)
- 🇬🇧 United Kingdom (GB)
North America
North America
- 🇦🇮 Anguilla (AI)
- 🇦🇬 Antigua and Barbuda (AG)
- 🇦🇼 Aruba (AW)
- 🇧🇸 Bahamas (BS)
- 🇧🇧 Barbados (BB)
- 🇧🇿 Belize (BZ)
- 🇧🇲 Bermuda (BM)
- 🇻🇬 British Virgin Islands (VG)
- 🇨🇦 Canada (CA)
- 🇰🇾 Cayman Islands (KY)
- 🇨🇷 Costa Rica (CR)
- 🇨🇺 Cuba (CU)
- 🇨🇼 Curacao (CW)
- 🇩🇲 Dominica (DM)
- 🇩🇴 Dominican Republic (DO)
- 🇸🇻 El Salvador (SV)
- 🇬🇱 Greenland (GL)
- 🇬🇩 Grenada (GD)
- 🇬🇵 Guadeloupe (GP)
- 🇬🇹 Guatemala (GT)
- 🇭🇹 Haiti (HT)
- 🇭🇳 Honduras (HN)
- 🇯🇲 Jamaica (JM)
- 🇲🇶 Martinique (MQ)
- 🇲🇽 Mexico (MX)
- 🇳🇮 Nicaragua (NI)
- 🇵🇦 Panama (PA)
- 🇵🇷 Puerto Rico (PR)
- 🇰🇳 Saint Kitts and Nevis (KN)
- 🇱🇨 Saint Lucia (LC)
- 🇻🇨 Saint Vincent and the Grenadines (VC)
- 🇸🇽 Sint Maarten (SX)
- 🇹🇹 Trinidad and Tobago (TT)
- 🇹🇨 Turks and Caicos Islands (TC)
- 🇻🇮 U.S. Virgin Islands (VI)
- 🇺🇸 United States (US)
Oceania
Oceania
- 🇦🇺 Australia (AU)
- 🇫🇯 Fiji (FJ)
- 🇵🇫 French Polynesia (PF)
- 🇬🇺 Guam (GU)
- 🇫🇲 Micronesia (FM)
- 🇳🇨 New Caledonia (NC)
- 🇳🇿 New Zealand (NZ)
- 🇲🇵 Northern Mariana Islands (MP)
- 🇵🇬 Papua New Guinea (PG)
South America
South America
- 🇦🇷 Argentina (AR)
- 🇧🇴 Bolivia (BO)
- 🇧🇷 Brazil (BR)
- 🇨🇱 Chile (CL)
- 🇨🇴 Colombia (CO)
- 🇪🇨 Ecuador (EC)
- 🇬🇫 French Guiana (GF)
- 🇬🇾 Guyana (GY)
- 🇵🇾 Paraguay (PY)
- 🇵🇪 Peru (PE)
- 🇸🇷 Suriname (SR)
- 🇺🇾 Uruguay (UY)
- 🇻🇪 Venezuela (VE)
Custom Proxies
Browserbase supports custom proxy configurations, allowing you to route traffic through your own HTTP or HTTPS proxies. This is useful if you need to enforce specific network routing rules, comply with security policies, or optimize performance with a preferred proxy provider.
To configure a custom proxy, provide the proxy server URL and authentication details when creating a session.
Browserbase validates proxy connections at session creation time. If we are unable to connect to the specified proxy, an error will be thrown. Ensure that your proxy server is accessible and the provided credentials are correct before creating a session. We also do not support all proxy providers.
Proxies Routing Rules
Combine multiple proxies and define routing rules based on domain patterns. This is particularly useful when different websites require different proxies, such as routing government-related sites through one proxy while using another for general browsing.
Proxies are applied in the order they are listed, meaning the first matching rule is used for each request. If no rule matches a domain pattern, you can use the browserbase
proxy type to fall back to Browserbase’s default proxies.
How is proxy usage measured?
Proxy usage is measured by the total amount of data transferred through the proxy. This includes:
- Webpage content, downloads, and media files
- HTTP headers, authentication data, and encryption overhead
- Any requests and responses routed through the proxy
Since all traffic must pass through the proxy server before reaching its final destination, every interaction contributes to your total bandwidth usage.
To reduce proxy usage, refer to our Cost Optimization section.
Limitations
Certain high-risk categories are restricted by our proxy providers and cannot be accessed through proxies, including:
- All Apple domains, including iTunes and App stores
- Entertainment (e.g., Netflix, Playstation)
- Banking and other financial institutions
- Some Google domains
- Streaming
- Ticketing
- Mailing
- Some .gov domains