Proxies Beta

Residential, datacenter or your own proxy, by country.

Every session goes through a proxy. Pick one with the proxy parameter of POST /v1/browsers:

proxy	Exit IPs	Best for
premium (default)	Residential IPs from internet providers	Sites with anti-bot protection
datacenter	Datacenter IPs	Sites without anti-bot protection
A proxy URL	Your own proxy	IPs you already have

The browser's time zone, languages and geolocation follow the exit IP, whichever proxy you use. See Stealth.

Country

With premium or datacenter, set country to a two-letter country code to exit from that country:

{ "proxy": "premium", "country": "fr" }

Leave it out to exit from any country; that gives the widest choice of IPs.

Keeping the same IP

By default, each session gets a new exit IP. To keep one across sessions, pass the same proxy_session each time: a number from 0 to 10000000, as a string.

{ "proxy": "premium", "country": "us", "proxy_session": "4242" }

A persistent identity does this for you: a label keeps both its device and its exit IP.

Residential IPs are real people's connections and can go offline, so the same proxy_session may get another IP later.

Your own proxy

Pass the proxy's URL, with its credentials if it needs them:

{ "proxy": "http://user:[email protected]:8080" }

http://, https:// and socks5:// proxies are supported. The exit IP is whatever your proxy gives, so country and proxy_session are refused with a 400.

If the browser can't connect through your proxy (wrong address or credentials, or the proxy is down), the session closes with code 4002 before it starts, and is not charged.