Proxy Access

Your customers connect with the credentials you give them. They don’t need an API key and never call the Reseller API. You build the proxy strings yourself. No endpoint returns a ready-made proxy line for a sub-user.

Residential Sub-Users

Host

residential.roundproxies.com:5000

HTTP, with sticky sessions.

Username Format

Targeting goes in the proxy username:

Username

client-<username>-country-<Country>-session-<sessionId>

Part	Description
`client-`	Fixed prefix
`<username>`	The sub-user’s username from the API
`<Country>`	The full country name, for example `UnitedStates`
`<sessionId>`	Any random string, for example 8 letters and numbers

The sub-user’s password is sent as is. Only the username gets the targeting added.

You can get the full list of supported countries, states and cities from GET /reseller/targeting. For rotating sessions or custom session lengths, contact support. Those are not part of the format above.

Sessions

The same session ID keeps the same IP. Use a new session ID to get a new IP. Use one session ID for each connection you want to run at the same time.

Full Proxy Line

As host:port:username:password:

Proxy format

residential.roundproxies.com:5000:client-acme_customer1-country-UnitedStates-session-x7k2m9pq:THE_PASSWORD

Testing a Connection

Python
cURL

Python

import requests

proxy = (
    "http://client-acme_customer1-country-UnitedStates-session-x7k2m9pq"
    ":THE_PASSWORD@residential.roundproxies.com:5000"
)

response = requests.get(
    "https://ipinfo.io/json",
    proxies={"http": proxy, "https": proxy},
)
print(response.json())

cURL

curl -x "http://client-acme_customer1-country-UnitedStates-session-x7k2m9pq:THE_PASSWORD@residential.roundproxies.com:5000" \
  https://ipinfo.io/json

You should see a residential IP in the country you asked for.

Usage

Traffic counts toward the sub-user’s data limit and shows up on the usage endpoints within moments. When rawUsed reaches rawTotal, the account stops working until you top it up.

Static Proxies

Datacenter and ISP allocations need no formatting. The API returns each IP with everything your customer needs:

Response

{ "ip": "1.2.3.4", "port": 8080, "username": "a1b2c3", "password": "d4e5f6", "region": "US" }

Proxy format

1.2.3.4:8080:a1b2c3:d4e5f6

There is no targeting, because the region is set when the IP is allocated, and no data limit. The IPs work until you release the allocation.

Getting Started

Residential Proxies

ISP Proxies

Datacenter Proxies

Reseller

Residential Sub-Users

Username Format

Sessions

Full Proxy Line

Testing a Connection

Usage

Static Proxies