WebScrapingAPI Docs
Proxy & InfrastructureResidential Proxies

Proxies options

Reference for Residential Proxies endpoint generator options.

Residential Proxies are configured through the proxy endpoint you give to your HTTP client. The endpoint generator builds that endpoint from the supported options below.

Authentication

Residential Proxy access uses the proxy username and password shown in the customer dashboard.

http://username=<YOUR_PROXY_USERNAME>+country=us:<YOUR_PROXY_PASSWORD>@pr.webscrapingapi.com:7777

Country

The country option controls the residential proxy location. Use it when the target website serves different content, pricing, availability, language, or access rules by country.

The endpoint generator supports a catalog of 164 countries. Country targeting uses the country code in the proxy username; retired country-specific hosts and port ranges are not used.

Common legacy values are shown below. The selector contains the complete legacy catalog.

ValueDescription
anyUse any available country from the pool.
usUnited States
ukUnited Kingdom
deGermany
frFrance
caCanada
auAustralia
nlNetherlands

When a country is selected, it is added to the proxy username:

username=<YOUR_PROXY_USERNAME>+country=us

When any is selected, the country parameter is omitted.

State and city

State and city targeting is available for Australia, Canada, India, the United Kingdom, and the United States. Changing the country clears state and city; changing the state clears city. The endpoint generator removes spaces before adding a selected value to the proxy username.

username=<YOUR_PROXY_USERNAME>+country=us+state=newyork+city=newyork

Session mode

Session mode controls whether requests can receive different IPs or keep the same IP for a short workflow.

OptionDescription
RotatingOmit session and rotation. Each request can receive a different residential IP.
StickyAdd session and rotation. Requests with the same session value can keep the same residential IP for the selected rotation window.

Use rotating sessions for independent requests. Use sticky sessions for flows where the target expects continuity, such as pagination, cart flows, or session-aware pages.

Sticky session values

For sticky output, the endpoint generator assigns session=1 to the first row, session=2 to the second row, and so on. This keeps multiple generated endpoints independent.

username=<YOUR_PROXY_USERNAME>+country=us+session=1+rotation=600

Rotation time

rotation controls how long a sticky session can keep the same IP. The supported range is 180 through 3600 seconds, and the default is 600 seconds.

For rotating requests, leave session and rotation out of the username.

Output format

Output format controls how the generated endpoint is copied.

OptionOutput
Endpoint: portusername=<YOUR_PROXY_USERNAME>:<YOUR_PROXY_PASSWORD>@pr.webscrapingapi.com:7777
HTTPhttp://username=<YOUR_PROXY_USERNAME>:<YOUR_PROXY_PASSWORD>@pr.webscrapingapi.com:7777

Choose the raw endpoint when your client accepts proxy credentials and host directly. Choose HTTP when your client expects a proxy URL.

Host and port

HostPortAuthenticationProtocol
pr.webscrapingapi.com7777Username and passwordHTTP

Country targeting never changes the host or port; it is encoded in the username.

Generated endpoint

The generated endpoint combines authentication, location targeting, session behavior, and output format.

Example sticky HTTP endpoint:

http://username=<YOUR_PROXY_USERNAME>+country=us+session=1+rotation=600:<YOUR_PROXY_PASSWORD>@pr.webscrapingapi.com:7777

For copyable examples in cURL, NodeJS, Python, PHP, Golang, Java, .NET, and Ruby, use the Endpoint generator.

On this page