Oxylabs offers 100M+ residential proxies from all around the world. Our premium proxy pool is constantly growing and is able to deal with even the most demanding web scraping tasks. Perfect for collecting data from complex targets, it will help you achieve scraping free of CAPTCHAs or blocks.
Curious to learn all about our residential proxies? You’re in the right place. This quick start guide will provide all the information you need to get up and running. Let’s get started!
- What you will get with Oxylabs® Residential Proxies
- Technical features
- Purchase and subscription information
- Pricing plans
- Self-service top-up feature
- Contacting sales
- Managing your subscription
- Using residential proxies
- The single backconnect entry and parameters
- Other connection modes
- Forming a query with country and city parameters
- Session control
- Response codes
- Oxylabs® dashboard for Residential Proxies
- Users (user creation guide)
What you will get with Oxylabs® Residential Proxies
Market-leading proxy pool – we are always expanding our proxy pool to offer the best-in-class scraping experience.
Global coverage – from Jacksonville, Florida to Sydney, Australia, enjoy the widest possible range of locations.
Exceptional performance – our engineers are hard at work so you could enjoy low response times and a consistently high success rate of up to 99.2%
Some of the fastest proxies – our residential proxies regularly score as the fastest on the market. But don’t take our word for it.
24/7 live support – get help from our proxy experts whenever you need it. Talk via live chat or email (firstname.lastname@example.org ).
Universal location support – our residential proxies support all possible worldwide city-level locations. Simply specify the city via the city parameter (and add the country via the cc parameter) and you’re good to go. We also support US state and ASN-level targeting.
Sticky IP / sticky session support – the proxies also support sticky sessions of up to 10 minutes by default. You can get even longer sessions of up to 30 minutes (please contact support for this feature). See how to configure sticky sessions in the “Using residential proxies” section of this article.
Unlimited concurrent sessions – we do not limit the amount of concurrent connections so you could scale your operation to any size needed.
Dashboard – see your usage statistics, create and manage sub-users or whitelist IPs – do it all easily and in one place.
IP whitelisting – aside from the standard user:password authentication, you can also easily whitelist IPs.
Public API – use our API to integrate your residential proxies to any existing infrastructure via the Open API protocol. See the documentation for our Public API here.
Purchase and subscription information
Here you will find all the information in regards to purchasing any of our residential proxy plans and managing your subscription afterwards.
There are four pricing plans:
- Starter (20GB included)
- Business (50GB)
- Corporate (100GB)
- Enterprise (1TB)
Our pricing is based on how much traffic you need on a monthly basis. Aside from this difference, all of the plans support the same awesome features.
Please note that the included data does not roll over to the next month and each plan has a minimum monthly commitment. You can find the details for each plan here.
Our self-service (Fast Checkout) feature is available for two of our residential proxy plans – Starter and Business. These options become available after registering an account.
You will be able to fully use our services after passing the KYC verification process and creating your first user (see the “User creation guide”). For a detailed breakdown on how to use our self-service, check out the video below.
Self-service top-up feature
Our self-service users can easily top-up their traffic via dashboard.
Once you use up 50% of your Residential Proxy traffic, an option to add more traffic will show up. Simply click on “add more traffic”, choose how much traffic you would like to add, and continue using our proxies.
If you have purchased a Starter plan, you can add 5, 10, or 20GB of traffic. Business plan subscribers can top-up their traffic with 5, 10, 20, or 50GB.
If you would like to add more traffic than your initial plan (i.e. you have a Starter plan, but want to add 50GB) you need to contact our support team at email@example.com.
Please keep in mind that additional traffic does not transfer to the next billing period.
Self-service plan change feature
With Residential Proxy Self-Service you can also upgrade your plan if you think the current one is not enough and wish to have more Residential Proxy traffic every month. Or you can downgrade a plan if you think that the current one is a little too big for you. You can find a detailed tutorial on how this works in our blog.
For any larger residential proxy plan please click the “Book a call” button on our homepage. After filling out the inquiry form, one of our sales representatives will contact you with an email, asking for more details about your use case.
Pro tip: the more information you will provide in these initial stages, the smoother and faster the purchasing process will be.
Managing your subscription
After successfully activating your subscription, you can manage it completely on your own via the dashboard. Simply go to My Account -> Billing. Here you will see a quick overview of your active products and will be able to reach your invoices. Now let’s go further to Active Products -> Manage subscription (see screenshot for reference).
After clicking the “Manage subscription” button you will be taken to Cleverbridge, our payment vendor’s site, in which you’ll be able to see even more details including the options to toggle automatic renewal on/off and update your preferred payment option.
Using residential proxies
Our residential IPs originate from internet service providers (ISPs) all around the world. For a convenient and flexible connection method, we recommend using the single backconnect entry. Yet, for maximum flexibility in using our global infrastructure we also offer a variety of other connection modes. Continue reading to learn more.
The single backconnect entry and parameters
To connect via the single backconnect entry, use this proxy IP port:
Using this connection mode you may choose a specific country, US state or city proxy via additional parameters in the username. This approach also supports session control. Below is a sample credentials structure with only the country and city parameters:
See the list of all the supported parameters and how to use them in our documentation here.
Other connection modes
We also offer a variety of other connection methods (gateways) that will allow you to use our residential proxy network with greater flexibility and efficiency:
- The China entry node
- Randomizing entry points: general and country-specific
- The country-specific sticky proxy entry point
You may find detailed information on how to use each one here.
Forming a query with country and city parameters
Let’s take a quick look at how a Shell (cURL) query that uses the cc (country) and city parameters might look like. 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
In our documentation you may also find sample queries for Shell Python, PHP, Java, C# and Ruby languages.
For session control you simply need to add the sessid flag to your query. Here’s how it works:
- Adding sessid means that the IP will not change with the following request
- The system keeps the same IP associated with session ID as long as there is some activity.
- After 60 seconds of inactivity, the IP is automatically changed to a different one.
- If you stop sending requests or the IP address is no longer online, the system will assign a new proxy IP after 60 seconds.
- Standard session time is 10 minutes.
For a practical example, see documentation.
|400 Bad Request||A proxy server can return this error code if the request did not contain a host to connect to or if there was a generic error when parsing the HTTP request. Make sure your request is correctly formed and to include the URL in the request. Then, try again.|
|407 Proxy Authentication Required||Your request lacks proxy authentication information or username / password is invalid. Include the proxy authorization header in your request and make sure your username and password are correctly formed and then try again.|
|500 Internal Server Error||Proxy server has encountered an internal error. Please retry the request at a later time.|
|502 Bad Gateway||Proxy server received an invalid response from the upstream server. Please retry the 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 1 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.|
|504 Gateway Timeout||Proxy server did not receive a response from the upstream server in time. Retry request.|
|525 No Exit Found||Custom HTTP status code – this means proxy was unable to find an exit node which satisfies the request. Change request filter parameters or try again later.|
For your convenience we also documented some integrations with third-party software:
Oxylabs® dashboard for Residential Proxies
Oxylabs dashboard is the place to find everything you need to manage your Oxylabs services. In the case of residential proxies, this is where you’ll find these essential tools: usage statistics, user management and IP whitelisting. Continue reading to find out more about each one.
The “Statistics” section allows you to see detailed information on how much traffic you use day-to-day. You can see usage graphs for any selected period and also filter by users or export this data to a .csv file.
Users (user creation guide)
Under the “users” section you may create and manage users (sub-users). We offer features that allow you to set traffic limits (either monthly or lifetime). And you can also disable a user after it reaches its lifetime limit. Let’s have a quick walkthrough on how to create a new user.
First, click on the “New user” button in the top right corner.
Then, give your user a name and a password. If you wish to set a traffic limit, first tick the checkbox and then choose the limit and the time period.
You may disable users any time after their creation and also modify the limits by clicking the “Edit” button.
Aside from the usual user:password authentication, we also offer IP whitelisting which allows you to access our residential proxy infrastructure simply by connecting via whitelisted IPs.
You may whitelist up to 10 IPs by default. Add or remove them as a simple text list via the “Edit whitelist” interface (see screenshot below).
Are there any restricted targets?
Yes. To prevent abuse some websites are restricted on our residential proxy network. The list includes, but is not limited to websites such as Google domains including Play.google.com, Linkedin.com, Sonyentertainmentnetwork.com, all Apple domains, including iTunes, Discord.com, Twitch.tv, Neflix.com and some other sites.
What should I do when I reach my traffic limit?
For now, please contact support via live chat. In the near future we will implement a solution that will make it possible to conveniently purchase data top-ups via the dashboard.
Is my unused data automatically transferred to the next month?
No. Monthly data is only valid for that month.
We hope the guide answered all the questions you might have had and you can now see that the powerful infrastructure we offer is actually a breeze to use. Yet, we realize that it is nearly impossible to cover all aspects and varying use cases, so if there’s still something you’d like to learn – feel free to contact our support team at any time via email (firstname.lastname@example.org) or the live chat.