Getting Started

Make a request to https://ip.oxylabs.io/location using a residential proxy from a random location through our backconnect entry. Replace USERNAME and PASSWORD with your proxy user credentials. Keep in mind that each request returns a new IP address as Oxylabs Residential Proxies rotate automatically.

Use ip.oxylabs.io/location to check the parameters of your IPs—this domain delivers information from four geolocation databases: MaxMind, IP2Location, DB-IP, and IPinfo.io. The parameters include IP address, provider, country, city, ZIP code, ASN, organization name, and time zone.

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

Our Residential Proxies support HTTP, HTTPS, and SOCKS5 protocols. You can learn more about using them here.

Now 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://ip.oxylabs.io/location

Here is another example of a request that goes through a proxy from London, United Kingdom. Adding cc-GB-city-london to the username string enables you to specify a city. 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://ip.oxylabs.io

If you need to keep the same proxy for more than one request, use a session control. 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), you will get the same proxy IP. Learn more here.

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

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

You can also set up Residential Proxies using the Endpoint generator.

Login to the dashboard, select Residential Proxies, and click on the Endpoint generator. Choose the parameters and get a list of endpoints to integrate our proxies with tools of your choice.

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

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