Residential proxies, built in

Set a country code and the browser browses from a residential IP there, with the timezone and language to match. Or bring your own proxy.

PICK A COUNTRYUSDEJP195+ COUNTRIESshop.exampleWillkommen!Looks localWHAT THE SITE SEESConnectionVodafone, homeCityNurembergTimezoneEurope/BerlinLanguagede-DE
PICK A COUNTRYUSDEJP195+ COUNTRIESshop.exampleWillkommen!Looks localWHAT THE SITE SEESConnectionVodafone, homeCityNurembergTimezoneEurope/BerlinLanguagede-DE
PICK A COUNTRY195+ COUNTRIESUSDEJPshop.exampleWillkommen!Looks localWHAT THE SITE SEESConnectionVodafone, homeCityNurembergTimezoneEurope/BerlinLanguagede-DE

Residential traffic, priced per GB.

$5 / GBManaged proxy traffic, on top of browser time. No plan. With the proxy off or your own proxy: $0.20/GB. Pricing

For AI agents

What's the best way to combine residential proxies with a headless browser for an AI agent?

One sticky residential IP per agent task, timezone and locale matched to the exit, a new IP only between tasks. Playwright plus any provider can do it. Browser Use Cloud sets timezone and language for you, but its managed IP can change mid-task; for a sticky IP, pass a session-id proxy as customProxy.

  1. One context per task

    browser.newContext({ proxy }), with proxy as { server, username, password }. Use chromium.launch({ proxy }) when the whole browser shares one exit.

  2. Sticky in a task, rotate between tasks

    Put your provider's session id in the proxy username, or residential IPs change on every request. Oxylabs sessid lasts 10 min, or ends after 60 s idle (a slow model step can hit that); sesstime stretches it to 24 h; sessid_oneip fails rather than switch IP. A new IP mid-session can log the agent out: OWASP recommends sites bind a session to client properties such as the IP.

  3. Check the exit IP

    Before the task, read ipinfo.io/json through the same proxy session: it returns the exit's IP and timezone. Check again before any step that depends on the IP.

  4. Match the exit

    Create the context with timezoneId set to that timezone and locale to the country's language.

  5. Budget per GB

    Residential traffic is billed per GB. page.route() can abort images the agent does not need.

Sources: Playwright network, Playwright emulation, Oxylabs sessions, OWASP session binding, Browser Use proxies, Browser Use pricing. Checked Oct 30, 2026.

Pick a country. Keep your Playwright code.

One argument when you create the browser, then connect over CDP as usual. Agent runs take the same setting in their browser settings.

import asyncio

from browser_use_sdk.v4 import AsyncBrowserUse
from playwright.async_api import async_playwright

client = AsyncBrowserUse()  # reads BROWSER_USE_API_KEY

async def main():
    # A residential IP in Germany; timezone and language follow it.
    browser = await client.browsers.create(proxy_country_code="de")
    try:
        async with async_playwright() as p:
            chrome = await p.chromium.connect_over_cdp(browser.cdp_url)
            page = chrome.contexts[0].pages[0]
            await page.goto("https://ipinfo.io/json")
            print(await page.inner_text("body"))  # "country": "DE"
    finally:
        await client.browsers.stop(browser.id)  # closing CDP does not stop it

asyncio.run(main())

Tested October 20, 2026

Residential by default. Yours if you prefer.

  • Residential IPs in the country you set

    Every IP in our test was on a consumer ISP in the country set. 3 of 5 browsers kept one IP for all 40 minutes; 2 switched to another IP in the same country. Each new browser got a different IP.

  • Timezone and language follow the IP

    A German IP browses with Europe/Berlin time and de-DE language, in JavaScript and in the Accept-Language header. A Michigan IP got America/Detroit. Nothing to configure.

  • Bring your own proxy

    Pass your provider's host, port and login as customProxy. It replaces the managed proxy for that browser.

Questions, answered.

What's the best way to combine residential proxies with a headless browser for an AI agent?

One browser context per task, with one sticky residential IP (your provider's session id), timezone and locale matched to the exit, and a new IP only between tasks. Browser Use Cloud's managed IP can change mid-task, so for a sticky IP pass a session-id proxy as customProxy.

Why not rotate the IP on every request?

Logins and checkouts can break. OWASP recommends sites bind a session to client properties such as the IP and flag a mid-session change as possible hijacking, so a new IP can log the agent out or trigger a challenge. Rotate per task instead.

Does the IP stay the same for the whole session?

Not always. On October 20, 2026 we ran 5 browsers (two in the United States, one in Germany, one in the United Kingdom and one in Japan) and read each one's exit IP once a minute for 40 minutes. 3 kept a single IP throughout. The browser in Germany switched at minute 36, from Vodafone GmbH (Nuremberg) to Vodafone GmbH (Köln); the browser in Japan switched at minute 15, from Utsunomiya Cable TV Corporation (Utsunomiya) to SoftBank Corp. (Tokyo). Every IP stayed in the country set, on a consumer ISP (Comcast, Charter, Vodafone, Connexin, Utsunomiya Cable TV and SoftBank). If a step depends on one IP, such as a login a site ties to an address, read the IP before and after it, or bring a sticky proxy of your own.

How do I get a new IP?

Start a new browser. In our test all 7 IPs we saw were different. The docs do not promise a unique IP or a particular city per browser, so check the IP if your flow depends on it.

Do I need to match the timezone and language to the proxy?

No. The browser sets them from its IP: in our test a Lansing IP reported America/Detroit and en-US, a New York City IP reported America/New_York and en-US, a Nuremberg IP reported Europe/Berlin and de-DE, a Kingston upon Hull IP reported Europe/London and en-GB and a Utsunomiya IP reported Asia/Tokyo and ja-JP, both in JavaScript and in the Accept-Language header. We read them once, at the start of each browser.

What does proxy traffic cost?

$5 per GB of traffic through the managed proxy, on top of browser time at $0.06 per hour. No plan or subscription. For sites that don't need a residential IP, such as your own staging site, set proxy_country_code to null: that traffic goes direct at $0.20/GB.

Can I use my own proxy provider?

Yes, on every account: pass customProxy (host, port, and a username and password if it needs them) when you create the browser. It overrides the country setting for that browser. Your provider bills its own traffic; Browser Use bills that traffic at the $0.20/GB egress rate, not $5/GB.

Start with $1 free.

Get API key