All Collections
Getting Started
How to start using Residential Proxies
How to start using Residential Proxies
Josh avatar
Written by Josh
Updated over a week ago

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:

  • 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.

Integration guides

If you’re planning to use a proxy manager or other third-party applications, refer to this 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.


🙌 Need assistance? Contact support via live chat or send a message to [email protected].

🤑 Want a custom solution or a free trial? Contact sales by booking a call. For any questions, such as custom pricing, advice, or a free trial, drop us a line at [email protected].

Did this answer your question?