Requests with Whitelisted IPs
Last updated
Last updated
With Whitelisted IPs, you can access Oxylabs Residential Proxies without needing to provide a username
and password
. By whitelisting your IP address, you can specify all your proxy parameters directly in the subdomain.
If you add an IP to the whitelist, you should connect using either the whitelisted IP or credentials, but not both, as doing so can lead to unexpected behavior.
Here's an example code targeting New York City with a given session ID:
Query parameters
Parameter | Description |
---|---|
cc
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. You can find more details on how to use country-specific proxies here.
city
Case insensitive city name in English. This parameter must be 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
. Click here for more information on city-level targeting.
st
Case insensitive US state name with us_ in the beginning, for example, us_california
, us_illinois
. Click here for more information on state-level targeting.
cn
To get a proxy from any of the seven continents, add the cn-
parameter and two-letter code to the authorization string. Click here for more information on continent-level targeting
postalcode
To connect to a proxy using a ZIP code, add and specify the postalcode
parameter with a five-digit ZIP code. This parameter must be used combined with the country code parameter cc
and a case-insensitive country code in 2-letter 3166-1 alpha-2 format.
Learn more here.
ASN
You can choose proxies from specific carriers. You have to enter the required ASN number in your request. Learn more here.
sessid
Session ID to keep the same IP with upcoming queries. The session expires in 10 minutes. After that, a new IP address is assigned to that session ID. Random string, 0-9, and A-Z characters are supported.
sesstime
The session time parameter keeps the same IP for a certain period. The maximum session time is 30 minutes.