Skip to main content

Proxies

Proxies & GEO targeting​

Our residential proxy pool includes over 70 million IPs from 195 countries from over dozens of ISPs and should be sufficient for the vast majority of scraping jobs.

Proxy behavior is set by parameters proxy and proxyCountry

curl --location 'https://chrome-v2.browsercloud.io/content?token=API_TOKEN&proxy=datacenter&proxyCountry=GB&url=https://api.myip.com'
ParameterAvailable valuesDescription
proxy1) datacenter - datacenter proxy pool with 70mln of fast proxies
2) residential - premium proxy pool for a few particularly difficult to scrape sites
3) omit parameter to use direct connection from our servers		Proxy pool type
proxyCountryparameter works with proxy parameter

1) two-letter country ISO code. Example: US, CA, GB, DE and more
2) omit parameter or set ALL for global rotating
Proxy geo targeting

REST API​

curl 'https://chrome-v2.browsercloud.io/content?token=API_TOKEN&url=https://site.com&proxy=residential&proxyCountry=US'

Puppeteer proxies example​

browser = await puppeteer.connect({browserWSEndpoint:
    'wss://chrome-v2.browsercloud.io?'+
    'token=API_TOKEN'+
    '&proxy=datacenter'+ //proxy type (optional): residential / datacenter
    '&proxyCountry=US' //proxy country (optional)
});

Playwright proxies example​

browser = await playwright.chromium.connect(
  'wss://chrome-v2.browsercloud.io/playwright?'+
  'token=API_TOKEN'+
  '&proxy=datacenter'+ //proxy type (optional): residential / datacenter
  '&proxyCountry=US' //proxy country (optional);
);

Using your proxies​

Use proxyURL parameter instead of proxy & proxyCountry Format:

http://proxy_login:proxy_password@domain.com:port
info

Make sure you do URL encoding the address in &url= and &proxyURL parameters to avoid conflict with other parameters in GET request. You can use services like https://www.urlencoder.org

CURL example​

curl 'https://chrome-v2.browsercloud.io/content?token=API_TOKEN&url=https%3A%2F%2Fsite.com&proxyURL=http%3A%2F%2Fproxy_login%3Aproxy_password%40domain.com%3A5555'

Puppeteer proxies example​

browser = await puppeteer.connect({browserWSEndpoint:
    'wss://chrome-v2.browsercloud.io?'+
    'token=API_TOKEN'+
    '&proxyURL='+ encodeURIComponent('http://proxy_login:proxy_password@domain.com:5555')
});

Playwright proxies example​

browser = await playwright.chromium.connect(
  'wss://chrome-v2.browsercloud.io/playwright?'+
  'token=API_TOKEN'+
  '&proxyURL='+ encodeURIComponent('http://proxy_login:proxy_password@domain.com:5555')
);