Oxylabs Residential Proxies

How to Use OxyLabs Proxy [Part 2]: OxyLabs Residential Proxies Manual

Want to use OxyLabs' residential proxies? Then you can't miss this article. It is the most comprehensive OxyLabs residential proxies user guide.

Quick Start

This is by far the fastest way to start using Residential Proxies. You will make a request to https://ipinfo.io using a residential proxy from a random location through our Backconnect Entry. Don't forget to replace USERNAME and PASSWORD with your proxy user credentials.

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME:PASSWORD" https://ipinfo.io

Let's make a request using a proxy from France. All you need to do is add cc-FR to your username string. Below is an example in cURL, and here you can find code samples in other languages.

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-cc-FR:PASSWORD" https://ipinfo.io

Here is one more example of a request that goes through a proxy from London, United Kingdom. Adding cc-GB-city-london to username string enables you to do just that. Click here to get more information on how to master city-level proxy targeting.

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-cc-GB-city-london:PASSWORD" https://ipinfo.io

What if you want to keep the same proxy for more than one request? Session control enables that. Just add sessid-abc12345 to your username string, where abc12345 can be any random string, and as long as you keep sending requests with this string (session ID), we will try our best to give you the same proxy IP.

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-sessid-randomString123:PASSWORD" https://ipinfo.io

Check out our integration tutorials with the most popular 3rd party tools, such as MultiloginShadowRocket, or SwitchyOmega.

If you have any additional questions, please contact your account manager or our support team at [email protected].

To find out your usage statistics, generated traffic, request count and more, please login to dashboard.oxylabs.io. You can also add proxy users (subusers) and track their statistics separately.


Backconnect Entry Node

pr.oxylabs.io:7777

The single backconnect proxy enables to choose a specific country or city proxy via additional parameters in the username. This approach also supports session control. Below is a sample credentials structure:

customer-USERNAME-cc-US-city-CITY-sessid-abcde12345:PASSWORD
ParameterDescription
customerUsername
ccCase insensitive country code in 2-letter 3166-1 alpha-2 format. For example, DE for Germany, GB for United Kingdom, TH for Thailand. More details on how to use country-specific proxies can be found here.
cityCase insensitive city name in English. This parameter has to accompanied by cc for better accuracy. For example, cc-GB-city-london for London, United Kingdom; cc-DE-city-berlin for Berlin, Germany. For a city with more than two words, replace space with _, for example city-st_petersburg or city-rio_de_janeiro.

We support every city in the world, but we do not guarantee we will have proxies there. Most popular cities are well covered, and will have many proxies to choose from. For reference, you can check this list of what cities you can expect to find. Click here for more information on city-level targeting.

stCase insensitive US state name with us_ in the beginning, for example us_californiaus_illinois. Full list of supported cities in TXT format can be downloaded here.
sessidSession ID to keep the same IP with upcoming queries. Session expires after 10 minutes, after that a new IP is assigned to that ID. Random string; 0-9, A-z characters are supported.
passwordPassword

   – required parameter

We also support targeting by ASN number. It enables to choose proxies from specific carriers. This feature is enabled upon request.

If you add more than one location parameter in the username, the system will ignore all but one. Therefore it's important to understand which parameters get prioritized. The hierarchy is as follows:

  1. city
  2. state
  3. cc

For example, if your query has these parameters customer-username-cc-US-city-paris-st-us_california, you will get a proxy from Paris, US.


Entry Node for China

https://a81298871.com:8000 - Hong Kong
https://cnt9t1is.com:8000 - Beijing

For better connectivity from China, we have configured entry nodes in Hong Kong and Beijing regions. Note that it is an HTTPS proxy node. All username parameters are identical to the regular entry node.

Please note that some 3rd party tools currently do not work with Hong Kong and Beijing entry nodes. 3rd party tools that work with said entry nodes are:

      1. Oxylabs Proxy Manager
      2. SwitchyOmega
      3. Shadowrocket
      4. Postern

We are currently working on fixing the rest of the integrations on which HTTPS protocol will be supported.

If you are connecting to our residential network from China and still have issues with provided entry nodes, please get in touch at [email protected] and we will figure out a solution together.


Basic Query

Basic query only requires to pass username and password. No other parameters are needed. Such query will result in the request being made from a random IP address (proxy). Every new request will use a different proxy.

In this example a query to ipinfo.io is performed from a random IP:

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME:PASSWORD" https://ipinfo.io

Select Country

OxyLabs Residential Proxies Select Country

Adding cc flag to the authorization header enables to specify which country IP to use to process the request. The value of this parameter is a case insensitive country code in 2-letter 3166-1 alpha-2 format. For example, DE for Germany, GB for the United Kingdom, TH for Thailand proxy. See examples for more details.

In this example a query to ipinfo.io is performed from a random IP address from Germany:

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-cc-DE:PASSWORD" https://ipinfo.io

Select State

OxyLabs Residential Proxies Select State

To get proxy from a specified US state, add st flag to the authorization string. For example, us_californiaus_illinois. Full list of supported cities in TXT format can be downloaded here.

In this example a query to ipinfo.io is performed from a random IP address from California, USA:

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-st-us_california:PASSWORD" https://ipinfo.io

Select City

OxyLabs Residential Proxies Select City

To narrow down to a city-level targeting, a city parameter needs to be added. For example, cc-DE-city-munich means that a proxy from Munich, Germany, will handle the query. We support every city in the world, but we do not guarantee we will have proxies there. Most popular cities are well covered, and will have many proxies to choose from.

Here are a few examples of valid combinations of cc and city parameters:
cc-US-city-los_angeles
cc-IT-city-rome
cc-TH-city-bangkok
cc-JP-city-tokyo
cc-AU-city-sydney
cc-ES-city-barcelona

In this example a query to ipinfo.io is performed from a random IP address from Munich, Germany:

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-cc-DE-city-munich:PASSWORD" https://ipinfo.io

Session Control

OxyLabs Residential Proxies Session Control

Adding sessid parameter with session ID string, for example sessid-abc12345, enables session control. This means that the proxy will not change with the following requests. The example below shows how session control works:

session-control

The system keeps the same IP associated with a particular session ID as long as there is some activity (requests). After 60 seconds of inactivity, the IP is automatically changed to a different one.

For example: * Your initial query with sessid-random123 got assigned proxy IP address 1.1.1.1 * As long as you keep sending new requests with the same session ID and that IP address is online and available, the system will route your queries through 1.1.1.1 * If you stop sending requests or the IP address is no longer online, the system will assign a new proxy IP after 60 seconds. * This means that your next query with sessid-random123 will be routed through a different IP address.

Standard session time is 10 minutes, but it can be increased. Contact your account manager to learn more.

German IP will be chosen for the first request, and then the same IP will be kept with new queries (session control):

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-cc-DE-sessid-abcde12345:PASSWORD" https://ipinfo.io

Country Specific Entry Nodes

Random Proxy Entry Nodes

Oxylabs residential network has coverage in almost every country in the world. Country-specific random proxy entry point will return new IP with every new request.

You do not need to pass any additional parameters, just customer-username:password. If you have whitelisted IPs, you do not need to pass login credentials. Country-specific ports do not support city-level results.

Please see the dashboard for entry point information or download a full list of random entry points in XLS here.

RandomUSACanada
pr.oxylabs.io:7777us-pr.oxylabs.io:10000ca-pr.oxylabs.io:30000
GBGermanyFrance
gb-pr.oxylabs.io:20000de-pr.oxylabs.io:30000fr-pr.oxylabs.io:40000
SpainItalySweden
es-pr.oxylabs.io:10000it-pr.oxylabs.io:20000se-pr.oxylabs.io:30000
GreecePortugalNetherlands
gr-pr.oxylabs.io:40000pt-pr.oxylabs.io:10000nl-pr.oxylabs.io:20000
BelgiumRussiaUkraine
be-pr.oxylabs.io:30000ru-pr.oxylabs.io:40000ua-pr.oxylabs.io:10000
PolandIsraelTurkey
pl-pr.oxylabs.io:20000il-pr.oxylabs.io:20000tr-pr.oxylabs.io:30000
AustraliaMalaysiaThailand
au-pr.oxylabs.io:40000my-pr.oxylabs.io:10000th-pr.oxylabs.io:20000
South KoreaJapanPhilippines
kr-pr.oxylabs.io:30000jp-pr.oxylabs.io:40000ph-pr.oxylabs.io:10000
SingaporeChinaHong Kong
sg-pr.oxylabs.io:20000cn-pr.oxylabs.io:30000hk-pr.oxylabs.io:40000
TaiwanIndiaPakistan
tw-pr.oxylabs.io:10000in-pr.oxylabs.io:20000pk-pr.oxylabs.io:30000
IranIndonesiaAzerbaijan
ir-pr.oxylabs.io:40000id-pr.oxylabs.io:10000az-pr.oxylabs.io:20000
KazakhstanUAEMexico
kz-pr.oxylabs.io:30000ae-pr.oxylabs.io:40000mx-pr.oxylabs.io:10000
BrazilArgentinaChile
br-pr.oxylabs.io:20000ar-pr.oxylabs.io:30000cl-pr.oxylabs.io:40000
PeruEcuadorColombia
pe-pr.oxylabs.io:10000ec-pr.oxylabs.io:20000co-pr.oxylabs.io:30000
South AfricaEgyptAngola
za-pr.oxylabs.io:40000eg-pr.oxylabs.io:10000ao-pr.oxylabs.io:40000
CameroonCentral African RepublicChad
cm-pr.oxylabs.io:41000cf-pr.oxylabs.io:42000td-pr.oxylabs.io:43000
BeninEthiopiaDjibouti
bj-pr.oxylabs.io:44000et-pr.oxylabs.io:45000dj-pr.oxylabs.io:46000
GambiaGhanaCôte d'Ivoire
gm-pr.oxylabs.io:47000gh-pr.oxylabs.io:48000ci-pr.oxylabs.io:49000
KenyaLiberiaMadagascar
ke-pr.oxylabs.io:10000lr-pr.oxylabs.io:11000mg-pr.oxylabs.io:12000
MaliMauritaniaMauritius
ml-pr.oxylabs.io:13000mr-pr.oxylabs.io:14000mu-pr.oxylabs.io:15000
MoroccoMozambiqueNigeria
ma-pr.oxylabs.io:16000mz-pr.oxylabs.io:17000ng-pr.oxylabs.io:18000
SenegalSeychellesZimbabwe
sn-pr.oxylabs.io:19000sc-pr.oxylabs.io:20000zw-pr.oxylabs.io:21000
South SudanSudanTogo
ss-pr.oxylabs.io:22000sd-pr.oxylabs.io:23000tg-pr.oxylabs.io:24000
TunisiaUgandaZambia
tn-pr.oxylabs.io:25000ug-pr.oxylabs.io:26000zm-pr.oxylabs.io:27000
AfghanistanBahrainBangladesh
af-pr.oxylabs.io:28000bh-pr.oxylabs.io:29000bd-pr.oxylabs.io:30000
ArmeniaBhutanMyanmar
am-pr.oxylabs.io:31000bt-pr.oxylabs.io:32000mm-pr.oxylabs.io:33000
CambodiaGeorgiaIraq
kh-pr.oxylabs.io:34000ge-pr.oxylabs.io:36000iq-pr.oxylabs.io:37000
JordanLebanonMaldives
jo-pr.oxylabs.io:38000lb-pr.oxylabs.io:39000mv-pr.oxylabs.io:40000
MongoliaOmanQatar
mn-pr.oxylabs.io:41000om-pr.oxylabs.io:42000qa-pr.oxylabs.io:43000
Saudi ArabiaVietnamTurkmenistan
sa-pr.oxylabs.io:44000vn-pr.oxylabs.io:45000tm-pr.oxylabs.io:46000
UzbekistanYemenAlbania
uz-pr.oxylabs.io:47000ye-pr.oxylabs.io:48000al-pr.oxylabs.io:49000
AndorraAustriaBosnia and Herzegovina
ad-pr.oxylabs.io:10000at-pr.oxylabs.io:11000ba-pr.oxylabs.io:13000
BulgariaBelarusCroatia
bg-pr.oxylabs.io:14000by-pr.oxylabs.io:15000hr-pr.oxylabs.io:16000
CyprusCzech RepublicDenmark
cy-pr.oxylabs.io:35000cz-pr.oxylabs.io:18000dk-pr.oxylabs.io:19000
EstoniaFinlandHungary
ee-pr.oxylabs.io:20000fi-pr.oxylabs.io:21000hu-pr.oxylabs.io:23000
IcelandIrelandLatvia
is-pr.oxylabs.io:24000ie-pr.oxylabs.io:25000lv-pr.oxylabs.io:26000
LiechtensteinLithuaniaLuxembourg
li-pr.oxylabs.io:27000lt-pr.oxylabs.io:28000lu-pr.oxylabs.io:29000
MaltaMonacoMoldova
mt-pr.oxylabs.io:30000mc-pr.oxylabs.io:31000md-pr.oxylabs.io:32000
MontenegroNorwayRomania
me-pr.oxylabs.io:33000no-pr.oxylabs.io:34000ro-pr.oxylabs.io:35000
SerbiaSlovakiaSlovenia
rs-pr.oxylabs.io:36000sk-pr.oxylabs.io:37000si-pr.oxylabs.io:38000
SwitzerlandMacedoniaBahamas
ch-pr.oxylabs.io:39000mk-pr.oxylabs.io:40000bs-pr.oxylabs.io:41000
BelizeBritish Virgin IslandsCosta Rica
bz-pr.oxylabs.io:42000vg-pr.oxylabs.io:43000cr-pr.oxylabs.io:44000
CubaDominicaHaiti
cu-pr.oxylabs.io:45000dm-pr.oxylabs.io:46000ht-pr.oxylabs.io:47000
HondurasJamaicaAruba
hn-pr.oxylabs.io:48000jm-pr.oxylabs.io:49000aw-pr.oxylabs.io:10000
PanamaPuerto RicoTrinidad and Tobago
pa-pr.oxylabs.io:11000pr-pr.oxylabs.io:12000tt-pr.oxylabs.io:13000
FijiNew ZealandBolivia
fj-pr.oxylabs.io:14000nz-pr.oxylabs.io:15000bo-pr.oxylabs.io:16000
ParaguayUruguayVenezuela
py-pr.oxylabs.io:17000uy-pr.oxylabs.io:18000ve-pr.oxylabs.io:19000

In this example a query to ipinfo.io is performed from a random Turkey IP:

curl -x tr-pr.oxylabs.io:30000 -U "customer-USERNAME:PASSWORD" https://ipinfo.io
pr.oxylabs.io:7777
us-pr.oxylabs.io:10000
ca-pr.oxylabs.io:30000
gb-pr.oxylabs.io:20000
de-pr.oxylabs.io:30000
fr-pr.oxylabs.io:40000
es-pr.oxylabs.io:10000
it-pr.oxylabs.io:20000
se-pr.oxylabs.io:30000
gr-pr.oxylabs.io:40000
pt-pr.oxylabs.io:10000
nl-pr.oxylabs.io:20000
be-pr.oxylabs.io:30000
ru-pr.oxylabs.io:40000
ua-pr.oxylabs.io:10000
pl-pr.oxylabs.io:20000
il-pr.oxylabs.io:20000
tr-pr.oxylabs.io:30000
au-pr.oxylabs.io:40000
my-pr.oxylabs.io:10000
th-pr.oxylabs.io:20000
kr-pr.oxylabs.io:30000
jp-pr.oxylabs.io:40000
ph-pr.oxylabs.io:10000
sg-pr.oxylabs.io:20000
cn-pr.oxylabs.io:30000
hk-pr.oxylabs.io:40000
tw-pr.oxylabs.io:10000
in-pr.oxylabs.io:20000
pk-pr.oxylabs.io:30000
ir-pr.oxylabs.io:40000
id-pr.oxylabs.io:10000
az-pr.oxylabs.io:20000
kz-pr.oxylabs.io:30000
ae-pr.oxylabs.io:40000
mx-pr.oxylabs.io:10000
br-pr.oxylabs.io:20000
ar-pr.oxylabs.io:30000
cl-pr.oxylabs.io:40000
pe-pr.oxylabs.io:10000
ec-pr.oxylabs.io:20000
co-pr.oxylabs.io:30000
za-pr.oxylabs.io:40000
eg-pr.oxylabs.io:10000
sa-pr.oxylabs.io:44000
dk-pr.oxylabs.io:19000
ao-pr.oxylabs.io:40000
cm-pr.oxylabs.io:41000
cf-pr.oxylabs.io:42000
td-pr.oxylabs.io:43000
bj-pr.oxylabs.io:44000
et-pr.oxylabs.io:45000
dj-pr.oxylabs.io:46000
gm-pr.oxylabs.io:47000
gh-pr.oxylabs.io:48000
ci-pr.oxylabs.io:49000
ke-pr.oxylabs.io:10000
lr-pr.oxylabs.io:11000
mg-pr.oxylabs.io:12000
ml-pr.oxylabs.io:13000
mr-pr.oxylabs.io:14000
mu-pr.oxylabs.io:15000
ma-pr.oxylabs.io:16000
mz-pr.oxylabs.io:17000
ng-pr.oxylabs.io:18000
sn-pr.oxylabs.io:19000
sc-pr.oxylabs.io:20000
zw-pr.oxylabs.io:21000
ss-pr.oxylabs.io:22000
sd-pr.oxylabs.io:23000
tg-pr.oxylabs.io:24000
tn-pr.oxylabs.io:25000
ug-pr.oxylabs.io:26000
zm-pr.oxylabs.io:27000
af-pr.oxylabs.io:28000
bh-pr.oxylabs.io:29000
bd-pr.oxylabs.io:30000
am-pr.oxylabs.io:31000
bt-pr.oxylabs.io:32000
mm-pr.oxylabs.io:33000
kh-pr.oxylabs.io:34000
ge-pr.oxylabs.io:36000
iq-pr.oxylabs.io:37000
jo-pr.oxylabs.io:38000
lb-pr.oxylabs.io:39000
mv-pr.oxylabs.io:40000
mn-pr.oxylabs.io:41000
om-pr.oxylabs.io:42000
qa-pr.oxylabs.io:43000
sa-pr.oxylabs.io:44000
vn-pr.oxylabs.io:45000
tm-pr.oxylabs.io:46000
uz-pr.oxylabs.io:47000
ye-pr.oxylabs.io:48000
al-pr.oxylabs.io:49000
ad-pr.oxylabs.io:10000
at-pr.oxylabs.io:11000
ba-pr.oxylabs.io:13000
bg-pr.oxylabs.io:14000
by-pr.oxylabs.io:15000
hr-pr.oxylabs.io:16000
cy-pr.oxylabs.io:35000
cz-pr.oxylabs.io:18000
dk-pr.oxylabs.io:19000
ee-pr.oxylabs.io:20000
fi-pr.oxylabs.io:21000
hu-pr.oxylabs.io:23000
is-pr.oxylabs.io:24000
ie-pr.oxylabs.io:25000
lv-pr.oxylabs.io:26000
li-pr.oxylabs.io:27000
lt-pr.oxylabs.io:28000
lu-pr.oxylabs.io:29000
mt-pr.oxylabs.io:30000
mc-pr.oxylabs.io:31000
md-pr.oxylabs.io:32000
me-pr.oxylabs.io:33000
no-pr.oxylabs.io:34000
ro-pr.oxylabs.io:35000
rs-pr.oxylabs.io:36000
sk-pr.oxylabs.io:37000
si-pr.oxylabs.io:38000
ch-pr.oxylabs.io:39000
mk-pr.oxylabs.io:40000
bs-pr.oxylabs.io:41000
bz-pr.oxylabs.io:42000
vg-pr.oxylabs.io:43000
cr-pr.oxylabs.io:44000
cu-pr.oxylabs.io:45000
dm-pr.oxylabs.io:46000
ht-pr.oxylabs.io:47000
hn-pr.oxylabs.io:48000
jm-pr.oxylabs.io:49000
aw-pr.oxylabs.io:10000
pa-pr.oxylabs.io:11000
pr-pr.oxylabs.io:12000
tt-pr.oxylabs.io:13000
fj-pr.oxylabs.io:14000
nz-pr.oxylabs.io:15000
bo-pr.oxylabs.io:16000
py-pr.oxylabs.io:17000
uy-pr.oxylabs.io:18000
ve-pr.oxylabs.io:19000
kw-pr.oxylabs.io:20000

Sticky Proxy Entry Nodes

Country-specific sticky proxy entry point will return the same IP with every new request while you will use the same port. IP stickiness works for up to 10 minutes. After that, the IP is replaced with a new one.

You do not need to pass any additional parameters, just customer-username:password. If you have whitelisted IPs, you do not need to pass login credentials. Country-specific ports do not support city-level results.

Please see the dashboard for entry point information or download a full list of sticky entry points in XLS here.

RandomUSACanada
pr.oxylabs.io:10000 – 49999us-pr.oxylabs.io:10001 – 19999ca-pr.oxylabs.io:30001 – 39999
Great BritainGermanyFrance
gb-pr.oxylabs.io:20001 – 29999de-pr.oxylabs.io:30001 – 39999fr-pr.oxylabs.io:40001 – 49999
SpainItalySweden
es-pr.oxylabs.io:10001 – 19999it-pr.oxylabs.io:20001 – 29999se-pr.oxylabs.io:30001 – 39999
GreecePortugalNetherlands
gr-pr.oxylabs.io:40001 – 49999pt-pr.oxylabs.io:10001 – 19999nl-pr.oxylabs.io:20001 – 29999
BelgiumRussiaUkraine
be-pr.oxylabs.io:30001 – 39999ru-pr.oxylabs.io:40001 – 49999ua-pr.oxylabs.io:10001 – 19999
PolandIsraelTurkey
pl-pr.oxylabs.io:20001 – 29999il-pr.oxylabs.io:20001 – 29999tr-pr.oxylabs.io:30001 – 39999
AustraliaMalaysiaThailand
au-pr.oxylabs.io:40001 – 49999my-pr.oxylabs.io:10001 – 19999th-pr.oxylabs.io:20001 – 29999
South KoreaJapanPhilippines
kr-pr.oxylabs.io:30001 – 39999jp-pr.oxylabs.io:40001 – 49999ph-pr.oxylabs.io:10001 – 19999
SingaporeChinaHong Kong
sg-pr.oxylabs.io:20001 – 29999cn-pr.oxylabs.io:30001 – 39999hk-pr.oxylabs.io:40001 – 49999
TaiwanIndiaPakistan
tw-pr.oxylabs.io:10001 – 19999in-pr.oxylabs.io:20001 – 29999pk-pr.oxylabs.io:30001 – 39999
IranIndonesiaAzerbaijan
ir-pr.oxylabs.io:40001 – 49999id-pr.oxylabs.io:10001 – 19999az-pr.oxylabs.io:20001 – 29999
KazakhstanUAEMexico
kz-pr.oxylabs.io:30001 – 39999ae-pr.oxylabs.io:40001 – 49999mx-pr.oxylabs.io:10001 – 19999
BrazilArgentinaChile
br-pr.oxylabs.io:20001 – 29999ar-pr.oxylabs.io:30001 – 39999cl-pr.oxylabs.io:40001 – 49999
PeruEcuadorColombia
pe-pr.oxylabs.io:10001 – 19999ec-pr.oxylabs.io:20001 – 29999co-pr.oxylabs.io:30001 – 39999
South AfricaEgyptSaudi Arabia
za-pr.oxylabs.io:40001 – 49999eg-pr.oxylabs.io:10001 – 19999sa-pr.oxylabs.io:44001 – 44999
Denmark
dk-pr.oxylabs.io:19001 – 19999

In this example, a query to ipinfo.io is performed from Turkey IP, and the same IP will stay for up to 10 minutes with each request. We have chosen port 30001, however, Turkey sticky entry points cover ports from 30001 to 39999.

curl -x tr-pr.oxylabs.io:30001 -U "customer-USERNAME:PASSWORD" https://ipinfo.io
pr.oxylabs.io:10000 - 49999
us-pr.oxylabs.io:10001 - 19999
ca-pr.oxylabs.io:30001 - 39999
gb-pr.oxylabs.io:20001 - 29999
de-pr.oxylabs.io:30001 - 39999
fr-pr.oxylabs.io:40001 - 49999
es-pr.oxylabs.io:10001 - 19999
it-pr.oxylabs.io:20001 - 29999
se-pr.oxylabs.io:30001 - 39999
gr-pr.oxylabs.io:40001 - 49999
pt-pr.oxylabs.io:10001 - 19999
nl-pr.oxylabs.io:20001 - 29999
be-pr.oxylabs.io:30001 - 39999
ru-pr.oxylabs.io:40001 - 49999
ua-pr.oxylabs.io:10001 - 19999
pl-pr.oxylabs.io:20001 - 29999
il-pr.oxylabs.io:20001 - 29999
tr-pr.oxylabs.io:30001 - 39999
au-pr.oxylabs.io:40001 - 49999
my-pr.oxylabs.io:10001 - 19999
th-pr.oxylabs.io:20001 - 29999
kr-pr.oxylabs.io:30001 - 39999
jp-pr.oxylabs.io:40001 - 49999
ph-pr.oxylabs.io:10001 - 19999
sg-pr.oxylabs.io:20001 - 29999
cn-pr.oxylabs.io:30001 - 39999
hk-pr.oxylabs.io:40001 - 49999
tw-pr.oxylabs.io:10001 - 19999
in-pr.oxylabs.io:20001 - 29999
pk-pr.oxylabs.io:30001 - 39999
ir-pr.oxylabs.io:40001 - 49999
id-pr.oxylabs.io:10001 - 19999
az-pr.oxylabs.io:20001 - 29999
kz-pr.oxylabs.io:30001 - 39999
ae-pr.oxylabs.io:40001 - 49999
mx-pr.oxylabs.io:10001 - 19999
br-pr.oxylabs.io:20001 - 29999
ar-pr.oxylabs.io:30001 - 39999
cl-pr.oxylabs.io:40001 - 49999
pe-pr.oxylabs.io:10001 - 19999
ec-pr.oxylabs.io:20001 - 29999
co-pr.oxylabs.io:30001 - 39999
za-pr.oxylabs.io:40001 - 49999
eg-pr.oxylabs.io:10001 - 19999
sa-pr.oxylabs.io:44001 - 44999
dk-pr.oxylabs.io:19001 - 19999

Additional Information

Country, State, City Mapping

We use MaxMind GeoIP2 database to assign our exit nodes ccst and city values. This database is updated weekly.

Some other public IP databases may show different locations. In cases where location mismatch is crucial, we encourage to double-check if the location of the assigned proxy is the same on the IP database used by the target website.


Response Codes

These are the most common response codes that you can get while using our residential proxy pool. If you receive any other response code, get in touch with your dedicated account manager for more information.

ResponseDescription
400 Bad RequestProxy server can return this error code if the request did not contain a host to connect to or there was a generic error when parsing HTTP request. Make sure your request is correctly formed and make sure to include URL in the request then try again.
407 Proxy Authentication RequiredRequest lacks proxy authentication information or username or password is invalid. Include Proxy-Authorization header in your request and make sure your username and password are correctly formed and then try again.
500 Internal Server ErrorProxy server has encountered an internal error. Retry request at a later time.
502 Bad GatewayProxy server received an invalid response from the upstream server. Retry request.

Response Code 502 signifies that the IP assigned to your session ID is no longer available. If you encounter this error, there are two ways to work around it. The first is to wait for one minute and the system will automatically assign a new IP address to your session ID. Another approach is to simply switch to a new session ID (i.e. change the sessid parameter) – this way you will receive a new IP address.

522 TimeoutProxy server did not receive a response from the upstream server in time. Retry request.
525 No Exit FoundCustom HTTP status code – this means proxy was unable to find an exit node which satisfies the request. Change request filter parameters or try again at a later time.

Backconnect Entry IPs

If you want to use your own backconnect entry node DNS name, you can do that by pointing your subdomain/domain to our entry node. To do that, you need to add a DNS CNAME record that has pr.oxylabs.io as the target. This is how such setup looks on Cloudflare DNS manager for entry subdomain:

OxyLabs Residential Proxies Backconnect Entry IPs

For more information, please contact [email protected] or your account manager.


Restricted URLs

To avoid abuse and unclear activities, some websites are restricted on our residential proxy network. The list includes, but is not limited to websites such as all Google domains including Play, linkedin.com, sonyentertainmentnetwork.com, all Apple domains, including iTunes, netflix.com and others. For more information please contact our support staff at [email protected].


Public API

To manage proxy users via Public API, please refer to this documentation in OpenAPI format. The API allows to create, delete, and modify proxy users, set their limits and see current usage, disable and enable them.


3rd Party Integrations

Please note that you must use an HTTPS protocol when accessing China entry nodes for 3rd party tools to work correctly.

Oxylabs Proxy Manager

Oxylabs Proxy Manager is a proxy management extension for Chrome. It is not only free but also works with any proxy provider of your choice. Enable your proxy without having to jump through settings and menu options. The extension has an additional feature specifically designed to use with Oxylabs Residential Proxies, which enables to easily change Oxylabs Residential Proxy session without editing your username. Download the extension from Chrome Web Store here

  • Click the extension icon to open the application
  • If you haven't added any proxies yet, you will see Add new proxy button. Click it to continue.

OxyLabs Residential Proxy Manager1

  • Add proxy profile. Provide a name for the profile under Enter name. Enter pr.oxylabs.io as Proxy server IP and 7777 as Port. Fill in your Username and Password. Do not forget to add customer- before your username. Finally, click Save changes.

You can also use country-specific entries. For example, if you put us-pr.oxylabs.io under Proxy server IP and 10001 under Port, you will receive US exit node with sticky session.

If you have whitelisted your IP, you can skip this step.

OxyLabs Residential Proxy Manager2

  • Open the extension and click Connect. That's it, you are now using proxies.

OxyLabs Residential Proxy Manager3

  • Chrome is notorious for caching proxy credentials, and on many proxy management extensions sticky sessions via username string does not work. If you are using sessions with main entry node (pr.oxylabs.io:7777), we created a special feature that allows rotating session much more easily. First, enter your username with sessid parameter, like this:

OxyLabs Residential Proxy Manager4

  • Then, open the extenion window. Connect to the proxy and you will see a new button – Refresh session. Click it to change session ID and get a new proxy.

OxyLabs Residential Proxy Manager5


SwitchyOmega

SwitchyOmega is a powerful and reliable proxy manager that works with many popular browsers. First you need to get the plugin. For Chrome, click here, for Firefox click here. Once you have it installed, you should:

  • Open Switchy Omega options.

OxyLabs Residential Proxy SwitchyOmega1

  • Click New profile….

OxyLabs Residential Proxy SwitchyOmega2

  • Give this new profile a name, choose Proxy Profile type and click Create

OxyLabs Residential Proxy SwitchyOmega3

  • Change Protocol to HTTP. Under Server enter our backconnect entry node pr.oxylabs.io. Under Port add 7777

OxyLabs Residential Proxy SwitchyOmega4

  • You can also use country-specific entries. For example, if you put us-pr.oxylabs.io under Server and 10001 under Port, you will receive US exit node with sticky session.
  • Next, click the lock button on the right. Fill in your Username and Password. Do not forget to add customer- before your given username. Finally, click Save changes.

If you have whitelisted your IP, please skip this step.

OxyLabs Residential Proxy SwitchyOmega5

  • Click Apply changes

OxyLabs Residential Proxy SwitchyOmega6

  • For the final step, click on SwitchyOmega icon and choose your newly configured proxy. You are now ready to go!

OxyLabs Residential Proxy SwitchyOmega7


Shadowrocket

If you want to use our Residential Proxies with Shadowrocket, you can easily do that by following the instructions below.

  • Open Shadowrocket app.
  • Click Add Server.

OxyLabs Residential Proxy Shadowrocket1

  • In the following window click on Type.

OxyLabs Residential Proxy Shadowrocket2

  • Choose HTTP and go back to the previous screen.

OxyLabs Residential Proxy Shadowrocket3

  • Enter proxy and authentication information. Under Host type in pr.oxylabs.ioPort is 7777 to use our backconnect entry. Do not forget your crendentials under User and Password. Do not forget to add customer- before your given username. Once you are done, go back to the previous screen by pressing Back arrow.

You can also use country-specific entries. For example, if you put us-pr.oxylabs.io under Host and 10001 under Port, you will receive US exit node with a sticky session.

OxyLabs Residential Proxy Shadowrocket4

  • You need to turn proxy on. Do that by activating a toggle under Not Connected

OxyLabs Residential Proxy Shadowrocket5

  • If that is your first time using Shadowrocket, you will get an iOS prompt to add Shadowrocket to VPN configurations. Click Add. You will need to enter your iPhone passcode to confirm.

OxyLabs Residential Proxy Shadowrocket6

  • That is it. A toggle at the top of the app should now be activated.

OxyLabs Residential Proxy Shadowrocket7

  • You can test if the proxy is working by visiting icanhazip.com.

OxyLabs Residential Proxy Shadowrocket8


Proxifier

If you want to use our Residential Proxies with Proxfier, you can easily do that by following the instructions below.

  • Open Proxifier app.
  • Add proxies. Click on Proxies (1). Click Add(2).

OxyLabs Residential Proxy Proxifier1

  • In the following window enter required information. Address(1), which is pr.oxylabs.ioPort(2) which is 7777, select HTTPS(3) protocol. In authentication box click Enable(4) and enter provided Username(5) and Password(6). Do not forget to add customer- at the beginning of the username. If you have whitelisted your devices, do not click on Enable, your authenticiation will be done without username/password. If you wish, you can enable Appear as Web Browser option. Click OK.
  • You can also use country-specific entries. For example, if you put us-pr.oxylabs.io under Address(1)* and **10001 under Port(2), you will receive US exit node with sticky session.

OxyLabs Residential Proxy Proxifier2

  • You will be prompted with a window asking if you want Proxifier to use this proxy by default? This means that this setup will be user for all of your browsers. It is up to you to decide. If you select Yes, you are done setting up. If you wish to use proxies on a particular browser, follow the next steps.
  • Click on Rules(1) and then click Add…(2).

OxyLabs Residential Proxy Proxifier3

  • Click +(1) button to add applications that you want to use proxy settings. Select the browser with which you want to use these proxy settings and click on it. Finally, you have to change Action(2). Click on it and select your created proxy.

OxyLabs Residential Proxy Proxifier4

  • This is it, all of your requests, while using browser which you defined in your rules of Proxifier, will be done from proxies.

Multilogin

Our proxies also work with Multilogin app. Setting up is easy, just follow the instructions below.

  • Open Multilogin app.
  • Add proxies. Click on Create new under Browser profile.
  • In the following window enter Browser profile name (for example Oxylabs). Next, click Edit proxy settings.
  • Choose HTTP proxy as Connection type. Now fill in the required details: under New address and Port insert pr.oxylabs.io and 7777. Under Login enter your username, and Password. Do not forget to add customer- at the beginning of the username. If you have whitelisted your devices, you do not need to provide the login credentials.
  • You can also use country-specific entries. For example, if you put us-pr.oxylabs.io under New address and 10001 under Port, you will receive US exit node with a sticky session.
  • Click Check proxy. If everything is fine, you should get a response indicating External IP.
  • Confirm changes by clicking Create profile.
  • This is it, you are good to go.

Postern

Postern is a very popular proxy/VPN management application on Android. You can get it on Google Play Store. Here is a step-by-step guide how to configure our Residential Proxies on Postern:

  • Open the app.
  • Click Add Proxy.

OxyLabs Residential Proxy Postern1

  • In the following window enter required proxy information. Server Name is OxylabsServer Address is pr.oxylabs.io. Under Server Port enter 7777. Click Server Type and choose HTTPS/HTTP CONNECT. Next, enter your login credentials under Username and Password. For this to work, you must type customer- before you type in your username, e.g., customer-username.Finally, click Save.

You can also use country-specific entries. For example, if you put us-pr.oxylabs.io under Server Address and 10001 under Server Port, you will receive the US exit node with sticky session.

OxyLabs Residential Proxy Postern2

  • Now, open the app menu and go to Rules.

OxyLabs Residential Proxy Postern3

  • Click Add Rule

OxyLabs Residential Proxy Postern4

  • Under Match Method select Match All. Choose Proxy/Tunnel as the RuleProxy/Proxy Group should automatically fill up with Oxylabs – pr.oxylabs.io:7777″. Click Save.

OxyLabs Residential Proxy Postern5

  • Now you need to turn on the VPN. Open the app menu and click on VPN Off to activate the connection. That is it, you are now using proxies.

OxyLabs Residential Proxy Postern6


GoLogin

GoLogin is a multi-login browser management application for Windows, Linux and Mac OS. Get it on its official website here. Here is a step-by-step guide how to configure our Residential Proxies on GoLogin for Windows:

  • Open the app.
  • Click Create Your First Profile.

OxyLabs Residential Proxy GoLogin1

  • In the following window enter the required proxy information. Under Profile Name write Oxylabs. Next, choose Connection Type as HTTP Proxy. Under Proxy Host and Port enter pr.oxylabs.io and 7777. Next, enter your login credentials under Username and Password. Finally, click Create Profile.

You can also use country-specific entries. For example, if you put us-pr.oxylabs.io and 10001 under Proxy Host and Port, you will receive the US exit node with a sticky session. To fully utilize all available Residential Proxies features such as sessions and countrystatecity geolocation parameters, please reffer to the corresponding sections in the documentation.

OxyLabs Residential Proxy GoLogin2

  • All set, now simply click Run and wait for the browser to load.

OxyLabs Residential Proxy GoLogin3

    • If everything is fine, a website http://myip.gologin.app will open and show the IP information.

OxyLabs Residential Proxy GoLogin4


Kameleo

Kameleo is a multi-login browser management application for Windows and Android. Get it on its official website here. Here is a step-by-step guide how to configure our Residential Proxies on Kameleo for Windows:

  • Open the app.
  • Click APPLICATION SETTINGS.

OxyLabs Residential Proxy Kameleo1

  • In the following window enter the required proxy information under Global proxy settings. For Upstream Proxy Type choose Http. Next, fill in Proxy IP or hostname with pr.oxylabs.io. Under Proxy Port enter 7777. Finally, enter your login credentials under Username and Password. Close the window to save settings.

You can also use country-specific entries. For example, if you put us-pr.oxylabs.io under Proxy IP or hostname and 10001 under Proxy Port, you will receive the US exit node with a sticky session.

OxyLabs Residential Proxy Kameleo2

  • That is it, you are ready to go. Either create a NEW PROFILE or click QUICK PROFILE to launch the browser which now has proxy enabled.

ClonBrowser

ClonBrowser is another multi-login browser management application for Windows and Mac. Get it on its official website here. Here is a step-by-step guide how to configure our Residential Proxies on ClonBrowser for Windows:

  • Open the app.
  • Click Create a New browser profile.

OxyLabs Residential Proxy ClonBrowser1

  • Click Setting next to Proxy settings.

OxyLabs Residential Proxy ClonBrowser2

  • In the following window choose Http as the Connection type. Under IP or host enter pr.oxylabs.io. Fill in 7777 for Port. Finally, enter your login credentials under Username in customer-username format and Password.

You can also use country-specific entries. For example, if you put us-pr.oxylabs.io under Proxy IP or hostname and 10001 under Proxy Port, you will receive the US exit node with a sticky session.

You can check if the proxy works by clicking Connection test. If everything is fine, click Create profile.

  • That is all, you can now launch the browser by clicking Start under Option.

OxyLabs Residential Proxy ClonBrowser3


AdsPower

AdsPower is a multi-login browser management application for Windows and Mac. You get it on its official website here. Here is the step-by-step guide how to configure our Residential Proxies on AdsPower for Windows:

  • Open the app.
  • Click Upload..

OxyLabs Residential Proxy AdsPower1

  • Under Proxy Type choose http. Now fill in the form bellow. Enter pr.oxylabs.io for Proxy Host and 7777 for Proxy Port. Enter your login credentials customer-username under Proxy User and your password for Password.

You can also use country specific entries. For example, if you put us-pr.oxylabs.io under Proxy Host and 10001 under *Proxy Port, you will receive US exit node with sticky session.

You can check if the proxy works by clicking Check Proxy. If everything is fine, click Create profile.

OxyLabs Residential Proxy AdsPower2

  • That's all, you can now launch the browser by clicking Open under Account Management.

OxyLabs Residential Proxy AdsPower3


VMLogin

Virtual Multi Login, or VMLogin, is a tool for creating virtual browser profiles that help control browser fingerprinting, setup business workflows, and develop web automation, among other things. To use VMLogin with Oxylabs Residential Proxies, download the latest version of VMLogin here.

  • Launch VMLogin and create a new browser profile. You can either click Get random profile (1), or select your settings.
  • Click on Setting proxy server (2)

OxyLabs Residential Proxy VMLogin1

  • Create a new Residential Proxy user.

OxyLabs Residential Proxy VMLogin2

  • Click on Setting proxy server and choose HTTP Proxy as the Connection type. Under IP or host enter pr.oxylabs.io. Fill in 7777 for Port. Finally, enter your login credentials under Username (in customer-username format) and Password. You can check if the proxy works by clicking Test Proxy. If everything is fine, save profile and launch the browser.

OxyLabs Residential Proxy VMLogin3

  • You can also use country specific entries. For example, if you put us-pr.oxylabs.io under Proxy IP address and 10001 under Proxy Port, you will receive a US exit node with a sticky session.

OxyLabs Residential Proxy VMLogin4

  • This is all, you are ready to use Residential Proxies with VMLogin.

Undetectable

Firstly, you will need to get Undetectable. To do that, simply go to undetectable.io, sign up, and download the browser.

Then, open the application and click “+” to create a new profile.

OxyLabs Residential Proxy Undetectable1

In the following window, under New Profile, enter the new profile name. Choose the settings (OS, browser, configurations, and screen) of how you want your browser to be recognized by websites.

Also, you can select the main and additional languages, while geo-location will be determined by your proxy.

OxyLabs Residential Proxy Undetectable2

Go to the Proxy tab and select the “New proxy” option in the box.

OxyLabs Residential Proxy Undetectable3

You can choose either SOCKS5 or HTTP (select HTTP proxy as a connection type). Now fill in proxy and authentication details: type pr.oxylabs.io for your Host and use 7777 for Port. Enter your credentials in the Login and Password spaces. Do not forget to add customer- at the beginning of your username. If you have whitelisted your devices, you do not need to provide login credentials.

You can also use country-specific entries. For example, if you put us- pr.oxylabs.io under Host and 10001 under Port, you will receive US exit node with a sticky session. Please check out our complete list of country-secific entry nodes.

Click the Check button. If everything is fine, you should get a response indicating External IP. Press the Save Proxy button to confirm the changes.

OxyLabs Residential Proxy Undetectable4

Now save the profile by pressing the Save button, and you will see it appear on the left side menu. Edit your profiles easily by simply clicking on them.

OxyLabs Residential Proxy Undetectable5

That's it! You have successfully set up your proxies with Undetectable.io.


Puppeteer

Before getting started with Puppeteer, you’ll need to install some basic tools: Node.js and a code editor of your choice. After that, create a Node.js project and install the required packages. You may find a detailed guide on how to install and run Puppeteer on our blog post.

Once everything is set up, we can move on to the next part – Oxylabs Residential Proxies integration with Puppeteer.

  • Within Puppeteer, fill in the value, for example:

pr.oxylabs.io:7777

  • Under ‘page.authenticate’ input your Oxylabs proxy sub-user username in the ‘username’ value and your password.
  • The example of a code looks like this:
const puppeteer = require('puppeteer');
(async () => {
  const browser = await puppeteer.launch({
    headless: false,
    args: ['--proxy-server=pr.oxylabs.io:7777]  
});
  const page = await browser.newPage();
    await page.authenticate({
        username: 'USERNAME',
        password: 'PASSWORD'
    });
    await page.goto('https://ip.oxylabs.io');
    await page.screenshot({path: 'example.png'});
    await browser.close();
})();

You can also use country-specific entries. For example, if you put us-pr.oxylabs.io under ‘host’ and 10001 under ‘port’, you will receive a US exit node with a sticky session. Please check out our documentation for a complete list of country-specific entry nodes.

And that’s it! You’ve successfully integrated Oxylabs Residential proxies with Puppeteer.


References,

https://docs.oxylabs.io/residential/index.html


Disclaimer: This part of the content is mainly from the merchant. If the merchant does not want it to be displayed on my website, please contact us to delete your content.

Last Updated on September 11, 2021


Do you recommend the proxy service?

Click on a trophy to award it!

Average rating 5 / 5. Vote count: 2

No votes so far! Be the first to rate this post.

Leave a Comment

Your email address will not be published. Required fields are marked *

Scroll to Top