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:7777Country
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.
| Value | Description |
|---|---|
any | Use any available country from the pool. |
us | United States |
uk | United Kingdom |
de | Germany |
fr | France |
ca | Canada |
au | Australia |
nl | Netherlands |
When a country is selected, it is added to the proxy username:
username=<YOUR_PROXY_USERNAME>+country=usWhen 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=newyorkSession mode
Session mode controls whether requests can receive different IPs or keep the same IP for a short workflow.
| Option | Description |
|---|---|
| Rotating | Omit session and rotation. Each request can receive a different residential IP. |
| Sticky | Add 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=600Rotation 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.
| Option | Output |
|---|---|
| Endpoint: port | username=<YOUR_PROXY_USERNAME>:<YOUR_PROXY_PASSWORD>@pr.webscrapingapi.com:7777 |
| HTTP | http://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
| Host | Port | Authentication | Protocol |
|---|---|---|---|
pr.webscrapingapi.com | 7777 | Username and password | HTTP |
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:7777For copyable examples in cURL, NodeJS, Python, PHP, Golang, Java, .NET, and Ruby, use the Endpoint generator.