Usage

HTTP Usage

The most basic way to use our Rotating Residential Proxy is to simply use the username and password that you signed up with, and use our provided single endpoint as the proxy URL.

curl --proxy "http://docs:[e-mail]:1337" https://ipinfo.io

This request will assign a completely random IP from our entire pool of IP's, and send the request to ipinfo.io to return information about the IP selected.

What if you want to use a specific country, instead of a random one? Very simple! Specify an additional parameter within your username, and our endpoint will route it to a proxy in that country.

curl --proxy "http://docs_country-us:[e-mail]:1337" https://ipinfo.io

This request will assign a random IP from the United States, and send the request to ipinfo.io. We have included a list of all countries supported at the bottom of the page.

So, you can send a request from a specific country, how about a specific city? Again, very simple! Specify an additional parameter alongside the country, and it will route it to a proxy from that Country and City combination.

curl --proxy "http://docs_country-gb_city-london:[e-mail]:1337" https://ipinfo.io

This request will assign a random IP from the United Kingdom, specific from London! We have includes a list of all supported countries/cities below.

What about sending a request from a selection of random countries/cities? This is also possible! Simply pass an array of the countries/cities as part of the username parameter, and a random country/city will be selected for each request.

curl --proxy "http://docs_country-gb,fr,us:[e-mail]:1337" https://ipinfo.io

This request will assign a random IP from either the United Kingdom, France or United States. There is no weight to each country, so it will be random on each request.

OK, what about if you want to keep the same IP address on each request, and it not be random? We also support this! We have sticky sessions that will last up to 90 minutes (our gateways rotate the IP's every 90 minutes, so it is dependent on when you send a request in this process). Simply append a session string at the end of the username parameter, and if you keep sending the same session string the IP will stay the same.

curl --proxy "http://docs_country-us_session-1:[e-mail]:1337" https://ipinfo.io

This request will ensure you always have the same IP address! It also supports the passing of multiple countries/cities, so it will always be the same IP per country until the session expires!

SOCKS5 Usage

We have created our own custom wrapper that allows all of our proxies to be used as both HTTP and SOCKS5 proxies on the same endpoint. While most of our connections are created as a HTTP proxy, there are times when our users require SOCKS proxies instead. Our proxies work in the exact same way whether you are using them as HTTP or SOCKS. Configure your software to use our socks proxy by providing the proxy endpoint proxy.suborbit.al:1337. Provide your authentication details in the same way you would with HTTP, you can even specify specific countries/cities, and sticky sessions.

WARNING: Due to how SOCKS sessions are established - being that they are a continuous connection, not individual requests, once a session has been established the IP address will not change until that connection is terminated or expires.

Countries

Country	Country Code
United States	US
United Kingdom	GB
Germany	DE
Canada	CA
Japan	JP
Australia	AU
India	IN
Thailand	TH
Mexico	MX
Brazil	BR
France	FR
Spain	ES
Italy	IT
Poland	PL
Hong Kong	HK
Russian Federation	RU
Indonesia	ID
United Arab Emirates	AE
Turkey	TR
Malaysia	MY
Korea, Republic of	KR
Taiwan	TW
Saudi Arabia	SA
Philippines	PH
Vietnam	VN
Afghanistan	AF
Albania	AL
Algeria	DZ
Angola	AO
Anguilla	AI
Antigua and Barbuda	AG
Argentina	AR
Armenia	AM
Aruba	AW
Austria	AT
Azerbaijan	AZ
Bahamas	BS
Bahrain	BH
Bangladesh	BD
Barbados	BB
Belarus	BY
Belgium	BE
Belize	BZ
Benin	BJ
Bolivia	BO
Bosnia and Herzegovina	BA
Botswana	BW
Bulgaria	BG
Cambodia	KH
Cameroon	CM
Cape Verde	CV
Cayman Islands	KY
Chile	CL
China	CN
Colombia	CO
Comoros	KM
Congo	CG
Costa Rica	CR
Croatia (Hrvatska)	HR
Cyprus	CY
Czech Republic	CZ
Brunei Darussalam	BN
Switzerland	CH
Ivory Coast	CI
Denmark	DK
Dominican Republic	DO
Ecuador	EC
Estonia	EE
Egypt	EG
Ethiopia	ET
Finland	FI
Georgia	GE
Ghana	GH
Guadeloupe	GP
Greece	GR
Guatemala	GT
Guyana	GY
Honduras	HN
Haiti	HT
Hungary	HU
Ireland	IE
Israel	IL
Iraq	IQ
Iran (Islamic Republic of)	IR
Iceland	IS
Jamaica	JM
Jordan	JO
Kenya	KE
Kyrgyzstan	KG
Kuwait	KW
Kazakhstan	KZ
Lao People's Democratic Republic	LA
Lebanon	LB
Saint Lucia	LC
Sri Lanka	LK
Lithuania	LT
Luxembourg	LU
Latvia	LV
Libyan Arab Jamahiriya	LY
Morocco	MA
Moldova, Republic of	MD
Montenegro	ME
Madagascar	MG
Macedonia	MK
Mali	ML
Myanmar	MM
Mongolia	MN
Macau	MO
Martinique	MQ
Malta	MT
Mauritius	MU
Maldives	MV
Mozambique	MZ
Namibia	NA
New Caledonia	NC
Nigeria	NG
Nicaragua	NI
Netherlands	NL
Norway	NO
Nepal	NP
New Zealand	NZ
Oman	OM
Panama	PA
Peru	PE
Pakistan	PK
Puerto Rico	PR
Palestine	PS
Portugal	PT
Paraguay	PY
Qatar	QA
Reunion	RE
Romania	RO
Serbia	RS
Seychelles	SC
Sudan	SD
Sweden	SE
Singapore	SG
Slovenia	SI
Slovakia	SK
Senegal	SN
Suriname	SR
El Salvador	SV
Syrian Arab Republic	SY
Tunisia	TN
Trinidad and Tobago	TT
Tanzania, United Republic of	TZ
Ukraine	UA
Uganda	UG
Uruguay	UY
Uzbekistan	UZ
Saint Vincent and the Grenadines	VC
Venezuela	VE
Kosovo	XK
Yemen	YE
South Africa	ZA
Zambia	ZM
Zimbabwe	ZW

Countries & Cities

55KB

cities.csv