Skip to main content
All CollectionsScraping Browser
Building Browser Connection URL
Building Browser Connection URL
P
Written by Product Nodemaven
Updated over a week ago

Scraping Browser allows you to configure your connection URL with various parameters, enabling you to customize proxy settings, browser profile settings, and browser session persistence. This guide explains how to construct a connection URL using different options.

A standard connection URL follows this format:

wss://{proxyuser}_country-{country}-region-{region}-city-{city}-isp-{isp}-sid-{sid}-pid-{pid}:{proxypassword}@browser.nodemaven.com

Below is a breakdown of available parameters with it's description and examples of Connection URLs

Parametr

Description

Example:

country-{country_code}

Selects an IP from a specific country or a random location.

Use country-any for a random location or specify an ISO country code.

Targeting to USA:

wss://username_country-us:[email protected]

region-{region_name}

Selects an IP from a specific region within a country.

Targeting to USA, New York region:

wss://username_country-us-region-new_york:[email protected]

city-{city_name}

Selects an IP from a specific city within a country and region.

Targeting to USA, New York region, Brooklyn city:

wss://username_country-us-region-new_york-city-brooklyn:[email protected]

isp-{isp_name}

Selects an IP from a specific Internet Service Provider (ISP).

ISP targeting works in combination with country, region, or city targeting.

Targeting to USA, New York region, T-Mobile USA ISP:

wss://username_country-us-region-new_york-city-brooklyn-isp-t_mobile_usa:[email protected]

sid-{sid}

The session ID (sid) can be any random string of characters. It enables proxy session persistence by keeping the same IP for multiple requests.

Remove sid-{sid} to get a new IP on each request. The session ID can be any random string of characters.

Sticky session (maintains the same IP):
wss://username_country-{country}-sid-12345678:[email protected]

Rotating IP on each request:
wss://username_country-{country}:[email protected]

pid-{pid}

Profile ID (pid) determines which set of fingerprint settings the browser should use. Currently, our software automatically generates the most suitable fingerprint settings and does not support customization.

Example of connection to browser with custom browser profile settings:

wss://username_country-{country}-sid-{sid}-pid-12345678:[email protected]

Did this answer your question?