Proxies

Managed residential proxies

{ "proxies": true }                       // residential, US, sticky exit IP {  "proxies": {    "country": "GB",                         // ISO-3166 alpha-2, default "US"    "state": "ca", "city": "los_angeles",    // optional, provider-dependent    "type": "residential",                   // residential | isp | mobile    "sticky": true                           // default true: same exit IP for the session's lifetime  }}

• Timezone, locale, Accept-Language and geolocation default to the exit country when you do not set them, so the browser and the IP agree.
• WebRTC is restricted to the proxied path whenever any proxy is set — no local-IP leaks.
• proxies and the BYO proxy object are mutually exclusive (400).
• Supported countries: GET /proxies/countries returns { countries: [{ code, name, timezone, locale }] } (public, cached).

Bring your own proxy

{ "proxy": { "server": "http://proxy:8080", "username": "u", "password": "p", "bypass": "*.internal" } }

server is scheme://host[:port] with scheme http, https, socks5, or socks4. Credentials are answered over CDP and never appear on a command line or in the session object (they come back redacted). BYO traffic is not metered.

Usage and billing

Traffic is counted as request plus response bytes through the proxy, reported live on the session object as usage.proxy_bytes (refreshed about every 60 seconds; final on completion) and as a proxy.usage event on the session event stream. The console shows GB used against the included pool for the current period.