Start using Residential Proxies

Learn how to start using Residential Proxies for geo-targeted scraping without blocks.

To start using Residential Proxies, register an account on the Oxylabs dashboard, choose a plan, and create a proxy user.

Make a cURL request

After creating the proxy user, a pop-up window will appear with a cURL example to copy:

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

Replace the USERNAME and PASSWORD with the proxy user credentials you’ve just created. Paste the code into your terminal (or any other setup you're using), and run the command — the response is a Residential IP address.

See this video guide for a quick overview:

Check our documentation for extensive information about setup, including location parameters, entry nodes, response codes, and more.

Location and session parameters

For location settings, such as connecting to a specific country and city, refer to the pages below.

All of these geo-targeting options are free of charge:

• Continent

• Country

• City

• State

• ZIP/Postal code

• Coordinate

• ASN Targeting

If you want to extend your session time with a particular IP address, refer to the Session Control page.

Advanced parameters

Residential Proxies now also support advanced filtering parameters:

• IP version selection – allows selecting one specific IP version, either IPv4 or IPv6.

• Platform / OS filtering – allows filtering proxies by operating system, including Windows, macOS, Android, iOS, and Linux.

Advanced filtering is intended to create more consistent and realistic traffic patterns, reduce fingerprint mismatches, and improve success rates on heavily protected websites. Minimizing technical discrepancies helps ensure you don’t run into issues that could otherwise lead to blocks.

Note: Enabling advanced filtering may require a short KYC verification process.

Integration guides

If you’re planning to use a proxy manager or other third-party applications, refer to integrations page, where you’ll find step-by-step guides on how to configure Residential Proxies with the most popular applications.

Endpoint generator

With the Endpoint generator, you can easily create and retrieve a list of endpoints by choosing the parameters you need.

Refer to the instructions highlighted on the Endpoint generator documentation page.

---

Head back to the dashboard