Proxy Connection

Proxy Connection

Webshare proxies support two connection modes: Backbone and Direct. This page covers the connection details and parameters available for each mode.

Backbone Connection

Backbone proxy connections always use p.webshare.io as the connection address.

  • Username/password authentication: ports 80, 1080, 3128, and 9999 - 19999
  • IP Authorization: use the port field returned from the API

Username Parameters

When using username/password authentication, you can append parameters to your proxy username using hyphens (-) to control country targeting, session management, and geo targeting.

Format: {username}-{country_code}-{geo_params}-{session_id}

ParameterFormatDescription
Country code`{username}-us`

Append a 2-letter ISO country code to target a specific country. Multiple codes can be chained (e.g. -us-fr-de).

Session ID`{username}-us-1234`

Append a numeric session ID to maintain a sticky session. The same session ID will route to the same exit IP for the duration of the session.

Rotate`{username}-us-rotate`

Append rotate to get a new IP on every request. Cannot be combined with a session ID.

City`{username}-us-city_los_angeles`

Target a specific city. Works with any country. The value must contain only letters and underscores.

The city geo targeting parameter is only available for residential proxy plans.

Examples:

# US, sticky session 1234
curl --proxy "http://myuser-us-1234:password@p.webshare.io:80/" https://ipv4.webshare.io/
 
# US, Los Angeles, rotating IP
curl --proxy "http://myuser-us-city_los_angeles-rotate:password@p.webshare.io:80/" https://ipv4.webshare.io/
 
# Germany, Munich, sticky session 1234
curl --proxy "http://myuser-de-city_munich-1234:password@p.webshare.io:80/" https://ipv4.webshare.io/

Direct Connection

Direct proxy connections use the proxy_address and port fields returned from the Proxy List API.

  • Username/password authentication: provide username and password along with the proxy address and port.
  • IP Authorization: only the proxy address and port are needed (no credentials). Your source IP must be authorized via the IP Authorization API.

Examples:

# Username/password authentication
curl --proxy "http://username:password@1.2.3.4:8168/" https://ipv4.webshare.io/
 
# IP Authorization (no credentials needed)
curl --proxy "http://1.2.3.4:8168/" https://ipv4.webshare.io/
Refresh proxy listProxy Replacement