We've added a new way to connect to your Rotating Residential plan proxies: the Endpoint Generator. It gives you more customization when connecting to your Rotating Residential proxies, and it's currently the only plan that supports state, city, ZIP code and ASN targeting.
How does it work?
The Endpoint Generator brings all your connection settings onto one page:
Top: a Quick Test Command you can copy and run right away
Left: your endpoint configuration (authentication, location, session type, and number of endpoints)
Right: your Endpoint Output, ready to copy or export
Configure your options on the left, and your output updates on the right. The header of the Endpoint Output shows a summary of your current selection (for example, Default User · Worldwide · Rotating), so you can confirm at a glance what you're generating. The sections below walk through each setting.
Authentication Methods
You can choose from three authentication methods:
Default user: your standard connection using your default username and password. Output is generated immediately.
Sub-user: select a sub-user from a list, and their credentials are pre-loaded into the output for quick copy/paste when testing with our test command or entering credentials into your setup.
Authorized IP: switches your credentials to use your Authorized IP instead of username and password authentication.
When you switch from Default User to Sub-user or Authorized IP, your last generated output remains visible until you select a sub-user or Authorized IP, at which point the output updates. Switching back to the Default User generates output right away.
Choosing your Location
Location filters work one at a time. You can pair your country with one of state, city, or ZIP code. The available combinations are:
Country only
Country + State (United States only)
Country + City
Country + ZIP code (United States only)
Country + State + City, or any other pairing of the three, isn't supported. The fields all appear together in the panel, so selecting a second one replaces your first.
Country: choose one of 195 countries, or leave it on Worldwide.
State: appears once United States is selected as the country.
City: available with any single country.
ZIP code: appears once United States is selected. This is a free-text field, so type the code in directly.
ASN: targets a specific ISP network. See What does ASN mean? if you're not sure what to pick.
ASN targeting cannot be combined with a country. ASN selection runs across the whole proxy pool, so while a country is selected the ASN field stays visible but is disabled. To use ASN targeting, clear your country first by clicking the × on the country chip.
Note: Selecting a State doesn't narrow the City list — it still shows every city in the country. Since state and city can't be combined anyway, pick whichever level of targeting you need.
Availability: ZIP and ASN coverage changes over time as the proxy pool refreshes. If no matching IPs are available for your selection, try another value or remove the filter.
Important: Selecting a location in the interface alone does not apply filtering. The username in your setup is what determines it. Note that the ZIP code field maps to postalcode_ in the username, not zip_.
Your username should look like this:
Country:
username-us-rotateState:
username-us-state_arizona-rotateCity:
username-us-city_houston-rotateZIP code:
username-us-postalcode_77001-rotateASN:
username-asn_3-rotate
Session Types
The Endpoint Generator lets you choose between Rotating and Sticky sessions:
Rotating: works like our existing Rotating Proxy Endpoint connection method: each request connects through a different IP endpoint.
Sticky: keeps you on the same proxy IP for a set duration, set by a timer in your dashboard (anywhere from 1 minute to 24 hours).
Exporting Proxy Credentials
Once you've set your connection details, you'll find a ready-to-use test cURL command above your selected options, which you can run in Terminal or Command Prompt.
The endpoint output supports three formats:
Endpoint:Port
HTTP
SOCKS5
Under Number of Endpoints, choose how many proxies you need (up to 10,000). You can then copy your current output to your clipboard, or use Export As to download it as CSV, JSON, or TXT.
Alternative Gateway for p.webshare.io
If your program doesn't accept p.webshare.io, or your network rejects this host, you can use an alternative by following our Gateway IP Address guide. The same gateway IP addresses work across all of your connection methods.
Need Help?
For questions or additional assistance, feel free to reach out to our support team at [email protected]. We're here to help.