Oxylabs Documentation

Getting Started

The easiest way to set up Residential Proxies is to use 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 set up your endpoints manually, follow the instructions below.
Make a request to https://ipinfo.io 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.
curl -x pr.oxylabs.io:7777 -U "customer-USERNAME:PASSWORD" https://ipinfo.io
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://ipinfo.io
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://ipinfo.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://ipinfo.io
Check out our integration tutorials with the most popular 3rd party tools, such as Multilogin, ShadowRocket, or SwitchyOmega.
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].